migratetoimage

The migratetoimage command migrates data from a VDisk (image mode or managed mode) onto a new image mode VDisk copy. The target disk does not have to be in the same MDisk group as the source disk.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svctask -- -- migratetoimage -- --+--------------+-- ------->
                                      '- -copy-- id -'      

>-- -vdisk --+- source_vdisk_id ---+-- ------------------------->
             '- source_vdisk_name -'      

>--+---------------------------------+-- ----------------------->
   '- -threads -- number_of_threads -'      

>-- -mdisk --+- unmanaged_target_mdisk_id ---+-- --------------->
             '- unmanaged_target_mdisk_name -'      

>-- -mdiskgrp --+- managed_disk_group_id ---+------------------><
                '- managed_disk_group_name -'   

Parameters

-vdisk source_vdisk_id | name
(Required) Specifies the name or ID of the source VDisk to be migrated.
-copy id
(Required if the specified VDisk has more than one copy) Specifies the VDisk copy to migrate from.
-threads  number_of_threads 
(Optional) Specifies the number of threads to use during the migration of extents. You can specify 1 - 4 threads. The default number of threads is 4.
-mdisk unmanaged_target_mdisk_id | name
(Required) Specifies the name of the MDisk to which the data must be migrated. This disk must be unmanaged and large enough to contain the data of the disk that is being migrated.
-mdiskgrp managed_disk_group_id | name
(Required) Specifies the MDisk group into which the MDisk must be placed, after the migration has completed.

Description

The migratetoimage command migrates the data of the user-specified source virtual disk onto the managed disk that is specified as the target. At completion of the command, the VDisk is classified as an image mode disk.

The managed disk that is specified as the target must be in an unmanaged state at the time that the command is run. Running this command results in the inclusion of the MDisk into the user-specified MDisk group.

The migratetoimage command fails if the target or source VDisk is offline. Correct the offline condition before attempting to migrate the VDisk.

The following example specifies that the user wants to migrate the data from vdisk1 onto mdisk5 and that the MDisk must be put into the MDisk group mdgrp2.

An invocation example

svctask migratetoimage -vdisk vdisk1 -mdisk mdisk5 -mdiskgrp mdgrp2

The resulting output

No feedback
Library | Support | Terms of use | Feedback
© Copyright IBM Corporation 2003, 2009. All Rights Reserved.