Change the Controller Owner

This page provides instructions for changing the Controller owner.

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.

In order to change the owner of the Controller, complete the following steps.

  1. Stop all running Controller services using the following command in the machine terminal.
    • ./controller.sh stop
  2. Change the username and user group of the Controller directory.
    • chown -R <New User>:<User Group> <Controller Folder>
  3. Update the new user in the db.cnf file located at Controller/db/db.cnf .
    • user=<New User>
  4. Start the Controller.
    • ./controller.sh start

If you are not using the Enterprise Console

  1. As the current user running the Controller services, shut down the Controller process:
    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 user:group
    chown -R appdynamics:admin CONTROLLER_HOME_DIR/
  3. If the Controller's data directory is outside of the root
    chown -R appdynamics:admin .../data/
  4. Change the user to the new username:
    CONTROLLER_HOME_DIR/db/db.cnf
  5. Log in as the new user and start the Controller services:
    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:
    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.
    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 user:group
    chown -R appdynamics:admin CONTROLLER_HOME_DIR/
  4. If the Controller's data directory is outside of the root
    chown -R appdynamics:admin .../data/
  5. Change the user to the new username:
    CONTROLLER_HOME_DIR/db/db.cnf
  6. Log in as the new user and start the Controller services:
    CONTROLLER_HOME_DIR/bin/controller.sh start
  7. From the Enterprise Console, remove the hosts that were added:
    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:
      HA/uninstall-init.sh
    2. Logged in as root, install the services using either the -c -s
      HA/install-init.sh