9.2.8 stgxfwcmdispdev (Device Information Display Command)

NAME

stgxfwcmdispdev - displays the Device information

SYNOPSIS

/opt/FJSVswstf/bin/stgxfwcmdispdev -n serverName [-d deviceName [-sm|-grp]]

DESCRIPTION

This command displays information on a device being managed by AdvancedCopy Manager. The list of devices which use the same copy area as the specified device, the specified device itself, and the devices which exist in the same logical group can be displayed.
It is necessary to execute this command on the Management Server.

The following contents are displayed. Note that "SDX" or "SDX object" in the table are PRIMECLUSTER GD terms.

Title	Description
S	The status of each device is indicated. The following is displayed according to the device status: * : Device not set up (The AdvancedCopy license setting may be undefined, copy table size may be unspecified, or the copy table may be too small in the box containing this device.) D : Device deletion error U : Device update error
Device	For Solaris environments A RAW device name is displayed. For Windows environments A device name managed internally by AdvancedCopy Manager is displayed. The name is displayed in the g?d? and g?d?p? format. g? : Disk array number (0 if the device is not installed in the ETERNUS Disk storage system) d? : Disk number(1) p? : Logical disk number(2) (1)This is a number given uniquely within the ETERNUS Disk storage system. This number differs from the disk number in Disk Management. (2)This is the sequential number of a logical disk on the physical disk. The logical disk indicates the following contents in Disk Management. The number is given by counting up from the left to the right in Disk Management. - In the case of a basic partition, the logical disk is that entire partition. - In the case of an extended partition, the logical disk is a logical drive in that partition. For HP-UX environments A RAW device name or a volume group name under LVM is displayed. For Linux environments When a RAW device has been created, its name is displayed; otherwise, a block device name is displayed. For AIX environments A RAW device name or a volume group name under LVM is displayed.
Block-Device	For Solaris environments A block device name is displayed. For Windows environments The name is displayed in the disk?p? format. disk? : Disk number displayed by disk administrator p? : Logical disk number (*2) For HP-UX environments A block device name or a volume group name under LVM is displayed. For Linux environments A block device name is displayed. For AIX environments A block device name or a volume group name under LVM is displayed.
Mount-Point	For Solaris, HP-UX, AIX, or Linux environments A mount point name is displayed. For Windows environments A drive character is displayed.
File-System	A file system name is displayed.
Device-Type	A device type is displayed. Normal/SDX(slice)/LVM/VxVM/SDX(volume)
Size(MB)	The capacity (in megabytes) allocated to a device is displayed.
RDB-Name	For Windows or Linux environments The Symfoware RDB system name is displayed. For Solaris, HP-UX, or AIX environments "---" is always displayed.
Log-Group-Name	For Windows or Linux environments The Symfoware log group name is displayed. For Solaris, HP-UX, or AIX environments "---" is always displayed.
DB-Space-Name	For Windows or Linux environments The Symfoware database space name is displayed. For Solaris, HP-UX, or AIX environments "---" is always displayed.

OPTIONS

-n serverName: Specify the server name that manages the device whose information is to be displayed.

-d deviceName: Specify the device name whose information is to be displayed.
If this option is omitted, the information for all devices managed by the specified server is displayed.

-sm: With the -d option also specified, this option specifies that a list of the devices using the same copy area as the specified device be displayed.

-grp: The list of the devices which exist in the same logical group as a specified device is displayed by specifying it simultaneously with the -d option. The device type of the specified device can be specified with the -d option only for LVM/VxVM.

EXIT STATUS

=0: Completed successfully
>0: Terminated abnormally

EXAMPLES

Displaying the information for a device of a server "Server1":

# /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1 -d /dev/rdsk/c4t0d10s0
S Device              Block-Device       Mount-Point File-System Device-Type Size(MB)
  /dev/rdsk/c4t0d10s0 /dev/dsk/c4t0d10s0 /zzz        ufs         Normal      1028    
#

Displaying the information for each device of a server "Server1":

# /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1
S Device                     Block-Device              Mount-Point  File-System Device-Type Size(MB)
  /dev/sfdsk/class/rdsk/vol1 /dev/sfdsk/class/dsk/vol1 ---          ---         SDX(Volume)    25000
* /dev/sfdsk/class/rdsk/vol2 /dev/sfdsk/class/dsk/vol2 /work        ufs         SDX(Volume)     1250
U /dev/rdsk/c1t0d0s0         /dev/dsk/c1t0d0s0         /storagedata ufs         Normal          5200
D /dev/rdsk/c1t0d0s1         /dev/dsk/c1t0d0s1         ---          ---         Normal         15400
#

Displaying information of devices which use the same copy area as the device of a server "Server1":

# /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1 -d /dev/vx/rdsk/dg1/vol1 -sm
Device                 Mount-Point
/dev/vx/rdsk/dg1/vol1  /storagedata
/dev/vx/rdsk/dg1/vol2  ---
/dev/vx/rdsk/dg1/vol3  /zzz
#

Displaying information of devices which exist in the same logical group as the device of a server "Server1":

# /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1 -d /dev/vx/rdsk/dg1/vol1 -grp
Device                 Mount-Point
/dev/vx/rdmp/c1t0d0s2  ---
/dev/vx/rdmp/c1t0d1s2  ---
/dev/vx/rdsk/dg1/vol1  /storagedata
/dev/vx/rdsk/dg1/vol2  ---
/dev/vx/rdsk/dg1/vol3  /zzz
/dev/vx/rdsk/dg1/vol4  ---
#

NOTES

The command displays the above details based on information registered in AdvancedCopy Manager. Therefore, when the configuration has been changed and there is a device not registered in a logical group, and it is registered afterwards, the correct information is not displayed. In this case, re-attempt the acquisition of device information about the registration of the device that was not previously registered, and the device which does the "Acquisition/reflection of information on all devices" processing.
The RDB-Name column, Log-Group-Name column, and DB-Space-Name column are displayed under the following conditions:
- The Managed Server's OS is Linux or Windows.
- The Symfoware Server Advanced Backup Controller V10.0 or later is installed in the Managed Server.
- The target device to be displayed exists in the ETERNUS Disk storage system.
- When collecting the device information, the target RDB operating environment is running.
This command can be executed only by root users.
When processing takes a long time, a period (.) is displayed until it is complete.