migratevdisk

You can use the migratevdisk command 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 -'

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

Parameters

-mdiskgrp mdisk_group_id | mdisk_group_name
Specifies the new managed disk group ID or name.
-threads number_of_threads
Optionally specifies the number of threads to use while migrating these extents. You can specify 1 - 4 threads. The default of the number of threads is 1.
-vdisk vdisk_id | vdisk_name
Specifies the virtual disk ID or name to migrate in to a new managed disk group.

Description

This command migrates the specified virtual disk into a new managed disk group. That is, all the extents that make up the virtual disk are migrated onto free extents in the new managed disk group.

The command returns a success message while the transfer completes in the background. The command returns with the in_progress return code. The progress of the migration can be found by issuing the svcinfo lsmigrate command, which list the migrations in progress.

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

The migratevdisk command will fail 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 migratevdisk is completed.

Possible failures

Examples

An invocation example

svctask migratevdisk -vdisk 4 -mdiskgrp Group0 -threads 2