This page describes how to move a VMware ESX between clusters that are connected to InfiniBox.

Choosing your migration type (according to your environment) 

  • 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 a new host by 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 - unmap them from the host first. (after all virtual machines are turned off)

Migration Process

  1. In vSphere Web Client:
    1. Navigate to the host that you want to remove from a 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 icon beside the host name changes.
    4. Right-click the host and select Move To.
    5. Select the cluster to move the host to.
      • vCenter Server moves the host to the new location.
  2. Login to the InfiniBox system (GUI or CLI) that is connected to the cluster:
    1. Remove the host from the old cluster.
    2. Add the host to the cluster which the host was moved to.
      • If the new cluster does not exists - manually create the cluster or let Host PowerTools for VMware to automatically create it.
  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 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 System List. Follow the instructions here: Locating the Host PowerTools for VMware System List.

      3. Refresh Page.

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

Online Migration


  • The host must have 2 physical FC ports (2 WWPNs) or more
  • Multipath is configured correctly and is fully operational.
  • All volumes have to be mapped to both clusters with same LUN ID (LUN mapping) prior to the migration
    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 
  • The cluster that you migrate to, needs to be registered on the InfiniBox.

Migration Process

During the ESX migration process the INFINIDAT tab in the UI will be inconsistent, please don't open it nor use it.
When the migration is done, open the INFINIDAT tab and press Refresh Page 

  1. Verify that all of the prerequisites are met.
  2. Using the Infinishell, create another host.
    Let's say that we want to migrate an ESX host named host-foobar from cluster1 to cluster2.
    in infinishell

    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 using Infinishell.

    cluster.add_host name=cluster2 host=host-foobar.migration-host
  5. Rescan the migrated host (via VMware )  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. Rescan again making sure no path were lost.

  8. Through the VMware GUI, disconnect the ESX 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 using the GUI, Cluster - > Add Host.

  10. Using Infinishell remove the original host from the cluster and delete it. 

    cluster.remove_host name=cluster1 host=host-foobar
    host.delete name=host-foobar
  11. Using Infinishell 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. Go to the INFINIDAT tab in the VMware interface , 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