Configure a binding user ID for Collaborative Services

The bind user ID is used by Lotus Collaborative Services to retrieve user attributes required for authentication from the selected LDAP directory. Setting the bind user ID to use the LDAP server for Collaborative Services supports automatic detection of users' mail files for any of the collaborative portlets that use a Lotus Domino back-end server for messaging (Lotus Notes View and Domino Web Access). If the server is a Lotus Domino LDAP, setting the bind user also supports the server or database drop-down lists that appear in Lotus Domino portlets.

Wait! The Domino-WebSphere Portal Integration Wizard can set up the bind user for you.

Before you set up the bind user, the WebSphere Portal server must be configured to recognize Collaborative Services (a previous task in this sequence).

If you choose not to configure Collaborative Services to bind to the Lotus Domino LDAP, you can, instead, enable access to certain Lotus Domino fields by anonymous users. For information on setting the HTTP-HostName and HTTP-Port fields as queriable fields in the Configuration Settings document on the Lotus Domino LDAP server, see the topic on setting a Domino LDAP server to allow anonymous access.

To set the bind user, edit the CSEnvironment.properties file.

Perform the following steps:

1. Use the following commands to stop WebSphere Portal:

   1. Open a command prompt and change to the following directory:

      • Windows: profile_root\bin

      • UNIX: profile_root/bin

      • i5/OS: profile_root/bin

   2. Enter the following command to stop the WebSphere_Portal server, where WebSphere_Portal is the name of the WebSphere Portal server:

      • Windows: stopServer.bat WebSphere_Portal -username admin_userid -password admin_password

      • UNIX: ./stopServer.sh WebSphere_Portal -username admin_userid -password admin_password

      • i5/OS: stopServer WebSphere_Portal -username admin_userid -password admin_password

   where profile_root is the name of the WAS profile where WebSphere Portal is installed; for example wp_profile.

   The default name of the appserver is the profile name.

2. Locate the CSEnvironment.properties file in the following directory:

   Windows:

   profile_root\PortalServer\config\config
   

   UNIX:

   profile_root/PortalServer/config/config
   

   i5/OS:

   profile_root/PortalServer/config/config
   

3. Open the file in a text editor.

   Make a backup copy of the file before making changes.

4. Locate the following section in the file:

   # Add Default IIOP/SSL Port
   

5. Under the heading in the previous step, remove the comment tag (#) from the beginning of the line that contains CS_SERVER_DOMINO_DIRECTORY_1.userid=.

6. At the end of the line, add a user ID that has appropriate access in the LDAP directory that supports Collaborative Services. Type the Lotus Domino LDAP fully qualified (for example, cn=domino admin,ou=orgunit,o=org) name for the user.

   On a Lotus Domino LDAP server, this user ID must have at least reader access to the address book names.nsf file.

   For a non-Lotus Domino LDAP directory, ask the LDAP administrator to provide a user with appropriate access to search the mailserver, mailfile, http-hostname, and http-port attributes.

7. Go to the line that contains CS_SERVER_DOMINO_DIRECTORY_1.encryptedpwd=.

8. Remove the comment tag (#) from the beginning of this line.

9. Copy the line that contains CS_SERVER_DOMINO_DIRECTORY_1.encryptedpwd= and paste it into a new file.

10. In the new file, at the end of the line, add the internet password for the user ID (that was entered for CS_SERVER_DOMINO_DIRECTORY_1.userid=).

11. Save this new file as dominobind.txt in the AppServer_root directory.

12. Open a command prompt to the AppServer_root/bin directory.

13. In the same directory, run the following command (type as one line with a space character separating it):

    PropFilePasswordEncoder dominobind.txt 
    CS_SERVER_DOMINO_DIRECTORY_1.encryptedpwd
    

14. In the same directory, open the dominobind.txt file, and copy the encrypted password after CS_SERVER_DOMINO_DIRECTORY_1.encryptedpwd=.

15. Go back to the CSEnvironment.properties file.

16. Paste the encrypted password after CS_SERVER_DOMINO_DIRECTORY_1.encryptedpwd=.

17. Save and close the CSEnvironment.properties file.

18. Close the dominobind.txt file, and then delete dominobind.txt and dominobind.txt.bak from the AppServer_root/bin directory.

19. Use the following commands to start WebSphere Portal:

    1. Open a command prompt and change to the following directory:

       • Windows: profile_root\bin

       • UNIX: profile_root/bin

       • i5/OS: profile_root/bin

    2. Enter the following command to start the WebSphere_Portal server:

       • Windows: startServer.bat WebSphere_Portal

       • UNIX: ./startServer.sh WebSphere_Portal

       • i5/OS: startServer WebSphere_Portal -profileName profile_root

Parent topic:

Giving Collaboratives Services access to required fields for automatic mail detection

---