This page describes how to move a vSphere ESXi host between vSphere clusters that are connected to InfiniBox.

Migration types

  • Traditional migration - includes moving the migrated ESX into "Maintenance Mode".
  • Online Migration - migrating the host while it has running VMs.
    • Requires multi FC ports on each ESX host to migrate.

Traditional Migration (recommended)


  • Verify that all virtual machines on the host are powered off, or migrate the running virtual machines to another host using vMotion.
  • Before moving the host to another cluster, make sure that no volumes that are mapped directly to the host are also mapped to the cluster which the host will be migrated to.
    • If there are:
      • Make sure there are no running VMs on the host. 
      • Unmap these volumes from the host. 

Migration Process

  1. In vSphere Web Client:
    1. Navigate to the host that you want to move to another cluster.
    2. Right-click the host and select Enter Maintenance Mode.
      • All virtual machines on the host must be powered off so that the host can enter maintenance mode.
    3. In the confirmation dialog box that appears, click Yes.
      • When the task for entering maintenance mode completes, the host icon changes.
    4. Right-click the host and select Move To.
    5. Select the desired cluster to move the host to.
      • vCenter Server moves the host to the new location.
  2. Login to the InfiniBox system (using GUI or InfiniShell) that is connected to the cluster:
    1. Remove the host from the old cluster.
    2. Add the host to the another cluster which the host was moved to.
      • If the new cluster does not exists - The best method is to register it using Host PowerTools for VMware. 
  3. In vSphere Web Client:
    1. Reboot the migrated host.
      • Removing the LUNs from the old cluster is best handled by the ESX host if its rebooted before exiting Maintenance mode.
      • Wait until reboot completes and the host is re-reconnected. 
    2. Right-click the host and select Exit Maintenance Mode.

    3. If Host PowerTools for VMware is installed:

      1. Select the cluster object which contains the migrated host.

      2. Locate Host PowerTools for VMware INFINIDAT View. Follow the instructions here: Locating the INFINIDAT View.

      3. Refresh Page.

      4. If the cluster was not registered - click Register Cluster.

Online Migration


  • The host must have at least 2 physical FC ports (2 or more WWPNs).
  • Multipath is configured correctly and is fully operational.
  • The cluster that you migrate to, needs to be registered on the InfiniBox.
  • Prior to the migration - All volumes have to be mapped to both clusters with the same LUN ID
    • e.g example-vol13 is mapped to cluster-1 on lun=123 and example-vol13 has to be mapped to cluster-2 on lun=123 

Migration Process

During the ESXi host migration process the INFINIDAT View in the vSphere Web Client will be inconsistent, do not use or open it.
When the migration is done, the INFINIDAT View should be refreshed

  1. Verify that all of the prerequisites are met.
  2. Login to the InfiniBox system (using GUI or InfiniShell) and create another host.
    Example (using InfiniShell) - Let's say that we want to migrate an ESX host named host-foobar from cluster1 to cluster2:

    host.create name=host-foobar.migration-host
  3. Now, remove one of the ports (WWPN) from the original host, and add it to the migration-host.

    host.remove_port name=host-foobar port=2100000000000011 
    host.add_port name=host-foobar.migration-host port=2100000000000011
  4. Add your migration host to the new cluster.

    cluster.add_host name=cluster2 host=host-foobar.migration-host
  5. On vSphere Web Client - Rescan the migrated host and make sure no paths were lost.

    if some paths were lost and did not recover, stop the process and rollback everything

  6. Assuming all went smooth, move all ports to the "migration-host".

    host.remove_port name=host-foobar port=21000000000000XX
    host.add_port name=host-foobar.migration-host port=21000000000000XX
    host.remove_port name=host-foobar port=21000000000000YY
    host.add_port name=host-foobar.migration-host port=21000000000000YY
  7. On vSphere Web Client - Rescan again making sure no path were lost.

  8. Through the vSphere Web Client, disconnect the ESXi host from the cluster, then remove it.

  9. Go to the cluster that you want to add the host to (in our example: cluster2) and add it to the cluster: Cluster - > Add Host.

  10. On the InfiniBox system, remove the original host from the cluster and delete it. 

    cluster.remove_host name=cluster1 host=host-foobar
    host.delete name=host-foobar
  11. On the InfiniBox system, rename the "migration-host" to the host you just deleted (the host original name).

    host.rename name=host-foobar.migration-host new_name=host-foobar
  12. On vSphere Web Client, locate the INFINIDAT View of the cluster to which the host was just added, Refresh the page and make sure all is displayed as expected.

Was this article helpful?
0 out of 0 found this helpful

0 out of 0 found this helpful