For AI agents: the complete documentation index is available at https://docs.us.ovhcloud.com/en/llms.txt, the full documentation bundle is available at https://docs.us.ovhcloud.com/en/llms-full.txt, and this page is available as Markdown at https://docs.us.ovhcloud.com/en/hosted-private-cloud/nutanix-on-ovhcloud/move-to-nutanix.md.
  • English

Migrating to Nutanix with the Nutanix Move Tool

View as Markdown

Learn how to perform a migration with the Move software. Nutanix provides a tool called Nutanix Move that allows migrations from other environments to AHV.

Warning

NOTE: OVHcloud provides services for which you are responsible, concerning their configuration and management. It is therefore your responsibility to ensure that they work properly.

This guide is designed to assist you as much as possible with common tasks. However, we recommend reaching out to the OVHcloud Professional Services team if you encounter difficulties or have any doubts about managing, using, or setting up a service on a server.

Some options, such as the use of compression or dedupilcation, require specific licenses provided by Nutanix through OVHcloud. Please contact OVHcloud Sales for more information.

Finally, if the procedure involves a VMware on OVHcloud service, the intervention of OVHcloud Professional Services is mandatory.

Info

Some options, such as the use of compression or deduplication, require specific licenses provided by Nutanix through OVHcloud. Please contact OVHcloud Sales for more information.

 

Requirements

  • A Nutanix cluster in your OVHcloud account
  • Access to the OVHcloud Control Panel
  • You must be connected to the cluster via Prism Central
  • A connection to an environment other than Nutanix

 

Nutanix Move Overview

Nutanix Move is a tool that allows virtual machine migrations from VMware ESXI, Hyper-V, Azure, and AWS to AHV.

It can also be used to migrate from Nutanix AHV to AWS.

This software works on a virtual machine whose sources are available on the Nutanix website with a customer account.

For optimal use, we recommend installing Nutanix Move as close as possible to the destination.

The Nutanix Move software is the only software that communicates between the source and the destination.

Warning

Note: It is strongly discouraged to use Nutanix Move with virtual machines on a Windows Server running Active Directory or Microsoft Exchange. It is best to migrate as recommended by Microsoft.

For VMs that use databases in Microsoft SQL, it is best to stop the database service when completing a migration.

Ensure that the original virtual machine is compatible with the destination Nutanix environment.

 

Instructions

We will look at how to migrate between a remote environment on Hyper-V to an OVHcloud Nutanix environment.

The source and the destination are on two interconnected private networks through an IPSEC VPN.

 

Preparing the original virtual machines before migration

The virtual machine must be in the list of supported virtual machines in the compatibility matrix for the migration to work.

Log in to the Nutanix Accounting Matrix site to verify the compatibility of the source machines with the destination environment on Nutanix.

 

Specificity of virtual machines on LINUX

Some virtual machines will not start correctly after migration via Nutanix Move.
Check the compatibility list as it is likely that the SCSI driver is not supported and needs to be changed with the PCI driver.
In this case, you will need to follow this procedure to change the disk controller of a Virtual Machine after the virtual machine is migrated.

 

Specificity of the Microsoft environment

Microsoft does not provide the SCSI adapter and network card Virtio drivers. These drivers must be installed before migration. These drivers are available on the Nutanix website with a customer account.

Warning

Note: Microsoft Windows 2008 is no longer supported by Microsoft or Nutanix. However, you can install older Virtio drivers and attempt a migration.

Login to the Nutanix website with a customer account to download the VIRTIO drivers.

Enter your user name in Email, your password in Password, and click Log In.

Move to Nutanix - step 1

Click the Download link that suits your needs.

For our example, we will download the driver for amd64.

Move to Nutanix - step 2

From a Windows virtual machine in the Hyper-V environment, double-click Nutanix-VirtIO-1.1.7-amd64.

Move to Nutanix - step 3

Read the license terms and conditions, accept them by ticking the box, and then click Install.

Move to Nutanix - step 4

Click Finish to complete the installation without having to restart the virtual machine.

Move to Nutanix - step 5

 

Installing Move on the Nutanix Cluster

Downloading and importing sources

Retrieve the file in qcow2 format from this site: Download link for Nutanix Move.

Sign in with an account registered with Nutanix.

Move to Nutanix - step 6

Click Download to the right of Move QCOW2 file for AHV.

Move to Nutanix - step 7

Import the downloaded image from Nutanix Move into the cluster. For more information on importing images, see our guide on importing images. 

 

Installing the Move virtual machine

Create a virtual machine from the Move image.

From Prism Central, open the main menu by clicking on the button in the top left-hand corner.

Move to Nutanix - step 8

Click VMs in the menu.

Move to Nutanix - step 9

Click Create VM.

Move to Nutanix - step 10

Type Nutanix Move in the Name field.

Choose the 2 vCPU, 2 Cores, and 8 GB options in the VM Properties fields and click Next.

Move to Nutanix - step 11

Click Attach Disk.

Move to Nutanix - step 12

Choose the Disk, Clone from Image, and move-4.3.0.qcow2 options and click Save.

Move to Nutanix - step 13

Click on Attach to Subnet.

Move to Nutanix - step 14

Choose the network in Subnet, make sure it is connected in Network Connection State, and click Save.

Move to Nutanix - step 15

Click Next.

Move to Nutanix - step 16

Leave the default time zone options and click Next.

Move to Nutanix - step 17

Click Create VM to complete the installation of the Nutanix Move virtual machine.

Move to Nutanix - step 18

Select the Nutanix Move virtual machine and click the Actions menu.

Move to Nutanix - step 19

