Migrating existing virtual machines

To help understand the process of mapping resources, such as datastores and port groups, from vSphere into OpenShift’s equivalents, storage classes and network attachment definitions, let’s begin by reviewing the source environment for the migrations.

1. Navigate to VMware vCenter: vCenter Console

2. Login with the following credentials:

   1. User: {vcenter_user}

   2. Password: {vcenter_password}

3. By default you’ll land in the Inventory view at the top of the navigation tree. Click the Workloads icon and expand the navigation tree until you see the folder that matches your username, and the 4 VMs under it. Click the VMs tab at the top of the screen to view the VM details (Figure 1).

   

    

4. Change to the Networks view, then expand the tree to view the port group used by the virtual machines (Figure 2). Note that the name is segment-migrating-to-ocpvirt.

   

    

5. Finally, review the datastores in use by browsing to the Datastores view. Expand the tree to see the datastores that are attached to the SDDC-Datacenter, and optionally browse to the VMs sub-tab to view the capacity used by each virtual machine.

   

The Migration Toolkit for Virtualization (MTV) uses the VMware Virtual Disk Development Kit (VDDK) SDK to transfer virtual disks from VMware vSphere. The VDDK has already been configured for you in this environment.

1. Navigate in the left menu to Migration → Providers for virtualization

2. Select project openshift-mtv (You may need to toggle the Show default projects slider (Figure 4).

   

    

   Tip: MTV 2.4 and later are project/namespace aware and do not require administrator privileges. You can delegate VM imports to application teams and VM users so that they can self-serve and migrate at their own pace!

3. By default, there is a provider called host which represents OpenShift Virtualization as a target platform (Figure 5).

   

    

4. The lab is already configured with the VMWare provider named vmware and it is marked as a migration source.

Now that we have reviewed our environment, and have our providers created, it is time for us to create a Migration Plan. This plan selects which VMs to migrate from VMware vSphere to Red Hat OpenShift Virtualization and specifics about how to execute the migration.

1. Navigate in the left menu to Migration → Plans for virtualization and press Create plan (Figure 6).

   

    

2. You will be asked to select the source provider that you intend to migrate from. Click on the VMware tile (Figure 7).

   

    

3. On the next page select the three VMs you would like to move:
   1. database
   2. winweb01
   3. winweb02

4. Click Next (Figure 8).

   

    

5. On the next screen you will be tasked with providing details for your migration plan. Several details will already be filled in for you, but you will have to make a few minor modifications to ensure that the VMs land in the correct namespace, and that the networks and storage options map correctly.

   Please fill in your migration plan with the following values:

   1. Plan name: move-webapp-vmware
   2. Target namespace: vmexamples
   3. Network map: Pod Networking

   4. Storage map: ocs-storagecluster-ceph-rbd-virtualization

      Note: Both the Network and Storage map will automatically detect the Network and Datastore that the discovered virtual machines currently make use of on the source provider. You will just need to make sure that their respective values are set correctly on the OpenShift side.

6. Click Create migration plan (Figure 9).

   

    

7. You will be taken to a new screen where you will see that the plan for migration is being made ready (Figure 10).

   

    

8. After a few moments the plan will become Ready, click on the green "Play" button in the center of the window to start the migration process (Figure 11).

   

    

9. You will be presented with a confirmation box to begin the migration, click on the Start button (Figure 12).

   

    

10. A progress bar will appear in the center of the screen along with the status of 0 of 3 VMs migrated (Figure 13).

    

     

11. Click on the 0 of 3 VMs migrated link and you will be presented with a page with more details about the migration process (Figure 14).

    

     

12. You can click the drop-down arrow next to the name of each VM being migrated to get additional details about the stages of the migration process (Figure 15).

    

     

    Important: Having many participants performing the same task in parallel in a simulated lab environment can cause this task to perform much slower than in a real environment. For this lab instance we have limited the number of in-flight VMs to 1 at a time. Please be patient with this process as it completes. You may continue with other sections in the roadshow as the migrations complete.

13. After several minutes the migration has completed (Figure 16).

    

     

14. The selected VMs have now been migrated and can be started on OpenShift Virtualization.