Change the User Running the Controller Services

This page provides instructions for changing the user running the Controller services.

You may need to change the user who is running the Controller services during a system migration or other event.

The procedure varies based on whether you are using the Enterprise Console.

If you are not using the Enterprise Console

  1. As the current user running the Controller services, shut down the Controller process:
    CODE 
    CONTROLLER_HOME_DIR/bin/controller.sh stop
  2. Change the ownership (recursively) of the entire Controller directory to the new user. In this example, appdynamics:admin is the user:group, respectively:
    CODE 
    chown -R appdynamics:admin CONTROLLER_HOME_DIR/
  3. If the Controller's data directory is outside of the root Controller's folder, then you must also change the owner of the database data files:
    CODE 
    chown -R appdynamics:admin .../data/
  4. Change the user to the new username:
    CODE 
    CONTROLLER_HOME_DIR/db/db.cnf
  5. Log in as the new user and start the Controller services:
    CODE 
    CONTROLLER_HOME_DIR/bin/controller.sh start

If you are using the Enterprise Console

  1. Remove the Controller from the Enterprise Console by de-selecting the Remove Binaries option; otherwise, the binaries will be removed from the disk. To remove the Controller without uninstalling the Controller:
    CODE 
    PLATFORM_HOME_DIR/bin/platform-admin.sh submit-job --service controller --job remove --args removeBinaries=false --skip-confirm
  2. As the current user running the Controller services, shut down the Controller process.
    CODE 
    CONTROLLER_HOME_DIR/bin/controller.sh stop
  3. Change the ownership (recursively) of the entire Controller directory to the new user. In this example, appdynamics:admin is the user:group, respectively:
    CODE 
    chown -R appdynamics:admin CONTROLLER_HOME_DIR/
  4. If the Controller's data directory is outside of the root Controller's folder, then you must also change the owner of the database data files:
    CODE 
    chown -R appdynamics:admin .../data/
  5. Change the user to the new username:
    CODE 
    CONTROLLER_HOME_DIR/db/db.cnf
  6. Log in as the new user and start the Controller services:
    CODE 
    CONTROLLER_HOME_DIR/bin/controller.sh start
  7. From the Enterprise Console, remove the hosts that were added:
    CODE 
    PLATFORM_HOME_DIR/bin/platform-admin.sh remove-dead-hosts --hosts $CONTROLLER_HOST --skip-confirm
  8. Remove the credentials because the credentials are connected to the previous user.
  9. Add the credentials using the new user, and then add the host.
  10. Perform a Discover and Upgrade for the Controller.
  11. (Optional) If you have installed the Linux services, then:
    1. Logged in as root, uninstall the services:
      CODE 
      HA/uninstall-init.sh
    2. Logged in as root, install the services using either the -c -s
      CODE 
      HA/install-init.sh