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

B.1.3 registlv Command

NAME

registlv - Registers a physical disk


SYNOPSIS

[Solaris OS/Linux OS]
/opt/FJSVssmgr/sbin/vscmcmd registlv -p virtual-storage-pool-name [-e physical-disk-name] 
-w wwpn1:host-lun1[,wwpn2:host-lun2[,...]] 
 [-k storage-name] [-u logical-volume]
/opt/FJSVssmgr/sbin/vscmcmd registlv -h
[Windows OS]
$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe registlv -p virtual-storage-pool-name
 [-e physical-disk-name] -w wwpn1:host-lun1[,wwpn2:host-lun2[,...]] 
 [-k storage-name] [-u logical-volume]
$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe registlv -h

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


DESCRIPTION

This command registers a physical disk with the specified virtual storage pool.

There are the following three methods for registering physical disks with virtual storage pools:

  1. Automatically generating the name of the physical disk

  2. Specifying an arbitrary name for the physical disk to be registered with the virtual storage pool

  3. Specifying the following information about the physical disk to be registered with the virtual storage pool: The name of the storage device that contains the physical disk, and an arbitrary logical volume number for the physical disk

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


OPTIONS

-p virtual-storage-pool-name

Specify the name of the virtual storage pool where the physical disk is to be registered.

-e physical-disk-name

Specify the name of the physical disk to be registered with the virtual storage pool.

Specify a string consisting of between 1 and 32 alphanumeric characters and underscore characters.

If the -e option is omitted, a name for the physical disk is defined automatically.

The names of physical disks must obey the following rule:

Virtual storage pool name + R + five digit number (Example: Pool001R00001)

-w wwpn1:host-lun1[,wwpn2:host-lun2,...]

Specify the WWPNs and LUNs for the CA ports on the physical disk.

Specify the LUNs using decimal notation.

-k storage-name

Specify the name of the storage device that contains the physical disk.

Specify this option only to register a storage unit excluding Fujitsu’s storage unit.

If the -k option is specified, be sure to specify the -u option as well.

-u logical-volume

Specify the logical volume number for the physical disk to be registered.

Specify the logical volume number using hexadecimal notation.

Specify this option only to register a storage unit excluding Fujitsu’s storage unit.

If the -u option is specified, be sure to specify the -k option as well.

-h

Indicates how to use the command.


EXAMPLES

Automatically generating the name of the physical disk to be registered with the virtual storage pool “POOL”

The route information for the physical disk in this example is as follows: LUN “1” for WWPN “210000e000a80382” and LUN “1” for WWPN “210000e000a80383”.

# /opt/FJSVssmgr/sbin/vscmcmd registlv -p POOL -w 210000e000a80382:1,210000e000a80383:1
PhysicalDiskName POOLR00001
Command terminated normally.

Specifying an arbitrary name (“RDISK001”) for the physical disk to be registered with the virtual storage pool “POOL”

The route information for the physical disk in this example is as follows: LUN “1” for WWPN “210000e000a80382” and LUN “1” for WWPN “210000e000a80383”.

# /opt/FJSVssmgr/sbin/vscmcmd registlv -p POOL -e RDISK001 -w 210000e000a80382:1,210000e000a80383:1
PhysicalDiskName RDISK001
Command terminated normally.

Specifying the following information about the physical disk to be registered with the virtual storage pool: the name of the physical disk (RDISK1), the name of the storage device that contains the physical disk (Storage001), and an arbitrary logical volume number (0x001a) for the physical disk

The route information for the physical disk in this example is as follows: LUN “1” for WWPN “210000e000a80382” and LUN “1” for WWPN “210000e000a80383”

# /opt/FJSVssmgr/sbin/vscmcmd registlv -p POOL -e RDISK001  -w 210000e000a80382:1,210000e000a80383:1 -k Storage001 -u 1a
PhysicalDiskName RDISK001
Command terminated normally.

EXIT STATUS

0: The registration of the physical disk has terminated normally.

1: The registration of the physical disk has terminated abnormally.


SEE ALSO

B.1.15 getvp Command, B.1.4 releaselv Command