IBM® Rational® Directory Server can interact with an existing corporate LDAP server, but to use Rational Directory Server, it must be integrated with Rational® Focal Point™. After it is integrated, you can create LDAP-enabled users in Focal Point. Rational Directory Server is not something that you would normally need to leave running in your environment, but is used to configure the corporate partition that allows Focal Point access to your LDAP server for user authentication (examples in this article use the internal IBM BluePages directory).
- Start by accessing the Rational Directory Server Admin GUI by entering the
following URL in your web
http://Server Name:Port Number/webrda/rda
- At the RDS Login window, shown in Figure 1, enter your Rational Directory Server URL, admin ID, and password for authentication.
Figure 1. Rational Directory Server Login window
After successful login, you will be presented with Rational Directory Server Administration Explorer view, shown in Figure 2.
- From the tree view in the navigation pane, on the left, expand the explorer (RDS) so you can see the components.
- Select Configuration and then Corporate Partition.
Figure 2. Rational Directory Server Administration view
- Right-click Corporate Partition, and select Create new > Partition from the drop-down menus.
Figure 3. Creating a new corporate partition
At the next screen, start filling in the partition properties for each tab.
- In the first tab of the properties, labeled General (see Figure 4), enter the information for the company LDAP server (for example Hostname or Port).
By default, the "mail" option does not show in the User Logon Attribute drop-down menu. To enable email as a corporate logon attribute:
- Edit the TDSConfiguration.xml file this
- Add "
/var/IBM/Rational/RDS_5.1is the installable path of your Rational Directory Server:
<!—User Logon Attribute <entry key="CORPORATE_USERLOGON_ATTRIBUTE">CN,UID,sAMAccountName,mail</entry>
- Restart Rational Directory Server.
- Configure the corporate partition (the first panel is filled in for you, see Figure 4, previously), and select mail as the partition logon name.
Figure 4. Partition Properties view - General tab
- Now go to the second tab, Search Base Configuration and enter
the information for your LDAP server in the Primary Search Base, as the example
in Figure 5 shows. Example:
Figure 5. Partition Properties – Search Base Configuration
- Go to the Change Account, the third tab of the partition properties (Figure 6), to enter your LDAP server authenticated user ID and password.
These examples use a fictitious IBM serial number and IBM intranet password.
- For the Admin User DN (distinguished name), replace the
001234 (IBM serial number) with your serial number (567 is
uid=IBM Serial Number & Country Code,c=in,ou=bluepages,o=ibm.com
- Enter your LDAP ID and password (IBM intranet password in this example) into the Password and Confirm Password fields.
- Click OK.
Figure 6. Partition Properties – Change Account
Now you will be able to see the corporate partition that you created (see Figure 7).
Figure 7. Rational Directory Server Explorer with the new partition
- Log in to Rational Focal Point using the Global Admin ID and password.
- Navigate to Users > Rational Directory Server Settings (Figure 8).
Rational Directory Server settings will be visible in your Focal Point environment only if you have enabled them. Please see the Rational Focal Point User guide for how to enable Rational Directory Server (see Resources for a link).
- Fill in the server host name, port number, administrator user name and password, secure connection field and then Save the settings.
By default, Rational Directory Server Secure Connection field will be set to NO.
Figure 8. Rational Directory Server settings
- Now create users in Rational Focal Point, and set the authentication method for them to Rational Directory Server.
- Under Users, click Add Users, and enter information to create new user entry.
Figure 9. Enter information about new user
Figure 10. User properties in Rational Focal Point
Users will now be able to log in to Rational Focal Point using their LDAP user IDs and passwords.
- For more about Focal Point:
- Browse the Rational Focal Point overview page, as well as the developerWorks page, where you'll find data sheets, system requirements, specific benefits, and related articles and white papers.
- Watch the five-minute demo on the IBM Rational Focal Point overview page to know about it more
- Visit Rational Focal Point 6.5 Information Center for the user guide and links to other useful resources. Be sure to read the section titled Authenticating by using Rational Directory Server for how to enable Rational Directory Server.
- Watch these Focal Point demos:
- A 7-minute demo, Project portfolio management using IBM Rational Focal Point, about methods for analyzing and collectively managing a group of current or proposed projects based on numerous key characteristics, including each project's total expected cost, required resources, expected timeline, benefits, and relationship or interdependencies with other projects.
- A 5-minute demo called Developing the right products for the right markets, at the right time to see how Focal Point helps promote successful products by helping your product teams and stakeholders focus on what is most important to your customers and to your business.
- Visit the Rational software area on
developerWorks for technical resources and best practices for other Rational
Software Delivery Platform products.
- Stay current with developerWorks technical events and webcasts focused on a variety of IBM
products and IT industry topics.
- Attend a free developerWorks Live! briefing to get up-to-speed quickly on IBM products and tools, as well as IT industry trends.
- Watch developerWorks on-demand demos, ranging from product installation and setup demos for beginners to advanced functionality for experienced developers.
- Improve your skills. Check the Rational training and
certification catalog, which includes many types of courses on a wide range
of topics. You can take some of them anywhere, any time, and many of the "Getting
Started" ones are free.
Get products and technologies
- Download a free trial
version of Rational software.
- Evaluate other IBM
software in the way that suits you best: Download it for a trial, try it
online, use it in a cloud environment, or spend a few hours in the SOA
Sandbox learning how to implement service-oriented architecture
- Join the Rational
Focal Point forum to ask questions and participate in
- Rate and write a review of Rational Focal Point. It's quick and easy.
- Share your knowledge and help others who use
Rational software by writing a developerWorks article. Find out what makes a good developerWorks article and how to proceed.
- Follow Rational software on Facebook, Twitter (@ibmrational), and
YouTube, and add your
comments and requests.
- Ask and answer questions and increase your
expertise when you get involved in the Rational
forums, cafés, and wikis.
- Connect with others who share your interests by
joining the developerWorks
community and responding to the developer-driven blogs.
- Get social about thought leadership. Join the Rational community to share your
Rational software expertise and get connected with your peers.
Anurag Saraf is a Rational Tools Administrator in the IBM Software Labs in Pune, India. He works with the IBM Systems and Technology group in Rochester, Minnesota, USA, and supports their Rational tools environment, which includes Rational ClearCase, Rational ClearQuest, and Rational Focal Point. He has been with IBM for more than five years and has written for developerWorks previously.