HP 3PAR Online Import for EMC Storage Data Migration Guide 1.2.0 Abstract This guide provides information on using HP 3PAR Online Import for EMC Storage software to migrate data from an EMC Storage system to an HP 3PAR StoreServ Storage system.
© Copyright 2014, 2015 Hewlett-Packard Development Company, L.P. Confidential computer software. Valid license from HP required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendor's standard commercial license. The information contained herein is subject to change without notice.
Contents 1 Overview of HP 3PAR Online Import for EMC Storage....................................7 Types of Data Migration............................................................................................................7 Understanding Which Data is Migrated......................................................................................7 EMC to HP 3PAR Migration Process............................................................................................
Viewing Migrations for a Selected Source Storage System..................................................45 Viewing a Selected Migration.........................................................................................45 Viewing Selected Migration Progress by Volume................................................................45 Online Data Migration with Native device-mapper Multipath.......................................................45 Viewing Migration Status.................................
Preparing Host for Migration....................................................................................................66 Preparing Windows Clusters for Migration............................................................................66 Zoning the Host to the Destination HP 3PAR StoreServ Storage System...........................................66 Shutting Down the Host...........................................................................................................
HP 3PAR Online Import Utility startmigration error for Host name greater than 31 characters or with spaces.......................................................................................................................96 Error Logging into the HP 3PAR Online Import Utility CLI.........................................................96 HP 3PAR Online Import Utility createmigration Results in “ERROR: OIUERRAPP0000 An unexpected error occurred.” or “OIURSLAPP0000 Contact HP support.
1 Overview of HP 3PAR Online Import for EMC Storage HP 3PAR Online Import for EMC Storage manages the migration of data from a source EMC Storage system to a destination HP 3PAR StoreServ Storage system. Using HP 3PAR Online Import for EMC Storage, you can migrate EMC volumes and host configuration information to a destination HP 3PAR StoreServ Storage system without changing host configurations or interrupting data access.
The migration process selects objects to migrate using the following rules: • Host—When selecting a single host or group of hosts with volume presentations, all the volumes presented to the host(s) are migrated. In addition, any presentations the source volumes have to other hosts will include those hosts and all of their presented volumes in the migration.
2 Migration Process Checklists Follow the steps in this chapter to perform online migration, MDM, or offline migration. Online Migration Prerequisite Component Installation Table 1 Prerequisite component installation—Online Number Step See 1 Check the HP SPOCK website to confirm proper HP SPOCK (http://www.hp.com/storage/spock) configuration. See also “Configuration Rules for HP 3PAR Online Import for EMC Storage Support” (page 15) 2 Install EMC SMI-S Provider.
Table 2 Premigration checklist—Online (continued) Number If EMC PowerPath is installed, see: Step If EMC PowerPath is not installed, see: NOTE: (A maintenance window is required.) 2. Configure device-mapper on the host: “Online Data Migration with Removal of EMC PowerPath” (page 40), step 6 3.
Minimally Disruptive Migration Prerequisite Component Installation Table 5 Prerequisite component installation—MDM Number Step See 1 Check the HP SPOCK website to confirm proper HP SPOCK (http://www.hp.com/storage/spock) configuration: See also “Configuration Rules for HP 3PAR Online Import for EMC Storage Support” (page 15) 2 Install EMC SMI-S Provider. “Installing EMC SMI-S Provider” (page 15) 3 Install the HP 3PAR Online Import Utility.
Migration Table 7 Migration checklist—MDM Number Step See 1 Start the migration (HP 3PAR Online Import Utility: • For Windows: startmigration command) “Starting the Data Migration from Source EMC Storage System to Destination HP 3PAR StoreServ Storage System” (page 54) • For Linux: “Starting the Data Migration from Source EMC Storage System to Destination HP 3PAR StoreServ Storage System” (page 58) • For Hyper-V: “Starting the Data Migration from Source EMC Storage System to Destination HP 3PAR StoreSer
Table 9 Prerequisite component installation—offline (continued) Number Step See See also “Configuration Rules for HP 3PAR Online Import for EMC Storage Support” (page 15) 2 Install EMC SMI-S Provider “Installing EMC SMI-S Provider” (page 15) 3 Install the HP 3PAR Online Import Utility.
Post-Migration Table 12 Post-migration checklist—offline 14 Number Step 1 Perform the following tasks for offline migration Follow EMC PowerPath documentation instructions. 1. Unzone the source EMC Storage system from the host. 2. Restart the host. 3. Remove the EMC PowerPath multipath software, if present, and configure native multipath software. 4. Export the LUNs to the host on the HP 3PAR StoreServ Storage system. 2 Remove the source storage system (EMC) when all migrations are complete.
3 Installation and Setup for Data Migration This chapter describes requirements for an online import migration. Configuration Rules for HP 3PAR Online Import for EMC Storage Support For detailed information about ensuring that the source EMC Storage system and the destination HP 3PAR StoreServ Storage system are configured properly for data migration, see the HP SPOCK website: HP SPOCK (http://www.hp.
1. Download EMC SMI-S Provider 4.6.1.6 Installer from EMC. An EMC login account is required. To download the program, go to the following website: EMC (https://support.emc.com/downloads/5587_SMI-S-Provider) NOTE: This link will take you outside the Hewlett-Packard website. HP does not control and is not responsible for information outside hp.com. 2. 3. 4. 5. 6. 7. 8. 9. Launch the se76123 installer.
Elements for Addresses IP address or hostname or array id 0 (blank to quit): IP address or hostname or array id 1 (blank to quit): IP address or hostname or array id 2 (blank to quit): Address types corresponding to addresses specified above.
HP Software Depot (https://h20392.www2.hp.com/portal/swdepot/displayProductsList.do?category=3PAR) NOTE: If you have HP 3PAR Online Import Utility 1.1.0 and are upgrading to HP 3PAR Online Import Utility 1.2.0, you must uninstall version 1.1.0 before upgrading to version 1.2.0. See the HP SPOCK website for supported target environments for the HP 3PAR Online Import Utility server: HP SPOCK (http://www.hp.
2. When the Welcome screen appears, click Next.
3. Accept the end user license agreement and click Next. The Custom Setup dialog box appears. 4. To choose the default setup (both the HP 3PAR Online Import Utility server and client installed on this machine), click Next. Otherwise, select the component that you want to omit from this installation. Use this option if you want to install the HP 3PAR Online Import Utility server and client on separate machines, and then click Next to continue. 5.
NOTE: After the certificate installation dialog box is passed, the installer checks whether the default ports are already in use on this machine. If they are, another dialog box will be displayed, prompting you to specify available ports to use for this installation. This is not a common occurrence.
7. Monitor the progress of the installation. When complete, click Next. 8. Tomcat services will begin installation. When complete, click Next. IMPORTANT: The installer does not support doing a close, cancel, or kill action during the Tomcat Installation. If the installation of Tomcat is interrupted, the software installation is not fully cancelled and left in an indeterminate state. Do not click the Cancel button or close the window by clicking the X in the upper-right corner. 9.
10. The HP 3PAR Online Import Utility shortcut will be installed on your desktop. 11. After successful installation, verify that the HP Storage Migration Admins group has been created. 12. Add the Administrator account or another account with administrator privileges as a member of HP Storage Migration Admins group. This is the USERNAME that will be used in starting the HP 3PAR Online Import Utility.
13. To start the utility, double click the HP 3PAR Online Import Utility for EMC Storage desktop icon, and provide local credentials as stated in the note below. NOTE: If the client and server have been installed on the same machine, you can use the keyword LOCALHOST to connect to the local server. Otherwise, use the IP address of the machine where the server is located. NOTE: The server version is shown as 1.1.0.195.112514.
Table 13 Legend for the migration support tables LUN Host Storage Group Item selected by user input on CLI Migrations Supported for VNX, CLARiiON CX4, and VMAX Migrations supported by the HP 3PAR Online Import Utility for VNX, CLARiiON CX4, and VMAX are shown in Table 14 (page 25). Table 14 Migration supported by the HP 3PAR Online Import Utility Supported Configuration Description Single LUN, single host The host is selected on the HP 3PAR Online Import Utility CLI.
Table 14 Migration supported by the HP 3PAR Online Import Utility (continued) Supported Configuration Description Multiple LUNs, single host All LUNs are selected on the HP 3PAR Online Import Utility CLI. Multiple LUNs, single host Not all LUNs are selected on the HP 3PAR Online Import Utility CLI. (All LUNs will be migrated.) Single LUN, multiple hosts The host is selected on the HP 3PAR Online Import Utility CLI. Single LUN, multiple hosts The LUN is selected on the HP 3PAR Online Import Utility CLI.
Table 14 Migration supported by the HP 3PAR Online Import Utility (continued) Supported Configuration Description Single LUN, multiple hosts The host is selected on the HP 3PAR Online Import Utility CLI. Single LUN, multiple hosts The LUN is selected on the HP 3PAR Online Import Utility CLI. Multiple LUNs, multiple hosts The host is selected on the HP 3PAR Online Import Utility CLI. Multiple LUNs, multiple hosts All LUNs are selected on the HP 3PAR Online Import Utility CLI.
Table 14 Migration supported by the HP 3PAR Online Import Utility (continued) Supported Configuration Description Single LUN, multiple hosts The LUN is selected on the HP 3PAR Online Import Utility CLI. Multiple LUNs, multiple hosts The host is selected on the HP 3PAR Online Import Utility CLI. Multiple LUNs, multiple hosts All LUNs are selected on the HP 3PAR Online Import Utility CLI. Multiple LUNs, multiple hosts Not all LUNs are selected on the HP 3PAR Online Import Utility CLI.
Table 15 Migration supported by the HP 3PAR Online Import Utility for VMAX only Unsupported Configuration Description A LUN in multiple storage groups is selected, and the groups are not identical. A LUN in a single storage group is selected, but it is grouped with a shared LUN, and the shared LUN’s storage groups are not identical. A host is selected, but it is grouped with a shared LUN, and the shared LUN’s storage groups are not identical.
4 Preparing for Data Migration Use the information in this chapter to ensure all necessary tasks are performed and considerations are understood before beginning a migration. Data Migration Considerations Before migrating data using 3PAR Online Import for EMC Storage, be aware of the following general considerations, system requirements, and other tasks associated with planning, host configuration, and network and zoning requirements.
System Requirements NOTE: For detailed information about ensuring the source EMC Storage system and the destination HP 3PAR StoreServ Storage system are configured properly for data migration, see the HP SPOCK website: HP SPOCK (http://www.hp.
Table 16 Multipathing software by operating system OS Multipathing Software Windows Server 2012 Windows native MPIO Windows Server 2008 R2 Windows native MPIO Windows Server 2003 HP MPIO1 Linux device-mapper 1 For Windows Server 2003, HP uses a specific DSM: HPMpioDSMFor3Par_Kit_Ver_1_0_23_1 After the migration preparation phase is complete, the host might need to be shut down and reconfigured to use the native multipathing software DSM for MDM.
Figure 1 Data migration zoning Premigration Steps Perform these steps to prepare for migration. Zoning the Source EMC Storage to the Destination HP 3PAR StoreServ Storage System The correct zoning must be present between the source EMC Storage system and destination HP 3PAR StoreServ Storage system at every stage of the migration operation. The following zoning rules apply: • There must be two unique paths between the source and destination storage systems.
A on the EMC, and zone the peer port on node 1 on the HP 3PAR StoreServ Storage system to controller B on the EMC Storage system. 3. Verify that the EMC Storage system can detect both ports on the HP 3PAR StoreServ Storage system. Ensure that the peer port WWNs appear in the discovered port list. • To check peer port connections using VMAX, follow these steps: a. Issue the following command: symaccess -sid list logins b.
NOTE: Any applications and services that may automatically start with a reboot should be disabled until after the migration has started and documentation instructs you to bring your host back online. For Hyper-V running on Windows Server 2008 R2, follow these steps to prepare the host for migration: 1. Stop all applications currently running on the virtual machine. 2. Shut down the virtual machine using Failover Cluster Manager.
Required Information EMC Storage source system: • IP address of the EMC SMI-S Provider that is managing the source EMC Storage system from which the volumes are being migrated. ◦ If the SMI-S server is managing more than one source EMC Storage system, and you want to identify only one of them, you need to know the WWN of the source storage system. • User name and password for EMC SMI-S Provider. • Port to access EMC SMI-S Provider. ◦ Secure port default 5989. ◦ Non-secure port default 5988.
Identifying the Destination Storage System To identify the destination procedure, follow these steps: 1. From the HP 3PAR Online Import Utility, execute the adddestination command. Example 3 adddestination command >adddestination –mgmtip 10.10.10.
◦ One initiator group “parent” is added and associated to the HP 3PAR peer port initiator groups. The naming convention is: OIU__IG ◦ One port group is added, containing the required ports based on the original masking views. The naming convention is: OIU__PG After all of these groups have been created and populated, a migration masking view is added and associated to the migration storage group, initiator group, and port group.
To create the migration for a given migration type using the createmigration command, see: ◦ Online migration, if EMC PowerPath is installed: “Online Data Migration with Removal of EMC PowerPath” (page 40), steps 5–8 Online migration, if EMC PowerPath is not installed: “Online Data Migration with Native device-mapper Multipath” (page 45), step 6 ◦ ◦ MDM – Windows: “Creating the Data Migration Task” (page 51) – Linux: “Creating the Data Migration Task” (page 56) – Hyper-V: “Creating the Data Migrat
5 Performing Online Data Migration Using Linux If EMC PowerPath is installed, it must be uninstalled, and device-mapper must be used to configure multipathing. Follow the online data migration procedure in “Online Data Migration with Removal of EMC PowerPath” (page 40). If EMC PowerPath is not installed, follow the online data migration procedure in “Online Data Migration with Native device-mapper Multipath” (page 45).
a. b. c. d. 6. Close all applications on the host. Unmount the application file systems, bring offline any raw devices (if configured), and deactivate any volume groups where Logical Volume Manager is in use. For a cluster, stop the cluster services, and then stop the cluster. Uninstall EMC PowerPath from the host, following the EMC PowerPath documentation instructions. Configure native device-mapper multipath on the host: a. If multipath is not already installed, install it. b.
IMPORTANT: In Linux, EMC PowerPath devices are presented as /dev/emcpower* (for example, /dev/emcpowera). EMC PowerPath removal in Linux also removes this device type. This changes when the Linux native device-mapper multipath assumes management of these devices. For example, before EMC PowerPath removal, consider combining /dev/sdb and /dev/sdc into /dev/emcpowera. After EMC PowerPath removal, /dev/sdb and /dev/sdc would be represented by /dev/mpathx.
11. HP recommends that you change the HP 3PAR host persona/host OS to the appropriate setting before enabling access to the HP 3PAR array. NOTE: EMC Storage arrays do not implement specific OS settings when registering host initiators on the EMC Storage array. During migration, online import cannot determine the host OS when migrating the hosts to the HP 3PAR StoreServ Storage. All hosts that are being created on the HP 3PAR StoreServ Storage during EMC migration are set by default to host persona 2. 12.
Example 12 Unzoning an RHEL 5.x host from the source array.
Example 14 Removing a path to a storage device in RHEL 5.
Example 16 Using addsource to add a source storage system for online data migration >addsource -type VMAX -mgmtip 10.10.10.10 -user admin -password adminpw -uid xxxxxxxxxxxxxxxx >SUCCESS: Added source storage system. > >showsource NAME GEMENT_SERVER TYPE OPERATIONAL_STATE SYMMETRIX+000194901212 10.10.10.10 3. VMAX Good UNIQUE_ID FIRMWARE xxxxxxxxxxxxxxxx 5876.229.145 MANA Using the HP 3PAR Online Import Utility adddestination command, add the destination HP 3PAR StoreServ Storage system.
Example 18 Updating the multipath.
Volume 00145 Volume_00145 |unknown| 0% Volume 00146 Volume_00146 |unknown| 0% > 9. HP recommends that you change the HP 3PAR host persona/host OS to the appropriate setting before enabling access to the HP 3PAR array. NOTE: EMC Storage arrays do not implement specific OS settings when registering host initiators on the EMC Storage array. During migration, online import cannot determine the host OS when migrating the hosts to the HP 3PAR StoreServ Storage.
Example 21 Unzoning an RHEL 5.x host from the source array.
Example 23 Removing a path to a storage device in RHEL 5.
6 Performing MDM Using a Windows Host The MDM process is used when migrating a Windows host with a source EMC Storage system. The host DSM must be updated to communicate with the destination HP 3PAR StoreServ Storage system, and the host must be shut down briefly. Host I/O is interrupted only during the time it takes to reconfigure the host. Required Information Source storage system: • WWN of the source EMC Storage system from which LUNs are being migrated.
1. From the HP 3PAR Online Import Utility, execute the createmigration command. Example 25 createmigration command >createmigration -sourceuid 50067890C6E059EE -srchost "HPDL585-01" -destcpg "FC_r5" -destprov thin -migtype MDM >SUCCESS: Migration job submitted successfully. Please check status/details using showmigration command. Migration id: 1395864499741 NOTE: Be aware, the createmigration command may take several minutes to complete.
IMPORTANT: If you are uninstalling EMC PowerPath from a Windows host where the host is booting from SAN, you will be prompted to restart before removal is completed. This restart is required and must be completed. After removal, you will be prompted to restart the host in order for the changes to take effect. Do not restart at this point. 2. The removal of EMC PowerPath Multipath software may have also disabled the MPIO installation but not removed it.
NOTE: EMC Storage arrays do not implement specific OS settings when registering host initiators on the EMC Storage array. During migration, online import cannot determine the host OS when migrating the hosts to the HP 3PAR StoreServ Storage. All hosts that are being created on the HP 3PAR StoreServ Storage during EMC migration are set by default to host persona 2. Starting the Data Migration from Source EMC Storage System to Destination HP 3PAR StoreServ Storage System 1.
3. 4. Check the disk status by pointing to diskpart.exe or by opening Disk Manager. All applications and services can now be restarted and the host may resume normal operations (including first restarting the cluster if applicable). Viewing Migration Status Viewing all Migrations To view all migrations, use the showmigration command from the HP 3PAR Online Import Utility.
7 Performing MDM Using a Linux Host The MDM type can be used when migrating a Linux host with a source EMC Storage system. The host must be shut down briefly during MDM. Host I/O is interrupted only during the time that the host is shut down. If you are performing online migration, see “Performing Online Data Migration Using Linux” (page 40). Required Information Source storage system: • WWN of the source EMC Storage system from which LUNs are being migrated.
1. From the HP 3PAR Online Import Utility, execute the createmigration command. Example 32 createmigration command >createmigration -sourceuid 50067890C6E059EE -srchost "HPDL585-01" -destcpg "FC_r5" -destprov thin -migtype MDM >SUCCESS: Migration job submitted successfully. Please check status/details using showmigration command. Migration id: 1395864499741 NOTE: Be aware, the createmigration command may take several minutes to complete.
c. d. 2. 3. Unmount the application file systems, bring offline any raw devices (if configured), and deactivate any volume groups where Logical Volume Manager is in use. Uninstall EMC PowerPath from the host, following the EMC PowerPath documentation instructions. Zone the host to the destination HP 3PAR StoreServ Storage system to establish communication. Using the HP 3PAR Management Console, verify host-to-destination connectivity by confirming host initiator login on the HP 3PAR StoreServ Storage.
Example 36 showmigration command >showmigration -migrationid 1396643904320 MIGRATION_ID TYPE SOURCE_NAME DESTINATION_NAME 1396643904320 MDM CLARiiON+APM00125127014 unpresenting(1%)(-NA-) TIP: START_TIME 3par_7200_DCB_01 END_TIME STATUS(PROGRESS)(MESSAGE) Fri Apr 04 16:38:24 EDT 2014 -NA- The final status on successful completion will indicate “success”. Bringing the Linux Host Back Online To bring the Linux host back online, follow these steps: 1.
Example 40 Linux Host with Multiple LUNs # multipath -v2 Apr 10 14:31:11 | mpatha: ignoring map # multipath -l mpatho (360060160bf902a0078177a31e4b4e311) dm-2 3PARdata,VV size=100G features='0' hwhandler='0' wp=rw `-+- policy='round-robin 0' prio=0 status=active |- 2:0:0:70 sdb 8:16 active undef running `- 2:0:1:70 sde 8:64 active undef running mpathj (360060160bf902a0098bf9953e4b4e311) dm-3 3PARdata,VV size=1.
8 Performing MDM Using a Hyper-V Host The MDM process is used when migrating a Hyper-V host with a source EMC Storage system. The host DSM must be updated to communicate with the destination HP 3PAR StoreServ Storage system, and the host must be shutdown briefly. Host I/O is interrupted only during the time it takes to reconfigure the host. Required Information Source storage system: • WWN of the source EMC Storage system from which LUNs are being migrated.
1. From the HP 3PAR Online Import Utility, execute the createmigration command. Example 41 createmigration command >createmigration -sourceuid 50067890C6E059EE -srchost "HPDL585-01" -destcpg "FC_r5" -destprov thin -migtype MDM >SUCCESS: Migration job submitted successfully. Please check status/details using showmigration command. Migration id: 1395864499741 NOTE: Be aware, the createmigration command may take several minutes to complete.
NOTE: After removal, you will be prompted to restart the host in order for the changes to take effect. Do not restart at this point. 2. 3. 4. 5. The removal of EMC PowerPath Multipath software might have also disabled the MPIO installation, but not removed it. Manually check to see whether MPIO is still loaded, and if it is, fully remove it at this time. Now restart the host.
TIP: The final status on successful completion will indicate “success”. Bringing the Hyper-V Host Back Online To bring the Hyper-V Host back online, follow these steps: 1. Verify that the import has started and confirm that a TASK_ID is available for each volume by issuing the showmigrationdetails command.
Performing Subsequent Migrations The source EMC Storage system and destination HP 3PAR StoreServ Storage system that have been defined using the HP 3PAR Online Import Utility addsource/adddestination commands, can remain defined for subsequent migrations. You only need to run the HP 3PAR Online Import Utility addsource and adddestination commands if a subsequent migration will be using a new source or destination storage system.
9 Performing Offline Data Migration Prerequisite Component Installation 1. 2. 3. 4. Check the HP SPOCK website to confirm proper configuration. See “Configuration Rules for HP 3PAR Online Import for EMC Storage Support” (page 15). Install EMC SMI-S Provider. See “Installing EMC SMI-S Provider” (page 15). Install HP 3PAR Online Import Utility for EMC Storage. See “Installing the HP 3PAR Online Import Utility for EMC Storage” (page 17).
Prerequisites • EMC SMI-S Provider is installed and operational. • The source EMC Storage system must be registered in the EMC SMI-S Provider application. • HP 3PAR Online Import Utility is installed and operational with network access to both the EMC SMI-S Provider server managing the source storage system and the destination HP 3PAR StoreServ Storage system. • Source EMC Storage system and destination HP 3PAR StoreServ Storage system are zoned to each other.
1. From the HP 3PAR Online Import Utility, execute the adddestination command. Example 50 adddestination command >adddestination –mgmtip 10.10.10.10 –user 3paradm –password 2Password >SUCCESS: Added destination storage system 2. Execute the showdestination command to verify the destination storage system information. Example 51 showdestination command >showdestination NAME OPERATIONAL_STATE TYPE PEER_PORTS UNIQUE_ID FIRMWARE 3par_7200_DCB_01 3PAR 2FF70002AC005F91 3.2.
TIP: Make a note of the Migration ID as it will be used in commands to track migration progress. 2. Execute the showmigration command to verify the data migration task preparation has completed successfully. This may take some time. On the successful creation of the task the STATUS column will indicate preparationcomplete(100%). Example 53 showmigration command >showmigration -migrationid 1395864499741 MIGRATION_ID TYPE SOURCE_NAME STATUS(PROGRESS)(MESSAGE) 1395864499741 2014 -NA- 3.
Example 56 showmigration command >showmigration -migrationid 1395864499741 MIGRATION_ID TYPE SOURCE_NAME END_TIME STATUS(PROGRESS)(MESSAGE) 1396643904320 Offline CLARiiON+APM00125127014 unpresenting(1%)(-NA-) TIP: DESTINATION_NAME 3par_7200_DCB_01 START_TIME Fri Apr 04 16:38:24 EDT 2014 -NA- The final status on successful completion will indicate “success”. Performing Post-Migration Tasks Perform the following tasks after successful completion of the offline migration: 1.
10 Removing a Storage System from EMC SMI-S Provider Follow this procedure to remove a system from the list after the migration has completed or if you have added the wrong system for migration. CAUTION: You cannot remove a system or abort the migration during the migration process. You can remove the system only before migration begins or after it has completed. 1. In the SMI-S CLI, execute the ein command.
Example 58 Verifying that the Storage System Has Been Removed (localhost:5988) ? dv . . . Firmware version information: (Remote) CLARiiON Array APM00084700545 (Rack Mounted CX4_120) : 04.30.000.5.526 (Remote) CLARiiON Array APM00140710205 (Rack Mounted VNX5300) : 05.32.000.5.201 (Remote) CLARiiON Array APM00140730621 (Rack Mounted VNX5200) : 05.33.000.5.035 (localhost:5988) ? ein Class: Clar_StorageSystem ++++ Testing EnumerationInstanceNames: Clar_StorageSystem ++++ Instance 0: Clar_StorageSystem.
11 HP 3PAR Online Import Utility for EMC Storage: Commands This chapter provides reference to HP 3PAR Online Import Utility CLI commands that are used during online import. adddestination Adds a destination system. DESCRIPTION The adddestination command adds a destination storage system to the HP 3PAR Online Import Utility that is intended to be migrated. PARAMETERS Parameter Mandatory/Optional Description mgmtip Mandatory IP address of the management station to connect to get details.
addsource DESCRIPTION The addsource command adds a source storage system to the HP 3PAR Online Import Utility that is intended to be migrated. PARAMETERS Parameter Mandatory/Optional Description type Mandatory Storage system family name: VNX CX VMAX After the following “EXAMPLE” table, see the “NOTE” about the type parameter in HELP. name Optional Name of the storage system or serial number or 64 bit hyphenated/non-hyphenated WWN to identify the storage system.
Parameter Mandatory/Optional Description Options are: • true • false EXAMPLE >addsource -type VNX -mgmtip 10.10.10.10 -user admin -password adminpw -uid xxxxxxxxxxxxxxxx >SUCCESS: Added source storage system.
createmigration DESCRIPTION The createmigration command performs preparation phase of a migration. Actual data transfer will not be triggered by this command. This does following for a given set of source volumes while presenting to 3PAR destination storage system. NOTE: Can only create one migration at a time per source EMC Storage system. NOTE: Be aware, the createmigration command may take several minutes to complete.
Parameter Mandatory/Optional Description "testcpg1" -destprov thin -migtype MDM srchost Name of the host for which all source volumes should be considered for migration. This should not be there if srcvolmap or volmapfile is there. For VMAX, use the name of the initiator group on the VMAX that contains the initiator WWN that is being migrated. If nested initiator groups are being used, the parent initiator group (which does not have a direct reference to a WWN) cannot be used.
>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 The help command 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.
PARAMETERS Parameter Mandatory/Optional Description mgmtip Mandatory IP address of the management station to connect to in order to get details. port Optional Port number on which management application accepts a request to connect and provide source storage system details. If not found, the default based on the storage system type will be used. force Optional Use this option to skip displaying the certificate details.
removemigration Removes migration. DESCRIPTION The removemigration command clears completed or abort prepared migrations. Active/Incomplete migrations cannot be removed. PARAMETERS Parameter Mandatory/Optional Description migrationid Mandatory Number that represents a migration in completed/aborted state. EXAMPLES removemigration –migrationid 1122334456 > SUCCESS: The specified migration is successfully removed.
PARAMETERS Parameter Mandatory/Optional Description source Optional Source storage system WWN (World Wide Name). destination Optional In accordance with HP 3PAR Online Import Utility documentation.
listcols Optional Displays the list of column names applicable to that command. firmware Optional Firmware version. management_server Optional The IP address/FQDN of the management server that manages this storage system. operational_state Optional Operational state of the storage system (Good, Failed, Attention). EXAMPLES showdestination NAME TYPE UNIQUE_ID FIRMWARE MANAGEMENT_SERVER OPERATIONAL_STATE PEER_PORTS DMMT3PAR02 3PAR 2FF70002AC003F9C 3.1.3 15.218.169.
comma separated list of column names. listcols Optional Display the list of column names applicable to that command. sourcename Optional Source storage system name. Displays migrations created between this source and destination storage systems connected to it. destinationname Optional Destination storage system name. Displays migrations created between this destination and source storage systems connected to it.
taskid Optional Online/MDM/Offline. Displays all migrations that are of the type specified. sourcevolume Optional Source volume name. Displays information corresponding to this volume. destinationvolume Optional Destination volume name. Displays information corresponding to this volume.
DESCRIPTION The startmigration command starts or restarts a prepared migration to go through data transfer phase of migration. Historic data from source volumes is moved to destination volume over peer port. Once the data transfer is complete, export to the source host will be executed if the data migration type is MDM. At the source storage system, the presentation of the source volume to the source host will be removed. If possible, the source volume will be locked but not deleted.
12 Troubleshooting This section describes problems you may encounter when using EMC Storage-to-HP 3PAR StoreServ Storage online import. NOTE: During the migration process, it is important to remember that the data continues to be served from the source EMC Storage system until the import of each volume is complete. If host errors occur, both the destination HP 3PAR StoreServ Storage system and the source EMC Storage system should be checked for potential problems.
HP 3PAR Online Import Utility Service The HP 3PAR Online Import Utility service must be stopped before getting the logs or changing the logging level and restarted afterward. To do this, go to WindowsComputer→Manage screen, right-click on the Service Name and select stop/start. HP 3PAR Online Import Utility Server Logs and Output When an issue occurs, get all the HP 3PAR Online Import Utility server logs and output to assist with troubleshooting.
EMC SMI-S Provider Server Logs and Output When an issue occurs, get all the EMC SMI-S Provider server logs and output to assist with troubleshooting. Use the following action and commands to get the logs and output.
4. If the SMI-S Provider ECOM login page does not appear, check the following: • Make sure you have the correct IP address for SMI-S Provider server. • Make sure you are using the correct port for the EMC SMI-S Provider server. Log into the EMC SMI-S Provider server and look at the port configuration file which shows which ports are enabled for use and whether they are expecting a secure or unsecure connection. ◦ • Windows: C:\Program Files\EMC\ECIM\ECOM\conf\Port_settings.
TestSmiProvider Login and Command Examples with Output 1. Start SMI-S Provider TestSmiProvider tool. • SMI-S Provider on Windows: Example 61 Output on Windows C:\Program Files\EMC\ECIM\ECOM\bin>TestSmiProvider.exe Connection Type (ssl,no_ssl,native) [no_ssl]: Host [localhost]: Port [5988]: Username [admin]: Password [#adminpw]: adminpw Log output to console [y|n (default y)]: Log output to file [y|n (default y)]: Logfile path [Testsmiprovider.
Example 62 dv command output (localhost:5988) ? dv ++++ Display version information ++++ CIM ObjectManager Name: EMC:10.10.10.10 CIMOM Version: EMC CIM Server Version 2.7.3.2.0.7 SMI-S qualified version: 1.5.0 SMI-S Provider version: V4.6.1.6 SMI-S Provider Location: Proxy SMI-S Provider Server: Windows_NT WinSrv2008-testB 6.1.7601 Service Pack 1 x86_64 VM Guest OS (64bit Libraries) Solutions Enabler version: V7.6-1755 1.
Example 63 eq command output (localhost:5988) ? eq Query Language[DMTF:CQL]: Query []: select Tag,ElementName,Manufacturer,Model from Clar_ArrayChassis ++++ Testing ExecQuery: ++++ Instance 0: ObjectPath : //10.64.0.60/root/emc:Clar_ArrayChassis.
HP 3PAR Online Import Utility for EMC Storage Error Messages OIUERRSRC0020 = "Unsupported EMC storage system version "; OIURSLSRC0020 = "Check support matrix and upgrade EMC."; Problem: Source EMC Storage system version check failed. Solution: Source EMC Storage system must be running at supported version. OIUERRSRC0111 = "Unable to present the volume to the host in EMC array"; OIURSLSRC0111 = "Contact HP Support if the problem persists.
Problem: There could be a problem with communication or access. Solution: Logs will show the exact cause as an exception trace. Configuration (remote IP access, local access) of the ECOM might need to be rectified. OIUERRAPP0011 = "EMC Provider WBEM Connection, Malformed URL."; OIURSLAPP0011 = "Application internal error, see Log file for details. Contact HP Support." Problem: This would indicate a defect in accessing the provider due to incorrect protocol (HTTP, HTTPS allowed), or no protocol at all.
Not able to create migration Possible causes: • Duplicate volumes exist. This may occur if either a virtual volume with same name or with the same WWN exists on the destination storage system. • A host on the destination storage system has a duplicate name. • The destination storage system does not have enough capacity. • EMC SMI-S Provider is running an unsupported software version. • EMC SMI-S Provider user name/password have changed since source storage system was added.
Migrated LUNs with No Host in a Storage Group Failed OIU:createmigration Solution: If migrated LUNs do not have an associated host, the migration type must be offline. OIU:createmigration Error for LUN Name or Host Name Containing Special Characters Solution: The HP 3PAR Online Import Utility does not support special characters in the LUN name or host name and will cause an error on the createmigration command if special characters are present in the names.
HP 3PAR Online Import Utility createmigration Results in “preparationfailed(-NA-)(OIUERRPREP1014: Error creating host on destination)” Problem: Host already exists on destination HP 3PAR StoreServ Storage system with a different WWN. Solution: If the same host but different WWN: On initial migration of a host, all WWNs to be included in storage group (even if not managing any LUNs). This way subsequent migration of any WWN for this host will find a match.
An “unexpected error” message when destprov/destcpg are not specified for all LUNs Problem: ERROR: OIUERRAPP0000 on createmigration using srcvolmap. This is an example of the error: >createmigration -sourceuid 50060160C6E0167A -srcvolmap [{"temp_1", thin, "FC_r6"}] -migtype MDM >ERROR: OIUERRAPP0000 An unexpected error occured. OIURSLAPP0000 Contact HP support. You may try restarting the application service.
Scope: This may be experienced when an adddestination –type 3PAR command is issued with the –secure=true and –port flags included. Solution: If the above error occurs, the HP-3PAR-MC-TrustStore keystore file must be created or modified in the \InformMC\Security folder and copied into the folder as shown in the error message, such as C:\InformMC\Security in the above example.
Example 68 Error message—example 2 Time : 2014-07-24 07:41:32 EDT Severity : Minor Type : CLI command error Message : {3paradm super all {{0 8}} -1 15.234.144.106 27814} {Command: admitvv EMC_1:XXXXXXXXXXXXXXXXXX Error: Volume XXXXXXXXXXXXXXXXXXXX was not admitted--0 VVs admitted.
Restarted Migration Showed Incorrect FAILED Status Problem: If a migration failed and it has been restarted using the HP 3PAR Online Import Utility startmigration command again, the status will immediately change to IMPORTING. However, due to timing issues, the status may change back to FAILED for a short time before returning to IMPORTING.
13 Support and Other Resources Contacting HP For worldwide technical support information, see the HP support website: http://www.hp.
For information about: See: Using the HP 3PAR CLI to configure and administer storage systems HP 3PAR Command Line Interface Administrator’s Manual CLI commands HP 3PAR Command Line Interface Reference Analyzing system performance HP 3PAR System Reporter Software User's Guide Installing and maintaining the Host Explorer agent in order to manage host configuration and connectivity information HP 3PAR Host Explorer User’s Guide Creating applications compliant with the Common Information HP 3PAR CIM
For information about: See: Planning for HP 3PAR storage system setup Hardware specifications, installation considerations, power requirements, networking options, and cabling information for HP 3PAR storage systems HP 3PAR 7200, 7400, and 7450 storage systems HP 3PAR StoreServ 7000 Storage Site Planning Manual HP 3PAR StoreServ 7450 Storage Site Planning Manual HP 3PAR 10000 storage systems HP 3PAR StoreServ 10000 Storage Physical Planning Manual HP 3PAR StoreServ 10000 Storage Third-Party Rack Physic
Typographic conventions Table 17 Document conventions Convention Element Bold text • Keys that you press • Text you typed into a GUI element, such as a text box • GUI elements that you click or select, such as menu items, buttons, and so on Monospace text • File and directory names • System output • Code • Commands, their arguments, and argument values • Code variables • Command variables Bold monospace text • Commands you enter into a command line interface • Syste
14 Documentation feedback HP is committed to providing documentation that meets your needs. To help us improve the documentation, send any errors, suggestions, or comments to Documentation Feedback (docsfeedback@hp.com). Include the document title and part number, version number, or the URL when submitting your feedback.
Glossary For additional information about the HP 3PAR operating system, see the HP 3PAR StoreServ Storage Concepts Guide, available at the following website: HP Storage Library (http://www.hp.com/go/storage/docs) controller EMC Storage term for node or controller node DM Device-mapper DSM device-specific module FCoE Fibre Channel over Ethernet firmware (controller software) EMC Storage term for HP 3PAR Operating System HP SPOCK HP Single Point of Connectivity Knowledge.
Index A aborting a migration, 55, 60, 64 adddestination, 73 HP 3PAR Online Import Utility command, 68 addsource, 74 HP 3PAR Online Import Utility CLI command, 67 B bringing online Hyper-V host, 64 Linux host, 59 Windows host, 54 C client IP filtering, 17 command prompt Windows, 16 configuration HP SPOCK, 9, 11, 12 configuring MPIO software on the host, 53 multipath software, 70 SMI-S Provider on Windows, 16 considerations when migrating data, 30 controller, 32 conventions text symbols, 105 createmigration
EMC Solutions Enabler, 15 Installing HP 3PAR Online Import Utility, 17 online migration, 7, 40 overview, 7 L P license HP 3PAR Peer Motion, 31 HP End User License Agreement, 20 logging level (HP 3PAR Online Import Utility) modifying, 87 logging level (SMI-S Provider) modifying, 88 logs HP 3PAR Online Import Utility, 87 SMI-S Provider, 88 LUNs migrating, 30 scanning, 59 performing data migration, 51, 56, 61 planning data migration, 31 ports controller (on source system), 32 peer, 34 peer (on destination
logs, 88 removing, 71 source HP 3PAR Online Import Utility CLI command, 45, 50, 55, 60, 64 source storage system identifying, 36 starting data migration, 54, 63 startmigration, 84 HP 3PAR Online Import Utility CLI command, 54, 58, 69 stopping HP 3PAR Online Import Utility service, 87 symbols in text, 105 system requirements, 31 T terms, 107 TestSmiProvider tool, 90 text symbols, 105 Troubleshooting, 86 troubleshooting, 94 EMC-to-HP 3PAR StoreServ Storage online import issues, 86 types of data migration, 7