IBM Support

How to verify LDAP parameters for Jazz Team server configuration

Question & Answer


Question

How can you tell if the given LDAP parameters are accurate to complete the IBM Rational Jazz Team Server (JTS) LDAP configuration?

Cause

The Jazz Team Server relies on the user registry to provide basic information about users and groups. When configuring the Jazz Team server to use a LDAP server to act as the user registry, you will be asked to provide a list of parameters (properties) such as Base User DN, Base Group DN, Group Name property and Group Member property, to complete the setup.

Usually you will collect these parameters from your LDAP Administrator. In the case that you are not sure if the value of these given parameters are accurate, or you are getting errors/warnings indicating some of the value is incorrect during the setup, you can use a third party LDAP browser to verify their accuracy.

Answer

This technote is based on third party software named: Softerra LDAP Browser. You can always choose a different LDAP browser to achieve the same results.

Alternative LDAP browsers which you can use:



Disclaimer

IBM is not providing program services of any kind for this program. Making use of the Information provided in this technote is done at the user's own risk.

  1. Download, install and launch Softerra LDAP Browser. You can download it from the following site download page.

  2. Create a profile for your LDAP server to verify LDAP Registry Location, User Name, Password, Base User DN. To create the profile follow follow the instruction under the help menu of Softerra. Input the above parameters in the profile creation wizard accordingly as the following:
    • Host: Extract the host name from LDAP Registry Location parameter, for example: ldapserver.mycompany.com

    • Port: Extract the port number from LDAP Registry Location parameter, for example 389

    • Base DN: key in the value of the Base User DN parameter

    • User DN: User Name

    • Password: Password


      Save the profile and connect to your LDAP server by double clicking on the profile. If you can connect, that means the value of the above giving LDAP parameters are accurate. Otherwise, base on the errors you get, contact your LDAP Administrator to follow up.

  3. Verify value of the User Property Names Mapping property. The default value for this property is: userId=uid,name=cn,emailAddress=mail. That assumes your LDAP user record has the attributes of uid, cn and mail representing userID, common name and emailAddress. To verify these attributes exist in your LDAP user record, follow the steps below to search for your own LDAP ID, then examine all the attributes there to ensure the above given attributes exist.
    1. click on Tools > Directory Search from Softerra LDAP browser.

    2. Type in the value of the Base User DN property into the Search DN box.

    3. Replace: (objectclass=*) with (cn=your common name) in the Filter box and click on Search button. It should find your LDAP user record, double click to open it, and you should see all the attributes within the record. Verify the above attributes exist.






  4. Verify the value of the Base Group DN property. To verify the value of the Base Group DN property, follow the steps below to search for your LDAP group that is mapped to any of the Jazz role:
    1. Click on Tools > Directory Search from Softerra LDAP browser.

    2. Type in the value of Base Group DN in the Search DN box

    3. Replace (objectclass=*) with (cn=your ldap group) in the Filter box

    4. If the group can be found, that means the Base Group DN has correct value


  5. Verify the value of the Group Name property. The default value of Group Name is cn. That assumes your LDAP group record has an attribute named cn represent the name of the group. To verify this attribute exist, follow the steps in step 4 above to search for your LDAP group, open it to verify the cn attribute exists.



  6. Verify Group Member property. The default value of Group Member property is members. That assumes your LDAP group record has an attribute named members representing member of the group. To verify this attribute exist, follow the steps in session C above to search for your LDAP group, open it to verify the members attribute exist.




Leverage the Jazz Community

The Jazz based products have an active community that can provide you with additional resources. Browse and contribute to the User forums, contribute to the Team Blog and review the Team wiki.
Refer to technote 1319600 for details and links.

[{"Product":{"code":"SSUVV6","label":"IBM Engineering Test Management"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Team Server","Platform":[{"code":"PF002","label":"AIX"}],"Version":"1.0;1.0.1;2.0;2.0.1;3.0.1;3.0.1.1;3.0.1.2;3.0.1.3;3.0.1.4;3.0.1.5;3.0.1.6;4.0;4.0.0.1;4.0.0.2;4.0.1;4.0.2;4.0.3;4.0.4;4.0.5;4.0.6;4.0.7;5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSUC3U","label":"IBM Engineering Workflow Management"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":"Team Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"PF016","label":"Linux"},{"code":"PF027","label":"Solaris"},{"code":"PF033","label":"Windows"}],"Version":"2.0;2.0.0.1;2.0.0.2;3.0;3.0.1;3.0.1.1;3.0.1.2;3.0.1.3;3.0.1.4;3.0.1.5;3.0.1.6;4.0;4.0.0.1;4.0.0.2;4.0.1;4.0.2;4.0.3;4.0.4;4.0.5;4.0.6;4.0.7;5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSUVLZ","label":"IBM Engineering Requirements Management DOORS Next"},"Business Unit":{"code":"BU055","label":"Cognitive Applications"},"Component":" ","Platform":[{"code":"PF016","label":"Linux"},{"code":"PF033","label":"Windows"}],"Version":"5.0;5.0.1;5.0.2","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}},{"Product":{"code":"SSN2WR","label":"Rational Project Conductor"},"Business Unit":{"code":"BU053","label":"Cloud & Data Platform"},"Component":"Team Server","Platform":[{"code":"PF002","label":"AIX"},{"code":"","label":" Linux"},{"code":"","label":" Solaris"},{"code":"","label":" Windows"}],"Version":"1.0","Edition":"","Line of Business":{"code":"LOB36","label":"IBM Automation"}},{"Product":{"code":"SSWMEQ","label":"Rational Requirements Composer"},"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Component":"Team Server","Platform":[{"code":"","label":""}],"Version":"1.0;2.0;3.0.1;3.0.1.1;3.0.1.2;3.0.1.3;3.0.1.4;3.0.1.5;3.0.1.6;4.0;4.0.0.1;4.0.0.2;4.0.1;4.0.2;4.0.3;4.0.4;4.0.5;4.0.6;4.0.7","Edition":"","Line of Business":{"code":"LOB59","label":"Sustainability Software"}}]

Product Synonym

Rational DOORS Next Generation;Rational Team Concert;Rational Quality Manager

Document Information

Modified date:
16 June 2018

UID

swg21445366