Chapter 4. Migrating virtual machines by using the Red Hat OpenShift web console

Procedure

1. In the Red Hat OpenShift web console, click Migration NetworkMaps for virtualization.
2. Click Create NetworkMap.

3. Complete the following fields:

   • Name: Enter a name to display in the network mappings list.
   • Source provider: Select a source provider.

   • Target provider: Select a target provider.

     The Source networks and Target namespaces/networks text boxes become active.

4. Select a source network and a target namespace/network from the list.
5. Optional: Click Add to create additional network mappings or to map multiple source networks to a single target network.
6. If you create an additional network mapping, select the network attachment definition as the target network.

7. Click Create.

   The network mapping is displayed on the NetworkMaps screen.

Procedure

1. In the Red Hat OpenShift web console, click Migration StorageMaps for virtualization.
2. Click Create StorageMap.

3. Specify the following fields:

   • Name: Enter a name to display in the storage mappings list.
   • Source provider: Select a source provider.
   • Target provider: Select a target provider.

4. Map source disk storages to target storage classes as follows:

   1. If your source provider is VMware, select a Source datastore and a Target storage class.
   2. If your source provider is Red Hat Virtualization, select a Source storage domain and a Target storage class.
   3. If your source provider is OpenStack, select a Source volume type and a Target storage class.
5. Optional: Click Add to create additional storage mappings or to map multiple source disk storages to a single target storage class.

6. Click Create.

   The mapping is displayed on the StorageMaps page.

Procedure

1. In the Red Hat OpenShift web console, click Migration Plans for virtualization.
2. Click Create plan.

3. Specify the following fields:

   • Plan name: Enter a migration plan name to display in the migration plan list.
   • Plan description: Optional: Brief description of the migration plan.
   • Source provider: Select a source provider.
   • Target provider: Select a target provider.

   • Target namespace: Do one of the following:

     • Select a target namespace from the list
     • Create a target namespace by typing its name in the text box, and then clicking create "<the_name_you_entered>"

   • You can change the migration transfer network for this plan by clicking Select a different network, selecting a network from the list, and then clicking Select.

     If you defined a migration transfer network for the OpenShift Virtualization provider and if the network is in the target namespace, the network that you defined is the default network for all migration plans. Otherwise, the pod network is used.

4. Click Next.
5. Select options to filter the list of source VMs and click Next.
6. Select the VMs to migrate and then click Next.
7. Select an existing network mapping or create a new network mapping.

8. . Optional: Click Add to add an additional network mapping.

   To create a new network mapping:

   • Select a target network for each source network.
   • Optional: Select Save current mapping as a template and enter a name for the network mapping.
9. Click Next.

10. Select an existing storage mapping, which you can modify, or create a new storage mapping.

    To create a new storage mapping:

    1. If your source provider is VMware, select a Source datastore and a Target storage class.
    2. If your source provider is Red Hat Virtualization, select a Source storage domain and a Target storage class.
    3. If your source provider is OpenStack, select a Source volume type and a Target storage class.
11. Optional: Select Save current mapping as a template and enter a name for the storage mapping.
12. Click Next.

13. Select a migration type and click Next.

    • Cold migration: The source VMs are stopped while the data is copied.
    • Warm migration: The source VMs run while the data is copied incrementally. Later, you will run the cutover, which stops the VMs and copies the remaining VM data and metadata.
14. Click Next.

15. Optional: You can create a migration hook to run an Ansible playbook before or after migration:

    1. Click Add hook.
    2. Select the Step when the hook will be run: pre-migration or post-migration.

    3. Select a Hook definition:

       • Ansible playbook: Browse to the Ansible playbook or paste it into the field.

       • Custom container image: If you do not want to use the default hook-runner image, enter the image path: <registry_path>/<image_name>:<tag>.

         Note

         The registry must be accessible to your Red Hat OpenShift cluster.

16. Click Next.

17. Review your migration plan and click Finish.

    The migration plan is saved on the Plans page.

    You can click the Options menu of the migration plan and select View details to verify the migration plan details.

Procedure

1. In the Red Hat OpenShift web console, click Migration Plans for virtualization.

   The Plans list displays the source and target providers, the number of virtual machines (VMs) being migrated, the status, and the description of each plan.

2. Click Start beside a migration plan to start the migration.

3. Click Start in the confirmation window that opens.

   The Migration details by VM screen opens, displaying the migration’s progress

   Warm migration only:

   • The precopy stage starts.
   • Click Cutover to complete the migration.

4. If the migration fails:

   1. Click Get logs to retrieve the migration logs.
   2. Click Get logs in the confirmation window that opens.
   3. Wait until Get logs changes to Download logs and then click the button to download the logs.

5. Click a migration’s Status, whether it failed or succeeded or is still ongoing, to view the details of the migration.

   The Migration details by VM screen opens, displaying the start and end times of the migration, the amount of data copied, and a progress pipeline for each VM being migrated.

6. Expand an individual VM to view its steps and the elapsed time and state of each step.

Procedure

1. In the Red Hat OpenShift web console, click Plans for virtualization.
2. Click the name of a running migration plan to view the migration details.
3. Select one or more VMs and click Cancel.

4. Click Yes, cancel to confirm the cancellation.

   In the Migration details by VM list, the status of the canceled VMs is Canceled. The unmigrated and the migrated virtual machines are not affected.