Click Power On in the Actions menu to start the virtual machine.

Move to Nutanix - step 20

The virtual machine is started and an IP address is obtained if a DHCP server is operational on that network.

Move to Nutanix - step 21

This installation of Nutanix Move is done on a network that has a DHCP server, but it is possible to configure the virtual machine on a network without a DHCP server.

 

Configuring Nutanix Move

Logging in to the web interface and creating environments for migration

Connect to the IP address of the Nutanix Move virtual machine through a web browser in HTTPS, as follows: https://IPaddressNutanixMove/.

Read the license conditions, accept them and click Continue.

Move to Nutanix - step 22

Click OK to continue.

Move to Nutanix - step 23

Select and confirm a password in the fields provided, then click Set Password to validate the creation of the Nutanix Move password.

Move to Nutanix - step 24

Type the password in Password and click Log In to log into the Nutanix Move web interface.

Move to Nutanix - step 25

Click + Add Environment.

Move to Nutanix - step 26

Choose Nutanix AOS.

Move to Nutanix - step 27

Enter the following information:

  • PRISM-CENTRAL-DESTINATION in the Environment Name field
  • the private IP address of Prism Central in the Nutanix Environment field
  • a Prism Central administration account in the Username field
  • the account password in the Password field

Click ADD to add the Prism Central environment.

Move to Nutanix - step 28

Click Add Environment.

Move to Nutanix - step 29

Choose Microsoft Hyper-V.

Move to Nutanix - step 30

Enter the following information:

  • HyperV-SOURCE in the Environment Name field
  • the private IP address of the Hyper-V server in the Hyper-V Server/Cluster field
  • a Hyper-V administration account in the Username field
  • the password for this account in the Password field

Click ADD to add the Hyper-V environment.

Move to Nutanix - step 31

Both migration environments appear in the top left-hand corner.

Move to Nutanix - step 32

 

Creating a migration plan

We will create a migration plan from the two environments created previously.

The source will be the Hyper-V server, and the destination will be the Nutanix cluster.

Click Create a Migration Plan.

Move to Nutanix - step 33

Choose a name in the Plan Name field and click Proceed.

Move to Nutanix - step 34

Enter the following information:

  • HyperV-SOURCE in the Select a Source field
  • PRISM-CENTRAL-DESTINATION in the Hyper-V Server/Cluster field
  • the CLUSTER name in the Target Cluster field
  • the name of the destination container in the Target Container field

Then click Next to continue to the next step.

Move to Nutanix - step 35

Select the virtual machines you want to migrate from the Hyper-V environment to AOS by clicking on the + icon to the left of the VM.
Click Next to continue creating the migration plan.

Move to Nutanix - step 36

Choose the network in Target Network and click Next.

Move to Nutanix - step 37

Click Next to confirm the migration.

Move to Nutanix - step 38

Click Save to save the migration plan without running it.

Move to Nutanix - step 39

 

Launching the migration

After the migration plan is created, you can manually launch it.

Check the box next to the desired migration plan.

Move to Nutanix - step 40

On the Actions menu, click Start.

Move to Nutanix - step 41

The migration is in progress. The Status column gives you information on the status of the migration.

Move to Nutanix - step 42

 

Finalizing the migration

Check the status of the migration by hovering over the In Progress status.
A window with the information Ready to Cutover N should appear, listing the number of VMs that can be migrated.

Click In Progress to start the completion process.

Move to Nutanix - step 43

Select all the VMs by ticking the VM Name box then click Cutover.

Move to Nutanix - step 44

Click Continue.

Move to Nutanix - step 45

Wait a few moments while it completes.

Move to Nutanix - step 46

The migration is complete when Completed appears in the Migration Status column.

Move to Nutanix - step 47

Log into Prism Central to view the three migrated VMs that are present and running.

Move to Nutanix - step 48

 

Changing the Disk Controller on a Linux Virtual Machine

If the virtual machine does not start properly after the migration, it may be due to a bad disk controller in the virtual machine configuration. In this case, it should be changed by following this procedure:

Go to the main menu of Prism Central and click on VMs.

Move to Nutanix - step 49

Make sure the virtual machine is turned off.

Move to Nutanix - step 50

Return to the main menu and click Images.

Move to Nutanix - step 51

Click Add Image.

Move to Nutanix - step 52

Select VM Disk as the Image Source. Type a name in Search by VM Name and click +.

Move to Nutanix - step 53

Type a name in the Image Name field and click Next.

Move to Nutanix - step 54

Select Place image on source VM's cluster and click Save.

Move to Nutanix - step 55

The image created from the virtual machine appears after a few moments.

Move to Nutanix - step 56

Open the main menu and click VMs.

Move to Nutanix - step 57

Check the box to the left of the virtual machine.

Move to Nutanix - step 58

Open the Actions menu and choose Update.

Move to Nutanix - step 59

Click on the trash can icon next to the CDROM drive.

Move to Nutanix - step 60

Click on the trash can icon next to the disk drive.

Move to Nutanix - step 61

Click Attach Disk.

Move to Nutanix - step 62

Select:

  • Disk In Type
  • Select Clone from image
  • Enter the name of the image created in Image
  • Select PCI as the Bus type and click Save

Move to Nutanix - step 63

Click Next.

Move to Nutanix - step 64

Click Next.

Move to Nutanix - step 65

Click Save.

Move to Nutanix - step 66

The disk controller has been modified and the virtual machine boots properly.

 

Go further

Browse all the Nutanix guides.

Browse the rest of the OVHcloud US documentation for guides on our other products and services.

Learn more about Nutanix on OVHcloud on the OVHcloud US website.