Skip to main content
NetApp virtualization solutions

Next steps after converting or migrating VMs using the Shift Toolkit

Contributors netapp-jsnyder kevin-hoke

After you convert or migrate VMs using the Shift Toolkit, review key post-migration tasks to validate the new environment. You can verify system health, perform cleanup steps, and troubleshoot common issues using detailed examples.

Conclusion

NetApp Shift toolkit helps an administrator to rapidly and seamlessly convert VMs from VMware to Hyper-V. It can also convert just the virtual disks between the different hypervisors. Therefore, Shift toolkit saves you several hours of effort each time that you want to move workloads from one hypervisor to the other. Organizations can now host multi-hypervisor environments without having to worry about whether workloads are tied down to a single hypervisor. This capability increases flexibility and reduces licensing costs, lock-in, and commitments to a single vendor.

Next Steps

Unlock the potential with Data ONTAP by downloading Shift toolkit package and start migrating or converting the virtual machines or the disk files to simplify and streamline migrations.

To learn more about this process, feel free to follow the detailed walkthrough:

Shift Toolkit walkthrough

Troubleshooting and Known Issues

  1. Trigger script for setting IP address and removal VMware tools fails for Windows VM with the following error: The credential is invalid

    Error message:
    
    Enter-PSSession : The credential is invalid.
    
    Potential causes:
    
    The guest credentials couldn't be validated
    
    a. The supplied credentials were incorrect
    b. There are no user accounts in the guest
  2. Windows virtual machine encounters BSOD errors

    NOTE: This is not a Shift toolkit problem, however environment related.

    Error message:
    
    Bluescreen error during initial boot after migration.
    
    Potential cause:
    
    Local group policy setup to block the installation of applications including new drivers for Microsoft Hyper-V.
    
    a. Update the policy to allow installation of drivers.
  3. No datastores listed while trying to create a resource group

    Error message:
    
    Mount paths are empty while getting volumes for mountpaths for site.
    
    Potential causes:
    
    The NFS volume used as a datastore is using v4.1
    
    a. Shift toolkit filters out NFS v3 datastores during the resource group creation. NFS 4.1 or 4.2 is not supported in the current release.
  4. Unable to access Shift toolkit UI after enabling SSL.

    Error message:
    
    Login failed, Network error
    
    Potential causes:
    
    MongoDB service not running
    Using Firefox browser to access Shift UI
    
    a. Ensure Mongo service is running
    b. Use Google Chrome or IE to access Shift UI.
  5. Unable to migrate VMs with encryption enabled.

    Error message:
    
    Boot failure on Hyper-V side
    
    Potential causes:
    
    VMDK encrytped using vSphere encryption
    
    a. Decrypt the VMDK inside VMware and retry the operation.

Appendix

Custom ONTAP role for Shift toolkit

Create an ONTAP role with minimum privileges so that there is no need to use the ONTAP admin role to perform operations in Shift toolkit. These minimum roles are required at the SVM level on the ONTAP Storage Side.

Note vsadmin can also be used.

Figure showing input/output dialog or representing written content

Use ONTAP System Manager to create the role.

Perform the following steps in ONTAP System Manager:

Create a custom role:

  • To create a custom role at the SVM level, select Storage > Storage VMs > required SVM> Settings > Users and Roles.

  • Select the arrow icon (→) next to Users and Roles.

  • Select +Add under Roles.

  • Define the rules for the role and click Save.

Map the role to the Shift toolkit user:

Perform the following steps on the Users and Roles page:

  • Select Add icon + under Users.

  • Select the required username and select the role created in the previous step in the drop-down menu for Role.

  • Click Save.

Once done, use the above created user while configuring the source and destination sites within Shift toolkit UI.

Minimum permissions role required on VMware

To migrate virtual machines from VMware vSphere using Shift toolkit, create a RBAC user with the below mentioned privileges using Administration > Access Control > Roles.

Figure showing input/output dialog or representing written content