Enabling LDAP authentication for clusters that run in secure mode

Last published : Sep 11, 2026
The following procedure shows how to enable the plug-in module for LDAP authentication. This section provides examples for OpenLDAP and Windows Active Directory LDAP distributions.
Before you enable the LDAP authentication, complete the following steps:
  • Make sure that the cluster runs in secure mode.
    \# haclus -value SecureClus
    The output must return the value as 1.
    • Make sure that the AT version is 6.1.6.0 or later.
    \# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/vssat showversion
    vssat version: 6.1.12.8
To enable OpenLDAP authentication for clusters that run in secure mode
  1. Run the LDAP configuration tool atldapconf using the -d option. The -d option discovers and retrieves an LDAP properties file which is a prioritized attribute list.
    \# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/atldapconf \
    -d -s domain_controller_name_or_ipaddress -u domain_user
    Attribute list file name not provided, using AttributeList.txt
Attribute file created.
You can use the cat``atldapconf command to view the entries in the attributes file.
  1. Run the LDAP configuration tool using the -c option. The -c option creates a CLI file to add the LDAP domain.
    \# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/atldapconf \
    -c -d LDAP_domain_name
    Attribute list file not provided, using default AttributeList.txt
CLI file name not provided, using default CLI.txtCLI for addldapdomain generated.
  1. Run the LDAP configuration tool atldapconf using the -x option. The -x option reads the CLI file and executes the commands to add a domain to the AT.
    \# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/atldapconf -xUsing default broker port 14149
CLI file not provided, using default CLI.txtLooking for AT installation...AT found installed at ./vssatSuccessfully added LDAP domain.
  1. Check the AT version and list the LDAP domains to verify that the Windows Active Directory server integration is complete.
    \# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/vssat showversionvssat version: 6.1.12.8
\# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/vssat listldapdomainsDomain Name : mydomain.comServer URL : ldap://192.168.20.32:389SSL Enabled : NoUser Base DN : CN=people,DC=mydomain,DC=comUser Object Class : accountUser Attribute : cnUser GID Attribute : gidNumberGroup Base DN : CN=group,DC=domain,DC=comGroup Object Class : groupGroup Attribute : cnGroup GID Attribute : cnAuth Type : FLATAdmin User :Admin User Password :Search Scope : SUB
  1. Check the other domains in the cluster.
    \# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/vssat showdomains -p vx
    The command output lists the number of domains that are found, with the domain names and domain types.
    1. Generate credentials for the user.
    \# unset EAT_LOG
\# /opt/VRTSvcs/bin/vcsauth/vcsauthserver/bin/vssat authenticate \
-d ldap:LDAP_domain_name -p user_name -s user_password -b \
localhost:14149
  1. Add non-root users as applicable.
    \# useradd user1\# passwd pw1
Changing password for "user1"user1's New password:Re-enter user1's new password:\# su user1\# bash\# iduid=204(user1) gid=1(staff)\# pwd\# mkdir /home/user1\# chown user1 /home/ user1
  1. Add the non-root user to the VCS configuration.
    \# haconf -makerw
    \# hauser -add user1
    \# haconf -dump -makero
    1. Log in as non-root user and run VCS commands as LDAP user.
    \# cd /home/user1
\# ls\# cat .vcspwd101 localhost mpise LDAP_SERVER ldap\# unset VCS_DOMAINTYPE\# unset VCS_DOMAIN\# /opt/VRTSvcs/bin/hasys -state\#System        Attribute          Valuecluster1:sysA     SysState           FAULTEDcluster1:sysB     SysState           FAULTEDcluster2:sysC     SysState           RUNNINGcluster2:sysD     SysState           RUNNING