migrateexts

You can use the migrateexts command to migrate a number of extents from a given managed disk to another.

Syntax

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

>-- -source --+- source_mdisk_id ---+-- ------------------------>
              '- source_mdisk_name -'

>-- -target --+- target_mdisk_id ---+-- ------------------------>
              '- target_mdisk_name -'

>-- -exts -- number_of_extents -- ------------------------------>

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

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

Parameters

-source source_mdisk_id | source_mdisk_name
Specifies the MDisk on which the extents currently reside.
-target target_mdisk_id | target_mdisk_name
Specifies the MDisk onto which the extents are to be migrated.
-exts number_of_extents
Specifies the number of extents to migrate.
-vdisk vdisk_id | vdisk_name
Specifies the VDisk to which the extents belong.
-threads number_of_threads
Optionally specifies the number of threads to use while migrating these extents. Valid values are 1 to 4.

Description

This command migrates a given number of extents from the source, specified in terms of the virtual disk, and the managed disk that contains some extents used to make up the virtual disk. The target is specified in terms of a managed disk (within the same managed disk group).

If a large number of extents are being migrated, you can specify the number of threads that should be started, between one and four. The progress of these can be checked by issuing the svcinfo lsmigrate command.

The migrateext command will fail if there are insufficient free extents on the target managed disk. To avoid this problem, do not issue new commands that use extents until migrateext is completed.

The command should be used in conjunction with the svcinfo lsfreeextents command.

Possible failures

Examples

An invocation example

svctask migrateexts -vdisk vdisk4 -source mdisk4 -exts
	64 -target mdisk6 -threads 4