Updated on 2026-10-21 GMT+08:00

Changing the Password for a Regular LDAP User of an MRS Cluster

Periodically changing LDAP user passwords improves system security during MRS cluster O&M. If an LDAP administrator or regular user password has been used for a long time or must be changed for security compliance, change it on MRS Manager. This section describes how to change passwords for LDAP administrators and regular LDAP users.

Involved LDAP users:

  • Usernames in MRS 3.1.0:
    • LDAP administrators: cn=root, dc=hadoop, dc=com
    • LDAP users: cn=pg_search_dn, ou=Users, dc=hadoop, dc=com
  • Usernames in MRS 2.x or earlier:
    • LDAP administrators: rootdn:cn=root, dc=hadoop, dc=com
    • LDAP users: pg_search_dn:cn=pg_search_dn, ou=Users, dc=hadoop, dc=com

Notes and Constraints

  • This section applies only to MRS 2.x or earlier and MRS 3.1.0. For versions later than MRS 3.1.0, refer to Modifying the OMS Service Configuration.
  • For MRS 3.1.0 clusters:
    • Changing these user passwords will also update the corresponding OMS LDAP administrator or user passwords.
    • If the cluster is upgraded from an earlier version, the LDAP administrator passwords will retain the password policy of the original cluster. To ensure system security, change the passwords after the upgrade.

Impact on the System

  • For MRS 2.x or earlier, all services need to be restarted after passwords are changed, during which the services are unavailable.
  • For MRS 3.1.0 clusters:
    • Changing the user password of the LdapServer service is a high-risk operation and requires restarting the KrbServer and LdapServer services. If KrbServer is restarted, users may fail to be queried by running the id command on nodes in the cluster temporarily. Therefore, exercise caution when restarting KrbServer.
    • After the passwords for LDAP users cn=pg_search_dn, ou=Users, dc=hadoop, and dc=com are changed, the users may be locked in the LDAP component. You are advised to unlock them after password change. For details, see Unlocking the LDAP Management Account of the MRS Cluster.

Prerequisites (MRS 3.1.0)

Before changing the password for the LDAP user cn=pg_search_dn,ou=Users,dc=hadoop,dc=com, ensure that the account is not locked. Run the following command on the active management node:

ldapsearch -H ldaps://Floating IP address of OMS:OLDAP port-LLL -x -D cn=pg_search_dn,ou=Users,dc=hadoop,dc=com -W -b cn=pg_search_dn,ou=Users,dc=hadoop,dc=com -e ppolicy

Enter the password for the LDAP user pg_search_dn. If the following information is displayed, the user is locked. In this case, unlock the user by referring to Unlocking the LDAP Management Account of the MRS Cluster.

ldap_bind: Invalid credentials (49); Account locked
  • To obtain the OLDAP port, log in to FusionInsight Manager, choose System > OMS > oldap > Modify Configuration, and view the value of LDAP Listening Port.
  • The password for the LDAP user pg_search_dn is randomly generated by the system, which can be obtained from the /etc/sssd/sssd.conf or /etc/ldap.conf file on the active node.

Changing the Password for a Regular LDAP User of an MRS Cluster

For MRS 3.1.0:

  1. Log in to FusionInsight Manager of the MRS cluster.

    For details about how to log in to FusionInsight Manager, see Accessing MRS Manager.

  2. Choose Cluster > Services > LdapServer.
  3. In the upper right corner of the Overview page, choose More > Change Database Password. In the displayed dialog box, enter the password of the current login user and click OK.
  4. In the Change Password dialog box, select the user whose password needs to be changed in the User Information drop-down list.
  5. Enter the old password in the Old Password text box, and enter the new password in the New Password and Confirm Password text boxes.

    The default password complexity requirements are as follows:

    • The password must contain 16 to 32 characters.
    • The password contains at least three types of the following: uppercase letters, lowercase letters, numbers, and special characters (`~!@#$%^&*()-_=+|[{}];,<.>/?).
    • The password cannot be the same as the username or the username spelled backwards.
    • The password cannot be the same as the current password.

  6. Select I have read the information and understood the impact and click OK to confirm the modification and restart the service.

For MRS 2.x or earlier:

  1. Log in to FusionInsight Manager of the MRS cluster.

    For details about how to log in to FusionInsight Manager, see Accessing MRS Manager.

  2. Choose Services > LdapServer > More.
  3. Click Change Password. In the displayed dialog box, enter the old password and click OK.
  4. In the Change Password dialog box, select the user whose password needs to be modified in the User Information drop-down box.
  5. Enter the old password in the Old Password text box, and enter the new password in the New Password and Confirm Password text boxes.

    The default password complexity requirements are as follows:

    • The password contains 16 to 32 characters.
    • The password must contain at least three types of the following: uppercase letters, lowercase letters, digits, and special characters (`~!@#$%^&*()-_=+\|[{}];:",<.>/?).
    • The password cannot be the username or the reverse username.
    • The new password cannot be the same as the current password.

    The default password of the LDAP administrator rootdn:cn=root,dc=hadoop,dc=com is LdapChangeMe@123, and that of the LDAP user pg_search_dn:cn=pg_search_dn,ou=Users,dc=hadoop,dc=com is pg_search_dn@123. Periodically change the passwords and keep them secure.

  6. Select I have read the information and understand the impact, and click OK to confirm the modification and restart the service.

Verifying the password change result:

  • After restarting the service, log in to MRS Manager and verify that it is accessible.
  • Run the ldapsearch command on the active management node using the new password to verify that the LDAP user can be authenticated.

FAQs

  • What should I do if cluster services fail after the LDAP password is changed?

    After the password is changed, the service restarts automatically. Temporary service unavailability during restart is expected. Wait until the service restarts, and then verify its status. If the service remains abnormal for an extended period, verify that the new password meets complexity requirements and that the pg_search_dn user is unlocked.

  • How do I retrieve the current password for LDAP user pg_search_dn?

    The password for the LDAP user pg_search_dn is generated randomly by the system. You can retrieve it from the /etc/sssd/sssd.conf or /etc/ldap.conf file on the active node. To obtain the OLDAP port, log in to MRS Manager, choose System > OMS > oldap > Modify Configuration, and view the value of LDAP Listening Port.

Helpful Links