12.3.9 stgxfwcmdispdev (Device information display command)

NAME

stgxfwcmdispdev - displays the Device information

SYNOPSIS

<program-directory>\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, HP-UX, AIX 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.
RDB-Name	Windows and Linux server: The Symfoware RDB system name is displayed. Solaris, HP-UX and AIX server: "---" is always displayed.
Log-Group-Name	Windows and Linux server: The Symfoware log group name is displayed. Solaris, HP-UX and AIX server: "---" is always displayed.
DB-Space-Name	Windows and Linux server: The Symfoware database space name is displayed. Solaris, HP-UX and AIX server: "---" is always 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:

C:\>C:\ETERNUS_SF\ACM\bin\stgxfwcmdispdev -n Server1 -d g1d19p1
S Device  Block-Device  Mount-Point File-System Device-Type Size(MB) RDB-Name Log-Group-Name DB-Space-Name
  g1d19p1 disk19p1      J:          NTFS        Normal      2000     ---      ---            ---
C:\>

The information for each device of a server is displayed:

C:\>C:\ETERNUS_SF\ACM\bin\stgxfwcmdispdev -n Server1
S Device  Block-Device Mount-Point File-System Device-Type Size(MB) RDB-Name Log-Group-Name DB-Space-Name
  g1d19p1 disk19p1     J:          NTFS        Normal      2000     ---      ---            ---
* g1d19p2 disk19p2     M:          NTFS        Normal      2000     ---      ---            ---
D g1d20p1 disk20p1     K:          NTFS        Normal      2000     ---      ---            ---
U g1d20p2 disk20p2     N:          NTFS        Normal      2000     ---      ---            ---
C:\>

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

C:\>C:\ETERNUS_SF\ACM\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
C:\>

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

C:\>C:\ETERNUS_SF\ACM\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   ---
C:\>

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.
"RDB-Name", "Log-Group-Name" and "DB-Space-Name" 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 a local account belonging to the Administrator's group or by a domain account belonging to the Domain Admins group of the domain.
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.