8.3.9 stgxfwcmdispdev (Device information display command)

NAME

stgxfwcmdispdev - displays the Device information

SYNOPSIS

/opt/FJSVswstf/bin/stgxfwcmdispdev -n Server-Name [-d Device-Name [-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 SynfinityDISK or PRIMECLUSTER Global Disk Services (GDS) 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, cache table size may be unspecified, or the cache table may be too small in the box containing this device.) D : Device deletion error U : Device update error
Device	Solaris server A RAW device name is displayed. Windows server 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. In the case of an SDX object, the name is displayed in the disk class name or mirror volume name g?d?p? format. Disk class name : Disk class name of SDX object Mirror volume name : Mirror volume name of SDX object HP-UX server A RAW device name or a volume group name under LVM is displayed. Linux server When a RAW device has been created, its name is displayed; otherwise, a block device name is displayed. AIX server A RAW device name or a volume group name under LVM is displayed.
Block-Device	Solaris server A block device name is displayed. Windows server The name is displayed in the disk?p? format. disk? : Disk number displayed by disk administrator p? : Logical disk number (*2) HP-UX server A block device name or a volume group name under LVM is displayed. Linux server A block device name is displayed. AIX server A block device name or a volume group name under LVM is displayed.
Mount-Point	Solaris server, HP-UX server, AIX server and Linux server A mount point name is displayed. Windows server 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.

OPTIONS

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

-d Device-Name: 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

The information for a device of a server is displayed:

# /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1 -d /dev/sdl0
S Device    Block-Device Mount-Point File-System Device-Type Size(MB)
  /dev/sdl0 /dev/sdl0    /zzz        ext2        Normal      407     
#

The information for each device of a server is displayed:

# /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1
S Device                        Block-Device                 Mount-Point    File-System Device-Type Size(MB)
  /dev/sdl0                     /dev/sdl0                    /boot          ext2        Normal      141     
  /dev/sdu0                     /dev/sdu0                    ---            ---         Normal      407     
* /dev/sdu1                     /dev/sdu1                    ---            ---         Normal      407     
  /dev/sdu2                     /dev/sdu2                    ---            ---         Normal       28     
D /dev/sfdsk/Class2/rdsk/Vol201 /dev/sfdsk/Class2/dsk/Vol201 /ACMMnt/Vol201 ext3        SDX         304     
  /dev/sfdsk/Class2/rdsk/Vol202 /dev/sfdsk/Class2/dsk/Vol202 /ACMMnt/Vol202 ext3        SDX         400     
U /dev/sfdsk/Class2/rdsk/Vol203 /dev/sfdsk/Class2/dsk/Vol203 /ACMMnt/Vol203 ext3        SDX         512     
  /dev/sfdsk/Class2/rdsk/Vol204 /dev/sfdsk/Class2/dsk/Vol204 /ACMMnt/Vol204 ext3        SDX         608     
#

Device of the server is displayed and device information which uses the same copy area is displayed:

# /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
#

Device information which exists in the same logical group as device of the server is displayed:

# /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, please 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.
This command can be executed only by root users.
Please perform the command in the location specified at the time of product installation.
When processing takes a long time, a period (.) is displayed until it is complete.