B.2.4 startmig Command

NAME

startmig - Starts migration

SYNOPSIS

[Solaris OS/Linux OS]

/opt/FJSVssmgr/sbin/vscmcmd startmig -v virtual-disk-name -p virtual-storage-pool-name
 [ -z size1{M|G|T} ] [-b]
/opt/FJSVssmgr/sbin/vscmcmd startmig -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}[,...]] ] [-b] [-f]

/opt/FJSVssmgr/sbin/vscmcmd startmig -h

[Windows OS]

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe startmig -v virtual-disk-name
-p virtual-storage-pool-name
[ -z size1{M|G|T} ] [-b]

$INS_DIR\Manager\opt\FJSVssmgr\sbin\vscmcmd.exe startmig -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}[,...]] ] [-b] [-f]

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

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

DESCRIPTION

This command starts a migration and returns a session ID.

Specify this session ID for all subsequent operations on this migration.

There are the following four methods for starting migrations:

Start the migration by automatically selecting the physical disks that will be the migration destination.
Start the migration with a backup, by automatically selecting the physical disks that will be the migration destination.
Start the migration by freely specifying which physical disks will be the migration destination.
Start the migration with a backup, by freely specifying which physical disks will be the migration destination.

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 for the migration source.

-p virtual-storage-pool-name: Specify the name of the virtual storage pool where the migration destination physical disks are registered.

-e physical-disk-name1[,physical-disk-name2[,...]

Specify the name of the physical disk for the migration destination.

If this option is omitted, physical disks are automatically selected from the virtual storage pool specified with the -p option.

-z size1{M|G|T}[,size2{M|G|T}[,...]: Specify the size of the physical disks for the migration destination using decimal notation, including the units (“M” for megabytes, “G” for gigabytes and “T” for terabytes).

-b

Specify this option to start the migration with a backup.

If this option is not specified, the migration is started without a backup.

-f: This option allows copies from encrypted sources to unencrypted destinations.

-h: Indicates how to use the command.

EXAMPLES

Performing a migration from a migration source virtual disk called “VDISK001” by automatically selecting the migration destination from the physical disks registered in a virtual storage pool called “POOL”.

# /opt/FJSVssmgr/sbin/vscmcmd startmig -v VDISK001 -p POOL
SessionID 10020028
Command terminated normally.

Performing a migration (with a backup) from a migration source virtual disk called “VDISK001” by automatically selecting the migration destination from the physical disks registered in a virtual storage pool called “POOL”.

# /opt/FJSVssmgr/sbin/vscmcmd startmig -v VDISK001 -p POOL -b
SessionID 10020028
Command terminated normally.

Performing a migration (with a backup) from a migration source virtual disk called “VDISK001” by freely specifying a physical disk (POOLR00001) registered in a virtual storage pool called “POOL” as the migration destination.

# /opt/FJSVssmgr/sbin/vscmcmd startmig -v VDISK001 -p POOL -e POOLR00001 -z 100M -b
SessionID 10020028
Command terminated normally.

EXIT STATUS

0: Starting the migration has terminated normally.

1: Starting the migration has terminated abnormally.