This page applies to on-premise deployments.

You can use the Enterprise Console to discover and upgrade existing Cisco AppDynamics On-Premises components, such as a Controller or Events Service. After you discover the components, they can be added to the platform and be managed by the application. This process can be performed with the GUI or command line. You can discover Controllers that are version 4.1 or later.

Before you discover existing components, you need the following information:

Controller

  • Controller root user password
  • Installation directory
  • Database password
  • Host name or IP address

Events Service

  • Host names or IP addresses
  • Installation directory. Note that if you have an Events Service cluster, this directory is the same on every node.
  • Host credentials (SSH key file and username)

Using the GUI

You can use the Custom Install Discover & Upgrade option in the GUI to create a platform and discover a Controller and Events Service. Alternatively, if you have already created a platform, you must add credentials and hosts to the platform before you can perform discovery. Then, discover the Controller or Events Service on the page for that component. For more information about how to add credentials and hosts, see Administer the Enterprise Console.

When the Enterprise Console discovers a component, it also checks to see if an upgrade is available and performs the upgrade.

Using the Command Line

Controller

Use the discover-upgrade-controller command to discover and upgrade a Controller:

bin/platform-admin.sh discover-upgrade-controller --host <host> --controller-root-password <root user password for Controller> --installation-dir <Controller installation directory> --db-root-password <password for Controller database>

If your upgrade fails, you can resume by passing the flag useCheckpoint=true as an argument after --args.

Events Service

The discover-events-service command can discover and upgrade an Events Service.

bin/platform-admin.sh discover-events-service --hosts <host 1> <host 2> <host 3> --installation-dir <Events Service installation directory>

Instead of listing each host, you can specify a line-separated list in a text file:

bin/platform-admin.sh discover-events-service -n <file path for the host file> --installation-dir <Events Service installation directory>

If your upgrade fails, you can resume by passing the flag useCheckpoint=true as an argument after --args.