HP StorageWorks P9000 Tiered Storage Manager Software 7.1 CLI Reference Guide (TB585-96011, May 2011)

Commands for creating tasks
This section explains the CLI commands for creating tasks.
CreateMigrationPlan
It is too time-consuming to create pairs of migration source LDEVs and migration target LDEVs
individually. You can use the CreateMigrationPlan command to make Tiered Storage Manager
software automatically select all the appropriate LDEVs for migration source LDEVs. The combination
of migration source and target LDEVs is output to the standard output as text data, or output to the
redirect file specified for the --output option. The text file created by using the
CreateMigrationPlan command is called a candidate migration plan.
The storage tier chosen as the migration target decides, among all the volumes in the migration group,
which volumes can be a candidate for the migration target. When you use the filtercondition
parameter to specify a volume filter condition, candidates for the migration target volume are chosen
based on that condition.
Volumes that are candidates for the migration target are chosen from the SLPR to which the migration
source volume belongs. Volumes that are candidates for the migration target are displayed in pairs
in the candidate migration plan with the applicable migration source volume.
There are comment lines (lines that begin with #) in the candidate migration plan. If multiple migration
target volume candidates exist, they are all shown within comment lines as well. Note that all volumes,
other than the first candidate, are chosen not only from the SLPR to which the migration source volume
belongs, but also from the other SLPRs.
Even if you cannot select candidates for the migration target volume for all the migration source
volumes, the candidate migration plans with selected migration targets will be created. However, in
such a case, an error will occur.
If the migration group contains non-migratable volumes, only the volumes that are migratable will be
migrated. Note that, if there are no migratable volumes, an error will occur when you attempt to
create the migration plan.
For non-migratable volumes, the source volume will select itself as the target volume in the candidate
migration plan.
This command does not reserve volume migration for migration source and target volumes.
Volumes specified for tasks that have not ended (whose status is not End) cannot be selected as
migration target volumes, because volume migration has been reserved for such volumes. You can
use the GetTasks command to check the status of tasks.
You cannot create candidate migration plans for the storage domains whose refresh status is either
Processing, Failure, or RefreshRequired.
For details on candidate migration plans that contain comments, see “Output items” on page 105.
Editing a created candidate migration plan
You can use a created candidate migration plan in its current state for migration, or you can change
the contents by editing the text data. The format of a candidate migration plan is as follows:
• Each item consists of an item name, equal sign (=), and value, in that order. Note that only the
item name is specified for pair.
• Any space characters before or after the item name, equal sign (=), and value are ignored.
• Specify only one item per line. The specification for an item cannot continue over multiple lines.
Details of CLI commands102