migratevdisk

The migratevdisk command enables you to migrate an entire virtual disk from one managed disk group to another managed disk group.

Syntax

Read syntax diagramSkip visual syntax diagram
>>- svctask -- -- migratevdisk -- ------------------------------>

>-- -mdiskgrp --+- mdisk_group_id ---+-- ----------------------->
                '- mdisk_group_name -'      

>--+---------------------------------+-- --+--------------+----->
   '- -threads -- number_of_threads -'     '- -copy-- id -'   

>-- -- -vdisk --+- vdisk_id ---+-------------------------------><
                '- vdisk_name -'   

Parameters

-mdiskgrp mdisk_group_id | mdisk_group_name
(Required) Specifies the new managed disk group ID or name.
-threads number_of_threads
(Optional) Specifies the number of threads to use during the migration of these extents. You can specify 1 - 4 threads. The default number of threads is 4.
-copy id
(Required if the specified VDisk has more than one copy) Specifies the VDisk copy to migrate.
-vdisk vdisk_id | vdisk_name
(Required) Specifies the virtual disk ID or name to migrate in to a new managed disk group.

Description

The migratevdisk command migrates the specified virtual disk into a new managed disk group; all the extents that make up the virtual disk are migrated onto free extents in the new managed disk group.

You can issue the svcinfo lsmigrate command to view the progress of the migration.

The process can be prioritized by specifying the number of threads to use during the migration. Using only one thread puts the least background load on the system.

The migratevdisk command fails if there are insufficient free extents on the targeted managed disk group for the duration of the command. To avoid this problem, do not issue new commands that use extents until the VDisk migration is completed.

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

An invocation example

svctask migratevdisk -vdisk 4 -mdiskgrp Group0 -threads 2

The resulting output

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