B.1.9 createvd Command

NAME

createvd - Creating a virtual disk

SYNOPSIS

[Solaris OS/Linux OS]

To create a virtual disk and allocate it to a virtual target

/opt/FJSVssmgr/sbin/vscmcmd createvd -v virtual-disk-name -p virtual-storage-pool-name
-z size{M|G|T}
-t virtual-target-name1[,virtual-target-name2[,...]]
-l virtual-host-lun

or

/opt/FJSVssmgr/sbin/vscmcmd createvd -v virtual-disk-name -p virtual-storage-pool-name
-e physical-disk-name1[,physical-disk-name2[,...]]
[-z size1{M|G|T}[,size2{M|G|T}[,...]]]
-t virtual-target-name1[,virtual-target-name2[,...]]
-l virtual-host-lun

or without initializing VTOC area

/opt/FJSVssmgr/sbin/vscmcmd createvd -v virtual-disk-name -p virtual-storage-pool-name
-e physical-disk-name
-t virtual-target-name1[,virtual-target-name2[,...]]
-l virtual-host-lun
-m noclear

To create a virtual disk without allocating it to a virtual target

/opt/FJSVssmgr/sbin/vscmcmd createvd -v virtual-disk-name -p virtual-storage-pool-name
-z size{M|G|T}

or

/opt/FJSVssmgr/sbin/vscmcmd createvd -v virtual-disk-name -p virtual-storage-pool-name
-e physical-disk-name1[,physical-disk-name2[,...]]
[-z size1{M|G|T}[,size2{M|G|T}[,...]}]

or without initializing VTOC area

/opt/FJSVssmgr/sbin/vscmcmd createvd -v virtual-disk-name -p virtual-storage-pool-name
-e physical-disk-name
-m noclear

/opt/FJSVssmgr/sbin/vscmcmd createvd -h

[Windows OS]

To create a virtual disk and allocate it to a virtual target

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe createvd -v virtual-disk-name
-p virtual-storage-pool-name
-z size{M|G|T}
-t virtual-target-name1[,virtual-target-name2[,...]]
-l virtual-host-lun

or

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe createvd -v virtual-disk-name
-p virtual-storage-pool-name
-e physical-disk-name1[,physical-disk-name2[,...]]
[-z size1{M|G|T}[,size2{M|G|T}[,...]]]
-t virtual-target-name1[,virtual-target-name2[,...]]
-l virtual-host-lun

or without initializing VTOC area

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe createvd -v virtual-disk-name
-p virtual-storage-pool-name
-e physical-disk-name
-t virtual-target-name1[,virtual-target-name2[,...]]
-l virtual-host-lun
-m noclear

To create a virtual disk without allocating it to a virtual target

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe createvd -v virtual-disk-name
-p virtual-storage-pool-name
-z size{M|G|T}
or

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe createvd -v virtual-disk-name
-p virtual-storage-pool-name
-e physical-disk-name1[,physical-disk-name2[,...]]
[-z size1{M|G|T}[,size2{M|G|T}[,...]}]

or without initializing VTOC area

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe createvd -v virtual-disk-name
-p virtual-storage-pool-name
-e physical-disk-name
-m noclear

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe createvd -h

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

DESCRIPTION

This command creates a virtual disk. When virtual disks are created, they can also be allocated to virtual targets.

There are the following four methods for creating virtual disks:

Creating a virtual disk with a specified capacity by automatically selecting the physical disks that will make up the virtual disk from the specified virtual storage pool.
(Specify the -v, -p and -z options)
Creating a virtual disk with a specified capacity by automatically selecting the physical disks that will make up the virtual disk from the specified virtual storage pool, and allocating the virtual disk that has been created to a specified virtual target.
(Specify the -v, -p, -z, -t and -l options)
Creating a virtual disk by specifying the physical disks that will make up the virtual disk.
(Specify the -v, -p, -e and -z options)
Creating a virtual disk by specifying the physical disks that will make up the virtual disk, and allocating the virtual disk that has been created to a specified virtual target.
(Specify the -v, -p, -e, -z, -t and -l options)

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

