3.15 rcxadm vstorage

Name

[Windows Manager]
Installation_folder\SVROR\Manager\bin\rcxadm vstorage - virtual storage resource operations

[Linux Manager]
/opt/FJSVrcvmr/bin/rcxadm vstorage - virtual storage resource operations

Format

rcxadm vstorage list [-verbose [-extend lock]]
rcxadm vstorage show -name name [-extend lock]
rcxadm vstorage move -name name -to pool [-nowait]
rcxadm vstorage modify -name name [-label label] [-comment comment]

Description

rcxadm vstorage is the command used to perform operations on the virtual storage resources provided by storage management software and VM management software. Virtual storage is a storage resource that can be allocated part of a disk resource by specifying a size.

Virtual storage resources enable you to create disk resources to connect to L-Servers.

Subcommands

list

Displays a list of virtual storage resource information.

The following detailed information is displayed:

Table 3.59 Virtual Storage Resource Information
Item Name	Description
NAME	Virtual storage resource name
LABEL	Virtual storage resource label
COMMENT (*1)	Virtual storage resource comment
TOTAL	Total virtual storage resource size Raw Capacity of the RAID group/Storage Pool of the storage device is displayed for the virtual storage resource of EMC CLARiiON storage or EMC VNX storage. "0.0GB" is displayed for the virtual storage resource of EMC Symmetrix DMX storage or EMC Symmetrix VMAX storage. [OVM for x86 2.2] If the virtual storage resource is a storage repository of OVM for x86 2.2, it is not displayed.
FREE	Virtual storage resource free space "0.0GB" is displayed for the virtual storage resource of EMC Symmetrix DMX storage or EMC Symmetrix VMAX storage. When the allocated size that is created using Thin Provisioning and Automatic Storage Layering exceeds the total size of the virtual storage resources, the excessive size is displayed with a minus sign ("-"). For details on the virtual storage resources that Thin Provisioning and Automatic Storage Layering can be applied to, refer to "10.1.1 Allocating Storage" in the "Design Guide CE". [VMware] The excess size, with a minus sign ("-"), is displayed only when the storage resource is registered in a storage pool that thin provisioning has been applied to. In the following cases, the actual free space is displayed: The storage resource is registered in a storage pool that thin provisioning is not applied to The storage resource is not registered in a storage pool [OVM for x86 2.2] For the displayed value, refer to "C.5.9 Advisory Notes for OVM for x86 2.2 Usage" in the "Setup Guide CE".
USED (*1)	Virtual storage resource used space "0.0GB" is displayed for the virtual storage resource of EMC Symmetrix DMX storage or EMC Symmetrix VMAX storage. For virtual storage resources that Thin Provisioning and Automatic Storage Layering are applied to, the virtually allocated space is displayed. [VMware] Virtually allocated space is displayed only when the storage resource is registered in a storage pool that thin provisioning has been applied to. In the following cases, actual amount of used space is displayed. The storage resource is registered in a storage pool that thin provisioning is not applied to The storage resource is not registered in a storage pool [OVM for x86 2.2] If the virtual storage resource is a storage repository of OVM for x86 2.2, it is not displayed.
STATUS	Virtual storage resource status
ATTRIBUTES (*1)	One of the following is displayed: Thin Displayed when the thin provisioning attribute is applied. Thick Displayed when the thick provisioning attribute is applied. A hyphen ("-") Displayed for a disk resource that uses an iSCSI connection, or a virtual storage resource linked with a disk resource for a virtual L-Server. [VMware] One of the following is displayed: A hyphen ("-") Displayed when the virtual storage resource is not registered in a storage pool. Thin Displayed when the virtual storage resource is registered in a storage pool to which the thin provisioning attribute is applied. Thick Displayed when the virtual storage resource is registered in a storage pool to which the thin provisioning attribute is not applied. If -verbose -extend lock is specified for the option, in addition to the above information, the following information is displayed, separated by commas (","): locked(DR) (2) This is displayed when resources are locked during DR execution. unlocked(DR) (2) This is displayed when resources are not locked.

*1: This is displayed when -verbose is specified for the option.
*2: This is displayed when -verbose -extend lock is specified for the option.

show

Displays the detailed information for a virtual storage resource.

The following detailed information is displayed:

