Enterprise Console Command Line

The Enterprise Console command line utility allows you to perform orchestration tasks in an automated way. It is designed with the following limitations in mind:

• There is not a complete match of all the functionalities provided by the web UI. 
• The command line utility is only supported to run on the host where the Enterprise Console is installed. 

Command Line Directory

The platform-admin.sh|bat script in the <Enterprise Console home>/platform-admin/bin directory on the host machine provides a set of commands to install and manage the AppDynamics platform. 

To see the operations available for the Enterprise Console, from the command line, navigate to directory and run the script with -h specified:

bin/platform-admin.sh -h

bin\platform-admin.exe cli -h

bin/platform-admin.sh <command> -h

bin\platform-admin.exe cli <command> -h

Note that not all commands available on Linux are available on Windows. Refer to the list displayed with the -h parameter for what the Enterprise Console can do.

The Enterprise Console prevents multiple users from running commands at the same time. If a second user attempts to run a command while another command is in progress, the second command is not completed and an error message appears indicating that another command is in progress. To avoid such conflicts, the Enterprise Console should generally be used by a single user at a time.   

Logging into and out of the Enterprise Console

Commands for logging in and out of the Enterprise Console are:

• login --user-name <admin_username> --password <admin_password>
  If it has been more than one day since your last session, you will have to log in before you are able to use the command line utility. You will also have to log in again if you see the following error message:

  error: Command failed due to an error: Unauthorized
  API code 401
  Session expired. Please login and run the command again.

• logout

Managing the Password of the Enterprise Console

Commands for resetting or changing your Enterprise Console password are:

• reset-password
  If you forget your admin password or run into a 401 error, run this command to reset your password to its default value, admin. You will need to log out then log back in for this change to take effect.
• change-password --user-name <username> --password <old_password> --new-password <new_password>

Starting and Stopping the Enterprise Console

Just as you can start and stop the Controller and Events Service, you can start and stop the Enterprise Console process. Commands for starting and stopping the Enterprise Console are:

• start-platform-admin
• stop-platform-admin 

The Enterprise Console must be running to install or administer Events Service nodes.

Setting the Current Platform

The optional parameter, --platform-name, can be passed in each of your commands to set the current working platform. However, you can set the environment variable, APPD_CURRENT_PLATFORM, so that you do not have to pass the current working parameter with each of your commands. You can set this variable using setenv or export. The Enterprise Console will pick up the value if it is present.

If you happen to provide the --platform-name parameter while APPD_CURRENT_PLATFORM is set, the value passed through the flag will override the environment variable.

All Platforms Flag

You can use the --all flag to denote that you want to modify all platforms with your command. For example, you can upgrade all platform binaries at once by running the following command:

bin/platform-admin.sh upgrade-orcha --all

bin\platform-admin.exe cli upgrade-orcha --all

Use Checkpoint Flag

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

Additional Enterprise Console Commands

The following is a list of frequently used Enterprise Console commands:

• create-platform --name <platform_name> --description <description> --installation-dir <install_dir>

• delete-platform --name <platform_name>
• upgrade-orcha --platform-name <platform_name>
  This command triggers an upgrade of the Orcha module binaries on all remote Orcha machines in the provided platform. The platform should not be running any jobs on its services when you run this command.
• list-supported-services
• show-platform-admin-version