On this page:
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:
Linux Windows Linux Windows
bin\platform-admin.exe cli -h
bin/platform-admin.sh <command> -h
bin\platform-admin.exe cli <command> -h
bin/platform-admin.sh list-jobs --service <controller or events-service>to see a list of jobs available for the provided service. You can then see what parameters are required for the provided job using
bin/platform-admin.sh list-job-parameters --job <job_name> --service <controller or events-service>.
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.
Managing the Password of the Enterprise Console
Commands for resetting or changing your Enterprise Console password are:
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:
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 Linux Windows
--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
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.