Migrating data from IBM Spectrum Virtualize systems

Edit online

You can use an iSCSI attachment to migrate data from any system that supports IBM Spectrum Virtualize software to a FlashSystem 7300 system.

Before you begin

Ensure that each system is running at least IBM® Spectrum Virtualize software version 7.7.0 to support iSCSI migration.
For more information about configuring iSCSI support for Storwize® family systems, see Configuring Storwize family storage systems.
Verify that Ethernet ports are available and supported on each system.
- You can use any available Ethernet port to establish iSCSI connectivity between the system and the backend storage controller.
- To avoid performance bottlenecks, the iSCSI initiator and target systems must use Ethernet ports at the same speed. Do not use a combination of Ethernet links that run at different speeds.
Ensure that you have the appropriate number of Ethernet cables and switches to connect to the Ethernet ports on each system.
Ensure that the Ethernet ports on each system are connected to the appropriate Ethernet switches. For full redundancy and increased throughput, use two or more Ethernet switches. Similarly, numbered Ethernet ports on each node of each system must be connected to the same switch. They must also be configured on the same subnet or VLAN.

Procedure

In the following procedure, some steps are completed on the iSCSI initiator system and some steps are completed on the iSCSI target system.

Configure the cabling and systems

Connect the Ethernet cables from the ports on the FlashSystem 7300 iSCSI initiator system to the appropriate Ethernet switches. Use any available Ethernet port.
Connect the Ethernet cables from the ports on the Storwize family iSCSI target system to the appropriate Ethernet switches. Use any available Ethernet port.
Stop all host I/O operations.
On the Storwize family system, unmap the logical drives that contain the data to be migrated to the system.
Verify that the system is configured as a replication layer. To do so, enter the following command.
```
svcinfo lssystem
```
1. If the system is not configured correctly, enter the following command.
```
svctask chsystem -layer replication
```
Verify that the Storwize family system is configured as a storage layer system. To do so, enter the following command.
```
svcinfo lssystem
```
1. If the Storwize family system is not configured correctly, enter the following command:
```
svctask chsystem -layer storage
```

Establish the iSCSI connection

On the system, enter the following command to configure one or more ports that can be used for iSCSI attachment to a backend storage system.
```
svctask mkip –node nodename -portset 3 -ip ipaddress -prefix prefix -port port_id
```

On the system, issue the following command to collect the iSCSI name information of the iSCSI initiator.

svcinfo lsnode

In the following output example, the iSCSI name for Node 1 is iqn.1986-03.com.ibm:2145.system.node1. The iSCSI name for Node 2 is iqn.1986-03.com.ibm:2145.system.node2.


id name  UPS_serial_number WWNN             status IO_group_id IO_group_name config_node UPS_unique_id hardware iscsi_name                                 iscsi_alias panel_name enclosure_id canister_id enclosure_serial_number site_id site_name
1  node1                   500507680B008614 online 0           io_grp0       yes                       AF7      iqn.1986-03.com.ibm:2145.system.node1      01-1        1           1           G7B8003    
2  node2                   500507680B008514 online 0           io_grp0       no                        AF7      iqn.1986-03.com.ibm:2145.system.node2      01-2        1           2           G7B8003

On the Storwize family system, define a new host by using the iSCSI information that was collected from the iSCSI initiator system.
```
svctask mkhost -iscsiname iscsi_name_list
```
On the Storwize family system, map the logical drives to the newly created host as a logical unit.
You can use the management GUI to select and map several drives at one time. You can also enter the following command to map each individual drive.
```
svctask mkvdiskhostmap -host hostname diskname
```
hostname

Name or ID of the host that you created in step 9.

diskname

