How to run a standalone on-premise controller as a service in Linux

[Xiangning.Mao]

A Step-by-Step Guide to run the standalone on-premise controller as a service in the Linux environment.

When you run a standalone on-premise controller manually, you can follow the steps described in the documentation below: https://docs.appdynamics.com/appd/onprem/24.x/latest/en/controller-deployment/administer-the-control...

However, there might be situations where you need to run the standalone on-premise controller as a service in a Linux environment. If so, you can follow the steps below.

1. Change the user to root
   

   sudo -i​

2. Install the library below (optional)
   

   apt install libxml2-utils -y​

   OR
   

   yum install libxml2 -y​

3. Move to the directory below:
   

   cd /opt/appdynamics/platform/product/controller/controller-ha​

4. Set up the controller db password and validate it
   

   ./set_mysql_password_file.sh -p <controller-db-password>​

   Output results:
   

   Checking if db credential is valid...​

5. Move to the directory below
   

   cd /opt/appdynamics/platform/product/controller/controller-ha/init​

6. Run the script below
   

   ./install-init.sh -s​

   Output results:
   

   update-rc.d will be used for installing init
   installed /etc/sudoers.d/appdynamics
   installing /etc/init.d/appdcontroller-db
   installing /etc/default/appdcontroller-db
   installing /etc/init.d/appdcontroller
   installing /etc/default/appdcontroller​

7. Run the commands below to enable the newly created service:
   

   systemctl enable appdcontroller
   systemctl enable appdcontroller-db
   systemctl restart appdcontroller
   systemctl restart appdcontroller-db
   systemctl status appdcontroller
   systemctl status appdcontroller-db​

Additionally, you might create your own unit file with the start/stop commands to run the standalone on-premise controller as a service in a Linux environment without using our script.