Discovery and Upgrade Quick Start

This quick start guide describes how to use the Enterprise Console to discover existing AppDynamics components, such as a Controller, and use it to upgrade them.

Install the Enterprise Console

  1. Install the Enterprise Console with the following command:

    Linux

    ./platform-setup-64bit-linux.sh

    Windows

    platform-setup-64bit-windows.exe

    When the installation wizard launches, complete it to install the Enterprise Console. For more information about how to install the Enterprise Console, see Install the Enterprise Console.

  2. Verify that the Enterprise Console successfully installed by opening the GUI using the host and port you specified during installation: 
    http(s)://<hostname>:<port>
    9191 is the default port.
  3. Complete the installation process with the GUI or command line.

Discover and Upgrade with the Enterprise Console GUI

The options presented are based on the state of your platform. If you have not created a platform, choose Discovery from the options presented. Complete the wizard to create a platform, add hosts, and discover the Controller and Events Service.

If you created a platform already, such as with the CLI, complete the following steps:

  1. Identify the host(s) where the Controller and Events Service are installed.
  2. On the Credentials page, add credentials to the platform if you are using remote hosts.
    Note: Remember to provide the private key file for the Enterprise Console machine when adding a credential.
  3. Navigate to the Hosts page and add hosts.
    1. If the Controller and Events Service are installed on the same host as the Enterprise Console, select Add Enterprise Console Host.
    2. If the Controller and Events Service are installed on different hosts than the Enterprise Console, input the host(s). Select a credential for the host(s) and add credentials to the platform.

Discover and Upgrade with the CLI

  1. Navigate to the directory where you installed the Enterprise Console.
  2. Create a platform with the following command: 
    bin/platform-admin.sh create-platform --name <platform_name> --installation-dir <platform_installation_directory>
  3. Add credentials that the platform can use to access hosts with the following command:
    bin/platform-admin.sh add-credential --credential-name <name> --type ssh --user-name <username> --ssh-key-file <file_path_to_the_key_file>

    <file path to the key file> is the private key for the Enterprise Console machine. The installation process deploys the keys to the hosts.

  4. Add hosts to the platform:
    bin/platform-admin.sh add-hosts --hosts localhost host_2 host_3 --credential <credential_name>

    At a minimum, make sure to bootstrap all of the hosts where the AppDynamics server-side components, namely the Controller and Events Service, are installed.

    Note: You may also use the loopback address '127.0.0.1' or the machine's actual hostname in place of 'localhost'.