Name or ID of the volume that you want to migrate to the system.
On the system, enter the following command to discover the available ports on the iSCSI target system. The source_port_id is the Ethernet port on the iSCSI initiator system through which the discovery is made. The ipv_addr is the IP address of the port on the iSCSI target system.
```
svctask detectiscsistorageportcandidate –srcportid source_port_id -targetip ipv_addr
```
Notes:
- If the ports on the iSCSI target system are configured with IPv6 addresses, specify the -targetip6 parameter.
- If the iSCSI target system requires authentication, specify the -username and -chapsecret parameters on the discovery request.
Display information about the iSCSI ports that were discovered on the iSCSI initiator system. This information includes the unique iSCSI qualified name (IQN) and Internet Protocol (IP) combination.
```
svcinfo lsiscsistorageportcandidate
```
Select one or more port candidates to configure. You can specify up to 64 candidate IDs, each separated by a colon. The candidate_id is the value in the ID column of the output that is displayed by the lsiscsistorageportcandidate command.
```
svctask addiscsistorageport candidate_id
```

Migrate the data

On the system, complete the following steps to manage the logical unit.
1. To create one empty storage pool, enter the following command. The extent_size is the size of the volume that you are migrating from the iSCSI target system.
```
svctask mkmdiskgrp -ext extent_size
```
  The logical unit that is mapped from the Storwize family system appears as an unmanaged-mode MDisk to the system.
2. To list the unmanaged-mode MDisks, enter the following command.
```
svcinfo lsmdisk
```
3. If the new unmanaged-mode MDisk is not listed, perform a fabric-level discovery. Enter the following to command to scan the network for the unmanaged-mode MDisks.
```
svctask detectmdisk
```
4. To convert the unmanaged-mode MDisk to an image mode volume disk, enter the following command.
```
svctask mkvdisk -vtype image -iogrp iogrp_name -mdiskgrp mdiskgrp_name 
-mdisk mdisk_name -mirrorwritepriority redundancy
```
  iogrp_name
  
  Name or ID of the I/O group.
  
  mdiskgrp_name
  
  Name or ID of the storage pool that you created in step 14.a.
  
  mdisk_name
  
  Name or ID of the unmanaged-mode MDisk.
5. To list the hosts that were previously using the data that the MDisk now contains, enter the following command.
```
svcinfo lssasportcandidate
```
6. If the host does not exist on the system, you can create a new iSCSI or Fibre Channel host.
  - To create a new iSCSI host, enter the following command.
```
svctask mkhost -iscsiname host_iqn
```
  - To create a new FC, enter the following command.
```
svctask mkhost -fcwwpn host_wwpn
```
7. Enter the following command to map the new volume to the host. When the image mode volume is mapped, it becomes accessible for I/O operations to the host.
```
svctask mkvdiskhostmap -host hostname diskname
```
  hostname
  
  Name or ID of the host you created in step 14.f.
  
  diskname
  
  Name or ID of the virtual disk you created in step 14.d.
Enter the following command to display information about the storage pools that are visible to the system.
```
svcinfo lsmdiskgrp
```
1. If no storage pools are available on the system to migrate the storage pool that you created in step 14.a, enter the following command to create a new storage pool. The extent_size is the size of the volume that you are migrating from the iSCSI target system.
```
svctask mkmdiskgrp -ext extent_size -name pool_name
```
Migrate the data from the Storwize family system to the storage pool on system. For more information about migrating data to volumes, see Managing volumes.
- To migrate data from the entire volume, enter the following command.
```
svctask migratevdisk -mdiskgrp mdisk_group -vdisk vdisk_id
```
- To migrate data from selected extents, enter the following command.
```
svctask migrateexts -source mdisk_name -exts num_extents -target new_mdisk -threads 4 -vdisk vdisk_id
```
To monitor the progress of the data migration, enter the following command.
```
svcinfo lsmigrate
```

Results

The data on the logical drives from the Storwize family system is migrated to the system.

Host I/O operations are also switched to the system.

What to do next

On the system, enter the following command to display the configured ports on the iSCSI target system.
```
svcinfo lsiscsistorageport
```
Delete the configured iSCSI target ports. Specify the row number from the lsiscsistorageport output to identify the sessions to delete.
```
svctask rmiscsistorageport lsiscsistorageport_row_id
```
Disconnect the Ethernet cables that connect the system and the Storwize family system to the Ethernet switches.