Configure the custom ID attribute for users or groups 

Configure IBM Connections to use custom ID attributes to identify users and groups in the LDAP directory.

Before you begin

About this task

You can change the default setting to use a custom ID to identify users and groups in the directory.

To configure IBM Connections to use the custom ID attribute that you specified earlier...


  1. Add the new attribute to the LotusConnections-config.xml file. To do so...

    1. Start the wsadmin tool.

    2. Access the IBM Connections configuration file:


        If you are prompted to specify which server to connect to, enter 1. This information is not used by the wsadmin client when you are making configuration changes.

    3. Check out the IBM Connections configuration files using the following command: LCConfigService.checkOutConfig("/<working_directory>", "<cell_name>")


        • <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied. The files are kept in this working directory while you change them.

        • <cell_name> is the name of the IBM WAS cell hosting the IBM Connections application. This argument is case sensitive. If you do not know the cell name, you can determine it by entering the following command in the wsadmin command processor:

            print AdminControl.getCell()

        For example:


    4. From the temporary directory to which you checked out the IBM Connections configuration files, open the LotusConnections-config.xml file in a text editor.

    5. Add the new custom properties to the LotusConnections-config.xml file. For example:

        <sloc:serviceReference serviceName="directory"

    6. Save the LotusConnections-config.xml file.

    7. Check in the changed configuration property files using the following command:LCConfigService.checkInConfig()

    8. After making updates, enter the following command to deploy the changes: synchAllNodes()

  2. Stop and restart the WAS instance hosting IBM Connections.

Parent topic

Optional post-installation tasks

Related tasks

Specify a custom ID attribute for users or groups