Table 3.60 Detailed Information for Virtual Storage Resources
Item Name	Description
NAME	Virtual storage resource name
LABEL	Virtual storage resource label
COMMENT	Virtual storage resource comment
TOTAL SIZE	Total virtual storage resource size Raw Capacity of the RAID group/Storage Pool of the storage device is displayed for the virtual storage resource of EMC CLARiiON storage or EMC VNX storage. "0.0GB" is displayed for the virtual storage resource of EMC Symmetrix DMX storage or EMC Symmetrix VMAX storage. [OVM for x86 2.2] If the virtual storage resource is a storage repository of OVM for x86 2.2, it is not displayed.
FREE SIZE	Virtual storage resource free space "0.0GB" is displayed for the virtual storage resource of EMC Symmetrix DMX storage or EMC Symmetrix VMAX storag When the allocated size that is created using Thin Provisioning and Automatic Storage Layering exceeds the total size of the virtual storage resources, the excessive size is displayed with a minus sign ("-"). For details on the virtual storage resources that Thin Provisioning and Automatic Storage Layering can be applied to, refer to "10.1.1 Allocating Storage" in the "Design Guide CE". [VMware] The excess size, with a minus sign ("-"), is displayed only when the storage resource is registered in a storage pool that thin provisioning has been applied to. In the following cases, the actual free space is displayed: The storage resource is registered in a storage pool that thin provisioning is not applied to The storage resource is not registered in a storage pool [OVM for x86 2.2] For the displayed value, refer to "C.5.9 Advisory Notes for OVM for x86 2.2 Usage" in the "Setup Guide CE".
USED SIZE	Virtual storage resource used space "0.0GB" is displayed for the virtual storage resource of EMC Symmetrix DMX storage or EMC Symmetrix VMAX storage. For virtual storage resources that Thin Provisioning and Automatic Storage Layering are applied to, the virtually allocated space is displayed. [VMware] Virtually allocated space is displayed only when the storage resource is registered in a storage pool that thin provisioning has been applied to. In the following cases, actual amount of used space is displayed. The storage resource is registered in a storage pool that thin provisioning is not applied to The storage resource is not registered in a storage pool [OVM for x86 2.2] If the virtual storage resource is a storage repository of OVM for x86 2.2, it is not displayed.
STATUS	Virtual storage resource status
ATTRIBUTES	One of the following is displayed: Thin Displayed when the thin provisioning attribute is applied. Thick Displayed when the thick provisioning attribute is applied. A blank space (" ") Displayed for a disk resource that uses an iSCSI connection, or a virtual storage resource linked with a disk resource for a virtual L-Server. [VMware] One of the following is displayed: A blank space (" ") Displayed when the virtual storage resource is not registered in a storage pool. Thin Displayed when the virtual storage resource is registered in a storage pool to which the thin provisioning attribute is applied. Thick Displayed when the virtual storage resource is registered in a storage pool to which the thin provisioning attribute is not applied. If -extend lock is specified for the option, in addition to the above information, the following information is displayed, separated by commas (","): locked(DR) () This is displayed when resources are locked during DR execution. unlocked(DR) () This is displayed when resources are not locked.

* Note: The information is displayed when -extend lock is specified for the option.

move: Moves a virtual storage resource to the specified resource pool.

modify: Changes labels and comments of virtual storage resources.

Options

-name name: In name, specify the name of the target virtual storage resource to perform an operation with.

-to pool

Specify the destination resource pool in pool.

For the resource pool allocated in the resource folder, specify the resource folder name using slashes ("/").

-nowait: Use this option to return directly to the command prompt without waiting for the operation of the virtual storage resource specified in the subcommand to complete its execution.

-label label: In label, specify the new label.

-verbose: Specify when displaying detailed information.

-comment comment: In comment, specify the new comments.

-extend lock: Specify when displaying additional information.

Examples

To display the list of the virtual storage resource information:

>rcxadm vstorage list <RETURN>
NAME                      LABEL    TOTAL        FREE         STATUS
----                      -----    -----        ----         ------
vCenterServer_Storage1    -        100.0GB      80.0GB        normal
vCenterServer_data02      -        100.0GB      40.0GB        normal
vCenterServer_data03      -        100.0GB      40.0GB        normal
vCenterServer_data04      -        100.0GB      20.0GB        normal

To display the details of the virtual storage resource information:

>rcxadm vstorage list -verbose <RETURN>
NAME                    LABEL  COMMENT  TOTAL    FREE    USED    STATUS  ATTRIBUTES
----                    -----  -------  -----    ----    ----    ------  ----------
vCenterServer_Storage1  -      -        100.0GB  80.0GB  20.0GB  normal  Thin
vCenterServer_data02    -      -        100.0GB  40.0GB  60.0GB  normal  Thick
vCenterServer_data03    -      -        100.0GB  40.0GB  60.0GB  normal  Thick
vCenterServer_data04    -      -        100.0GB  20.0GB  80.0GB  normal  Thick

To display the detailed information for a virtual storage resource:

>rcxadm vstorage show -name vCenterServer_Storage1 <RETURN>
Name: vCenterServer_Storage1
Label:
Comment:
Total Size: 100.0GB
Free Size: 80.0 GB
Used Size: 20.0 GB
Status: normal
Attributes: Thin

When checking locked resource information

>rcxadm vstorage list -verbose -extend lock <RETURN>
NAME                   LABEL  COMMENT  TOTAL     FREE   STATUS  ATTRIBUTES
----                   -----  -------  -----     ----   ------  ------------------
P192-168-0-206_R0x0000 -        -           1024.0GB  100.0GB  normal  Thick,locked(DR)
P192-168-0-206_R0x0001 -        -           1024.0GB  100.0GB  normal  Thick,unlocked(DR)

>rcxadm vstorage show -name vCenterServer_Storage1 -extend lock <RETURN>

Name: vCenterServer_Storage1
Label:
Comment:
...
Attributes: Thin,locked(DR)