Migrating a Linux Controller

You can use the high availability features provided by the Enterprise Console to migrate a Controller from one machine to another. It is assumed that the Controller you need to migrate is already managed by the Enterprise Console (it has been installed or discovered by the Enterprise Console). See Enterprise Console for more information.

You add the new host as an HA pair to the old host, set the new host as active, and then remove (decommission) the old host. When finished, the Controller will run on the new host.

Before starting, you should review the requirements and concepts related to Controller High Availability.

To migrate a Linux Controller:

  1. Log in to the Enterprise Console UI interface.
  2. Select the Platform containing the host you want to migrate.
  3. In the Hosts page, add the new host (the one to serve as the new target host) and provide the credentials for connecting to that host.
  4. In the Controller page, select Incremental Replication and select the new target host. Complete 4-5 runs of incremental replication. The number of ongoing incremental replication runs will be indicated in the Enterprise Console UI interface.
  5. In the Controller page, select Add Secondary and select the new target host. Provide the DB root password and Controller root password, and select Submit.
  6. In the Controller page, select HA failover.
    The Primary Controller is now running on the new host.
  7. Update the license MAC address or apply a new license for the new machine. See Before Starting for more information.
  8. Decommission the old Controller from the Controller page:
    1. Select Remove Controller, or run the following command on the Enterprise Console host:
      platform-admin.sh submit-job --job remove --service controller --args removeBinaries=true
    2. Select the remove binaries option. (Do not select Remove entire cluster.)
    The Controller is now running on the newly provisioned host.
You can keep the same access key from the old Controller. To migrate or update your access key, see Controller Secure Credential Store.
Note: You must update the license rule access keys.