AppDynamics switched from Semantic Versioning to Calendar Versioning starting in February 2020 for some agents and March 2020 for the entire product suite.


    Skip to end of metadata
    Go to start of metadata

    You can start or stop the Controller, and also check the Controller health from the Enterprise Console GUI or CLI.

    Scripts Used to Start or Stop the Controller

    The scripts to start and stop the Controller and other AppDynamics platform processes are located in the platform-admin/bin directory for standalone or secondary HA Controllers. Using the platform-admin script, you can start the platform processes individually or all at once. 

    To avoid the possibility of data corruption errors, be sure to stop the application server and database gracefully by using the stop scripts before shutting off or rebooting the machine on which the Controller is running.

    You can start and stop the Controller and Controller services on the Controller page in the GUI or from the command line. When you start and stop the Controller, services and processes related to the Controller also start and stop, including the Reporting Service. If you use the GUI to start and stop the Controller, specify that you want to stop MySQL if you want to also stop the Controller Database.

    If your Enterprise Console manages multiple platforms, to distinguish the Controller platform, you must use the command line for standalone or secondary HA Controllers and specify the --platform-name <name_of_the_platform>.

    For example:

    platform-admin.sh start-controller-db --platform-name <name_of_the_platform>
    platform-admin.sh start-controller-appserver --platform-name <name_of_the_platform> 

    To see all options, run platform-admin.sh list-jobs --service controller --platform-name <platform-name> from the command line. For more information, see Enterprise Console Command Line or Administer the Enterprise Console.

    The Enterprise Console has a max wait time of 45 minutes when starting or stopping the Controller. You can set a timeout which exits the command and returns a failure by appending --args controllerProcessTimeoutInMin=<minutes> to the end of your start or stop command.

    How to Start or Stop a Standalone or Secondary High Availability Controller

    The commands below only apply to standalone and secondary HA Controllers. See Starting or Stopping a Primary Controller for information on how to start or stop primary Controllers.

    Start and Stop the Controller App Server

    • When using the Enterprise Console, starting or stopping the Controller will also start or stop the Reporting Service.
    • You can only start or stop the Secondary Controller.
    Start the Controller App Server

    The start-controller-appserver command starts the database automatically.

    Start the app server:

    platform-admin.sh start-controller-appserver

    On Windows, the Controller processes are installed as a service, named the AppDynamics Application service and AppDynamics Database service. Never stop the Controller services from the task manager.
    To stop and restart the AppDynamics processes, open an elevated command prompt (run as administrator) and run the scripts for starting and stopping the service. 

    Start the app server:

    platform-admin.exe cli start-controller-appserver

    Stop the Controller App Server

    The stop-controller-appserver command does not stop the database.

    Stop the app server:

    platform-admin.sh stop-controller-appserver

    When using Controller HA, you can add the secondary option to stop the secondary appserver:


    platform-admin.sh stop-controller-appserver --secondary

    Stop the app server:

    platform-admin.exe cli stop-controller-appserver

    When using Controller HA, you can add the secondary option to stop the secondary appserver:

    platform-admin.exe cli stop-controller-appserver --secondary

    If you have uninstalled the Controller as a Windows service for any reason, run (as administrator) these scripts from an elevated command prompt to stop and start the Controller:

    • startController.bat
    • stopController.bat

    Start and Stop the Controller Database

    Start the Controller Database

    Start the Controller database:

    platform-admin.sh start-controller-db

    Open an elevated command prompt (run as administrator). 

    Start the Controller database:

    platform-admin.exe cli start-controller-db

    Stop the Controller Database

    Stop the Controller database:

    platform-admin.sh stop-controller-db

    Open an elevated command prompt (run as administrator). 

    Stop the Controller database:

    platform-admin.exe cli stop-controller-db

    How to Start or Stop a Primary Controller in High Availability Pairs

    Use the following commands to start or stop primary Controllers in HA pairs. You must log in to the primary Controller host before running the scripts to start the controller.sh processes. 

    • You should disable auto-failover before restarting a primary Controller. Do not forget to reenable auto-failover afterward.
    • If you enabled auto-failover in the Enterprise Console, and you stopped the app server to update certifications, the Enterprise Console will trigger a failover if it takes longer than five minutes to update.
    • If you are using a combination of the Enterprise Console with the High Availability Toolkit (HATK), then you can start or stop the Controller using services.

    Start and Stop the Controller

    To start the Controller, run this script from the Controller home:

    bin/startController.sh
    bin\startController.exe cli
    To stop the Controller: 
    bin/stopController.sh
    bin\stopController.exe cli

    Start and Stop the Controller App Server

    To start the app server, run this script from the Controller home:

    bin/controller.sh start-appserver 
    bin\controller.exe cli start-appserver 
    To stop the app server, run this command:  
    bin/controller.sh stop-appserver
    bin\controller.exe cli stop-appserver 

    Start and Stop the Controller Database

    On Linux

    To start the database, run this script from the Controller home:

    bin/controller.sh start-db

    To stop the database:  

    bin/controller.sh stop-db

    How to Check Controller Health

    On Linux

    To check on the health of the Controller, run:

    bin/platform-admin.sh check-controller-health

    The following output shows the status of the Controller and its uptime:

    Controller status : HEALTHY; Started 6 seconds ago.
    • No labels