ETERNUS SF Storage Cruiser 14.0 User's Guidefor Virtual Storage Conductor

B.1.17 getvt Command

NAME

getvt - Displays information about a virtual target

SYNOPSIS

[Solaris OS/Linux OS]

/opt/FJSVssmgr/sbin/vscmcmd getvt [-d]
/opt/FJSVssmgr/sbin/vscmcmd getvt -t virtual-target-name [-a [-d]]
/opt/FJSVssmgr/sbin/vscmcmd getvt -h

[Windows OS]

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getvt [-d]
$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getvt -t virtual-target-name [-a [-d]]
$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe getvt -h

($INS_DIR means "Program Directory" specified at the Manager installation.)

DESCRIPTION

This command display information about virtual targets.

Information can be displayed in the following two ways:

1. Displaying a list of virtual targets.

2. Displaying information about the virtual disks that have been allocated to the specified virtual target.

Execute this command as the administrator for the operating system (that is, with “Administrator” or “root” privileges).

OPTIONS

-t virtual-target-name

Specify the name of the virtual target.

-a

This option displays detailed information.

-d

This option displays information in CSV format.

If -t option is not specified, the -a option must be specified.

-h

Indicates how to use the command.

EXAMPLES

Displaying a list of virtual targets.

# /opt/FJSVssmgr/sbin/vscmcmd getvt
VirtualTargetName VTWWPN           SwitchName       VirtualBoxName
VT001             2000000b5d12fd31 switch001(vsce1) VBOX001
VT002             2001000b5d12fd31 switch002(vsce2) VBOX001
VT003             2002000b5d12fd31 switch002(vsce2) VBOX001
Command terminated normally.

Displaying a list of virtual targets in CSV format.

# /opt/FJSVssmgr/sbin/vscmcmd getvt -d
"VirtualTargetName","VTWWPN","SwitchName","VirtualBoxName"
"VT001","2000000b5d12fd31","switch001(vsce1)","VBOX001"
"VT002","2001000b5d12fd31","switch002(vsce2)","VBOX001"
"VT003","2002000b5d12fd31","switch002(vsce2)","VBOX001"
Command terminated normally.

Displaying information about the virtual disks that have been allocated to the specified virtual target (VT001).

# /opt/FJSVssmgr/sbin/vscmcmd getvt -t VT001
VirtualDiskName VLogicalVolume VTHL Capacity(MB) BackUp
VDISK001        0x0000            0         1024 Yes
VDISK002        0x0001            1         2048 No
VDISK003        0x0002            2         4096 No
Command terminated normally.

Displaying detailed information about the virtual disks that have been allocated to the specified virtual target (VT001).

# /opt/FJSVssmgr/sbin/vscmcmd getvt -t VT001 -a
VirtualDiskName Encryption DiskType VLogicalVolume VTHL Capacity(MB) BackUp
VDISK001        Encryption Online   0x0000            0         1024 Yes
VDISK002        Encryption Online   0x0001            1         2048 No
VDISK003        Encryption Online   0x0002            2         4096 No
Command terminated normally.

Displaying detailed information about the virtual disks that have been allocated to the specified virtual target (VT001) in CSV format.

# /opt/FJSVssmgr/sbin/vscmcmd getvt -t VT001 -a -d
"VirtualDiskName","Encryption","DiskType","VLogicalVolume","VTHL","Capacity(MB)","BackUp"
"VDISK001","Encryption","Online","0x0000","0","1024","Yes"
"VDISK002","Encryption","Online","0x0001","1","2048","No"
"VDISK003","Encryption","Online","0x0002","2","4096","No"
Command terminated normally.

Table B.4 Display items for the getvt command and their meanings

Display item	Displayed when the -a option is not specified	Meaning
VirtualTargetName	Yes	The names of the virtual targets
VTWWPN	Yes	The WWPN for each virtual target
SwitchName	Yes	The names of the virtualization switches that have been registered with each virtual target (followed by the host names in parentheses)
VirtualBoxName	Yes	The name of the virtual enclosure where the virtual target has been registered
VirtualDiskName	Yes	The name of the virtual disk that has been registered with the virtual target
Encryption	No	The encryption attribute for each virtual disk (encrypted/unencrypted)
DiskType	No	The disk type for each virtual disk (online/nearline)
VLogicalVolume	Yes	A number that identifies each virtual disk
VTHL	Yes	A number that identifies the host for the virtual disk
Capacity(MB)	Yes	The capacity of the virtual disks
BackUp	Yes	A flag indicating whether the virtual disk holds a backup” Yes: The disk holds a backup No: The disk does not hold a backup

EXIT STATUS

0: Displaying information about the virtual target has terminated normally.

1: Displaying information about the virtual target has terminated abnormally.

SEE ALSO

B.1.7 createvt Command, B.1.8 deletevt Command