On this page:
This topic describes how to migrate a Controller from a physical or virtual machine to a new physical machine.
Migrating the Controller often results from the need to move the Controller to new hardware in response to increased load. Before starting, make sure that the new hardware meets the AppDynamics requirements as described in Controller System Requirements. Specifically, review the Controller hardware performance profiles and the hardware requirements per profile information to verify that the target Controller hardware meets the RAM size and Disk I/O requirements.
If you are performing a migration and upgrade for a 4.3 version Controller or earlier, then you should migrate the Controller first. Then you can upgrade the Controller to 4.4 by installing the Enterprise Console and using the Discover & Upgrade feature. This also applies to migrations involving different OS environments.
VMotioning, or migrating a VMware guest with a running Controller inside it from one host to another, is not supported. Doing so will lead to dropped metrics and UI performance problems.
Migrating a Controller
You can use the high availability features provided by the Enterprise Console to, in effect, migrate a Controller from one machine to another. The following steps outline a high-level workflow for the process.
They assume that the Controller you need to migrate is already managed by the Enterprise Console's, that is, it has been installed or discovered by the Enterprise Console. See Enterprise Console for more information.
The general steps involve adding the new host as an HA pair to the old host, setting the new host as active, and then removing (that is, decomissioning) the old host. When finished the Controller will be running on the new host. Before starting, review requirements and concepts related to Controller High Availability.
In detail, the steps are:
- Log in to the Enterprise Console UI interface.
- Click on the Platform that has the host you want to migrate.
- 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.
- In the Controller page, click Add Secondary and select the new target host. Provide the DB root password and Controller root password and click Submit.
- In the controller page, click HA failover.
Now the Primary controller should be running on the new host.
- Update the license MAC address or apply a new license for the new machine. See Before Starting for more information.
- Decommission the old, now passive Controller from the Controller page:
Click Remove Controller, or run the following command on the Enterprise Console host:
- Select the remove binaries option. (Do not select Remove entire cluster.)
You can keep the same access key from the old Controller. To migrate or update your access key, see Controller Secure Credential Store. Note that the license rule access keys still need to be updated.