OPTIONS

-v virtual-disk-name: Specify the name of the virtual disk to be created.

-p virtual-storage-pool-name: Specify the name of the virtual storage pool where the physical disk is registered.

-e physical-disk-name1[,physical-disk-name2[,...]]: Specify the names of the physical disks that will make up the virtual disk.

-z size1{M/G/T}{,size2{ M/G/T}[,...]]}

If the -e option has been specified, specify the capacity and units of the physical disks that will make up the virtual disk.

If the -e option has not been specified, specify the capacity and units of the virtual disk. The physical disks is selected automatically. For physical disks with more free space than the specified size, all of the free space on the physical disk is allocated to the virtual disk.

-t virtual-target-name1[,virtual-target-name[,...]]: Specify the name of the virtual target to which the virtual disk will be allocated.

-l virtual-host-lun

Specify the virtual host LUN for the virtual disk to be allocated to the virtual target, using decimal notation.

This option is valid only when the -t option is also specified.

-m noclear

If this option is specified, the VTOC area will not be initialized when the virtual disk is created.

Specify this option to show data for the virtual disk as well, by specifying a physical disk where data already exists.

-h: Indicates how to use the command.

EXAMPLES

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -z 1024M
Command terminated normally.

Creating a virtual disk (VDISK001) with a specified capacity (1024 MB) by automatically selecting the physical disks that will make up the virtual disk from the specified virtual storage pool (POOL001), and then allocating the virtual disk that has been created to the specified virtual target (VT001). In this example, “1” is specified for the virtual host LUN.

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -z 1024M -t VT001 -l 1
Command terminated normally.

Creating a virtual disk (VDISK001) with a specified capacity (1024 MB) by automatically selecting the physical disks that will make up the virtual disk from the specified virtual storage pool (POOL001), and then allocating the virtual disk that has been created to two virtual targets (VT001 and VT002). In this example, “1” is specified for the virtual host LUN.

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -z 1024M -t VT001,VT002 -l 1
Command terminated normally.

Creating a virtual disk (VDISK001) by freely specifying the physical disk (RDISK001) that will make up the virtual disk and the capacity (1024 MB) of the virtual disk.

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -e RDISK001 -z 1024M
Command terminated normally.

Creating a virtual disk (VDISK001) by freely specifying two physical disks that will make up the virtual disk

In this example, the capacity of RDISK001 is specified as 512 MB and the capacity of RDISK002 is specified as 1024 MB.

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -e RDISK001,RDISK002 -z 512M,1024M
Command terminated normally.

Creating a virtual disk (VDISK001) by freely specifying two physical disks that will make up the virtual disk

In this example, the capacity of RDISK001 is specified as 512 MB and the capacity of RDISK002 is specified as 1024 MB.

The virtual disk that has been created is allocated to two virtual targets (VT001 and VT002). “1” is specified for the virtual host LUN.

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -e RDISK001,RDISK002 -z 512M,1024M -t VT001,VT002 -l 1
Command terminated normally.

Creating a virtual disk (VDISK001) by specifying the physical disk (RDISK001) that will make up the virtual disk. In this example, the VTOC area is not initialized.

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -e RDISK001 -m noclear
Command terminated normally.

Creating a virtual disk (VDISK001) by specifying the physical disk (RDISK001) that will make up the virtual disk.

The virtual disk that has been created is allocated to two virtual targets (VT001 and VT002). “1” is specified for the virtual host LUN.

In this example, the VTOC area is not initialized.

# /opt/FJSVssmgr/sbin/vscmcmd createvd -v VDISK001 -p POOL001 -e RDISK001 -t VT001,VT002 -l 1 -m noclear
Command terminated normally.

EXIT STATUS

0: The creation of the virtual disk has terminated normally.

1: The creation of the virtual disk has terminated abnormally.