IBM Performance Management

Changing the default apmadmin user

The default user for Performance Management is apmadmin, and the default realm is customRealm. By default apmadmin is a member of the Role Administrator role.

About this task

This default user is defined in the basicRegistry.xml file in the install_dir/wlp/usr/shared/config/ folder. You might need to change the default user for one of the following reasons:
  • You are changing user authentication from basic registry to LDAP, or you are switching to a different LDAP registry.
  • You want to use a different user who is defined in the user registry.
  • You want to use a different realm name in the user registry.

Procedure

  1. Navigate to the install_dir/wlp/usr/servers/server1/cscs/conf directory . Create a file called cscsRoleAdmin.new. Do not edit or remove the cscsRoleAdmin.conf file directly. Any change should be done by creating a cscsRoleAdmin.new file.
  2. Add a new default user to cscsRoleAdmin.new using syntax similar to the following (contact your LDAP administrator for the exact syntax): 
    user:SampleLdapADRealm/CN=testuser,CN=users,dc=adtest,dc=mycity,dc=mycompany,dc=com
    Note: This syntax is case-sensitive, see 5.
    Where
    user is a prefix.
    SampleLdapADRealm is the realm specified in the registry configuration file (basicRegistry.xml or ldapRegistry.xml).
    testuser is the user that is replacing apmadmin, it might be the LDAP administrator account or it might be any user account from your user directory.
  3. Save the cscsRoleAdmin.new file.
  4. Restart the Performance Management server by using the following command in the /user/bin/ directory: 
    apm restart_all
  5. To verify that you have successfully changed the default apmadmin account, attempt to log in with your new Role Administrator user account.
    • If you can log in successfully, you have successfully changed the default apmadmin account.
    • If you receive the following message:
      You do not have permission to view this application. If you require access to the application, please send
 the URL that you are attempting to access to your monitoring system administrator
      You might need to revert to the apmadmin user and/or troubleshoot changing the apmadmin user, see Troubleshooting changing the default apmadmin user.

Results

The Performance Management integration with your LDAP server is now complete.