Description Mandatory/Optional
Parameter
Storage system family name: Mandatory
type
HDS
Name of the storage system or serial number or 64 bit
Optional name
hyphenated/non-hyphenated WWN to identify the storage system. This is required especially when multiple storage systems are managed under the same IP address.
Serial number of the HDS Storage source array.
Mandatory uid
IP address of the SMI-S provider system that is managing storage system that is being added.
Mandatory mgmtip
User name for HiCommand Suite that is managing storage system that is being added.
Mandatory user
Password for the user of the
HiCommand Suite that is managing the storage system being added.
Mandatory password
Port number on which management application accepts request to connect Optional
port
and provide source storage system details.
Mandatory if secure flag is used to set non-default.
SMI-S port defaults are: secure port: 5989 unsecure port: 5988
This enables or disables secure channel communication between the HP Online Optional
secure
Import Utility and the HiCommand Suite.
Options are: • true
• false
The default setting is-secure true.
EXAMPLE
# addsource -type HDS -mgmtip XX.XX.XX.XX -user admin -password adminpw -uid xxxxx
# SUCCESS: Added source storage system.
NOTE: Issuing the addsource -helpcommand displays the following results: # addsource –help
Command addsource
Syntax
addsource -type <3PAR> [-name|uid <name|UID>] -mgmtip <ip address|FQDN> —user <user name> —password <password> [-port <port number>] [-secure <true|false>]
addsource -help
Description
Add a source storage system that is intended to be migrated. -port : Port number on which management application accepts request to connect & provide source storage system details. If not found default based on storage system type will be used.
-secure : True/False. This enables or disables secure channel communication with source storage system, wherever applicable. Default value will be false or default used by source array communication layer.
-password : Plain text password to be used.
-mgmtip : IP address of the management station to connect to get details.
-uid : 64 bit hyphenated WWN to identify the storage system. This is required especially when there are multiple storage systems managed under same IP address
-name : Friendly name of the storage system.
-user : Username to be used to connect to management application. -type : Storage system family type. Example: 3PAR.
Example
addsource -type 3PAR -name 3PAR1 -mgmtip 10.0.0.3 -user administrator -password exposedpwd -port 2380 -secure true
For the HP 3PAR Online Import Utility, the valid value for the type parameter is HDS.
createmigration
DESCRIPTION
Thecreatemigrationcommand performs preparation phase of a migration. Actual data transfer will not be triggered by this command.
NOTE: Can only create one migration at a time per source HDS Storage system.
NOTE: Thecreatemigration command may take several minutes to complete.
NOTE: The volume(s) or host specified in thecreatemigrationcommand are mapped to a host group on the associated source HDS Storage system. All LUNs and all hosts in the mapped host group will be migrated even if only a subset are entered in thecreatemigrationcommand.
PARAMETERS
Description Mandatory/Optional
Parameter
Serial number of the HDS Storage source array.
Mandatory sourceuid
Map that provides information about the source volumes for migration. A list A combination of commands is
mandatory as specified by user—for srcvolmap or volmapfile
of volume names that identifies the volumes should be provided. example, ifsrchostis used,
destcpganddestprovshould be
used. It can also have mapping of every
source volume to required provisioning or destination CPG.
Ifsrcvolmapis there,srchost should not be there.
srcvolmap[{”source unique name”, desired destination provisioning after Ifsrcvolmaphas CPG and Prov
information, thendestcpgand
destprovneed not be specified. migration (thin/full/dedupe), desired destination CPG name},{...},...] If thesrcvolmaphas mixed Prov
information ("thin" and "full") for some Sample content of volmapfile: volumes, thendestprovis “11:09”,thin,cpg1
mandatory for the rest of the volumes
not specified insrcvolmap. “11:06”,full,cpg2 “11:06”,dedupe,cpg2
Any implicitly defined volumes will get their provisioning type from the value of-destprov, and their CPG from the value of-destcpg.
Provisioning and CPG entries in the srcvolmaporvolmapfile parameters override the default destcpganddestprovparameters. Name of the host for which all source volumes should be considered for srchost
migration. This should not be there if srcvolmaporvolmapfileis there. Provisioning type of the volumes that will be created in destination as a result of migration (thin, full, or dedupe). destprov
Name of CPG where the migrated volumes will be made available. destcpg
Migrates a subset of volumes consistently.
Optional cgvolmap
NOTE: Either theallvolumesicg parameter or thecgvolmapparameter can be present at any given point, but not both.
Migrates all volumes specified in srcvolmapconsistently. Optional
allvolumesincg
NOTE: Either theallvolumesicg parameter or thecgvolmapparameter can be present at any given point, but not both.
Migration type. For the source HDS Storage system, the supported migration type is MDM or offline.
Defaults to offline migtype
UID of the destination storage system. Since only one destination storage Optional
destinationuid
Description Mandatory/Optional
Parameter
system is allowed, this is an optional parameter, as the destination will be autoselected.
Sets the host persona type on the destination storage system. Mandatory for online migration and
MDM persona
For valid values of this option, see “showpersona” (page 101).
EXAMPLES
# createmigration -sourceuid 48748 -srchost "HPDL585-01" -destcpg FC_r5 -destprov thin
-migtype MDM -persona “RHEL_5_6”
# SUCCESS: Migration job submitted successfully. Please check status/details using showmigration command.
Migration id: 1395864499741
# createmigration -sourceuid 48748 -srcvolmap "[{"00:03:01", thin, testcpg},{"00:03:02",
thin, testcpg},{"00:03:03", thin, testcpg}]" -destcpg testcpg -destprov testcpg -cgvolmap{“values":{"cg1":["00:03:01","00:03:02"]}} -persona “RHEL_5_6”
To create migration with mixed provisioning (for example, with a single to be thinLDEV to be thin, but others to be fully provisioned), issue the following command:
# createmigration -sourceuid 48748 -srcvolmap [{"00:1A:34", thin, FC_r5}] -destcpg
FC_r5 -destprov full -migtype MDM -persona “WINDOWS_2008_R2”
# SUCCESS: Migration job submitted successfully. Please check status/details using showmigration command.
Migration id: 1400939745313
help
DESCRIPTION
Global help command for the HP 3PAR CLI.
PARAMETERS
None.
Abstract
Thehelpcommand displays available HP 3PAR CLI commands together with short descriptions.
EXAMPLES
# help
CLI provides following commands
showsource –List the source storage systems that are already added to be treated as source for a migration job. It shows empty table if no source storage systems found.
showmigration -This command displays the list of available migrations removemigration -Removes the migration identified by the Migration ID specified.
showpersona Display all the supported persona for supporting firmware version and os mode
startmigration -Start prepared migration OR restart a prepared migration.
removesource -Removes already added source storage system & clears all related migrations.
addsource -Add a source storage system that is intended to be migrated.