PDFs

On this page:

Your Rating:
Results:
PatheticBadOKGoodOutstanding!
45 rates
The Manage Users and Groups topic describes how to manage users in the Controller UI. This topic describes advanced user-management features for on-premises Controllers.  

Modifying User Session Timeout

The Controller logs users out of Controller UI sessions after 60 minutes of inactivity by default. For an on-premises Controller, it's possible to modify the default timeout value, as follows:

  1. As the AppDynamics root user, log in to the Administration Console.

  2. Find and set the values for these properties:

    • http.session.inactive.timeout: The amount of time without a client request to the Controller after which the user session times out and the user will need to log in again to continue. The default is 3600 seconds (60 minutes). 
    • ui.inactivity.timeout: The amount of time without user activity in the Controller UI after which the user session times out and the user will need to log in again to continue. The default is -1 (disabled). 

Setting a System Notification Message

You can have a message appear as a dialog box after a successful login. The user will need to close the dialog box to continue. To set a login message, enter the text as the value of the system.user.notification.message Controller setting in the Administration Console. Clearing the text for the setting suppresses the appearance of the dialog. 

root User and Account Owners

The root user is a built-in Controller user with global administrator privileges in the Controller environment. Only the root user can access the System Administration Console, the web page where you can create and manage accounts in multi-tenant Controllers and configure global Controller settings in both single- or multi-tenant Controllers. 

The root user can be thought of as a superuser for the Controller. Unlike other types of users, you cannot remove the root user account or create other superuser accounts in the Controller. The password for the root user is first set at installation time, but you can change it after installation by following the steps below

While the root user has global administrative privileges, account administrators act as administrators only within individual accounts in a multi-tenant Controller. It's typically the role of the root user to create accounts and an initial administrator for the account, and the role of each account administrator to create additional users within the account.  

For information, see Roles and Permissions and Manage Users and Groups.

Change the Controller root User Password

You can change the root user password from the AppDynamics Administration Console page.

To change the root user password
  1. In a browser, log in to the administration console as described in Access the Administration Console.
  2. Click the gear icon ()  and choose My Settings.
  3. Click Edit > Change Password.
  4. Type the new password for the root user in the New Password and Repeat New Password fields.
  5. Click Save

Logging in to the Administration Console requires you to have the root user password. If you do not have the root user password and need to reset it.

Reset root User Password

If you have lost the AppDynamics root user password for your installation and need to reset it, follow these steps:

  1. From the command line, change to the Controller's bin directory. For example, on Linux:

    cd <controller_home>/bin
  2. Use the following script to log in to the Controller database of the Controller;
    • For Windows: controller.bat login-db
    • For Linux: sh controller.sh login-db
    You should see a MySQL prompt.
  3. At the MySQL prompt, enter the following SQL command to get root user details:

    select * from user where name='root' \G;
  4. Use the following SQL command to change the password: 

    update user set encrypted_password = sha1('<NewPassword>') where name = 'root';

    The hash for the password will be upgraded to PBKDF2 when you log in.

For information on setting the database root user password, see Controller Data and Backups

Change the Glassfish admin User Password

The Controller uses the built-in administrator account in the underlying Glassfish application server. To change the password for this user, you need to change it in two places, in Glassfish and in the password file used by the Controller, as follows.   

To change the Glassfish admin user password
  1. In a browser, log into the Glassfish admin console as the administrator as described in Access the Administration Console.
  2. Click Domain from the navigation tree on the left. 
  3. Open the Administrator Password tab. 
  4. Type and retype the new password in the password fields, and click Save. 
  5. Change the AS_ADMIN_PASSWORD value in the .passwordfile file located in the Controller home directory to match the new password. 

The password change takes immediate effect.

Reset the Database root User Password

If you lose the password for the Controller database, you must stop the App Server and Controller database before you can reset the password.

To reset the database root user password
  1. Open the command line on the machine where the Controller runs. 

  2. Stop the App Server and the database with the following command:  controller.sh/bat stop.

  3. Start the database in insecure mode with the following command:  controller.sh/bat start-db insecure.

    The insecure option starts the database without password requirements. Use this option only to reset the password for the database. The option is similar to starting MySQL with the --skip-grant-tables option.

  4. Log in to the database with the following command:  controller.sh/bat login-db insecure.
  5. Use MySQL to run the following commands:
    1. Specify the Controller database with the following command:  use mysql;
    2. Reload the MySQL grant tables with the following command:  FLUSH PRIVILEGES;
    3. Determine your MySQL version with the following command:  select version();
    4. If you are using MySQL 5.5, configure the new password for the root user with the following command: 
      update mysql.user set password=password('<new-password-here>') where user like 'root%';

      If you are using MySQL 5.7, configure the new password for the root user with the following command: 
      update mysql.user set authentication_string=password('<new-password-here>') where user like 'root%';

    5. Reload the MySQL grant tables with the following command:  FLUSH PRIVILEGES;
    6. Exit MySQL with the following command:  quit

  6. Stop the database with the following command:  controller.sh/bat stop-db.
  7. Start the App Server and Glassfish with the following command:  controller.sh/bat start.

  8. Update the root password for the database in the Database Configurations in the Enterprise Console UI to ensure that the Enterprise Console is aware of the new password.
  • No labels