Red Hat Training

A Red Hat training course is available for Red Hat Fuse

7.2. Set-up a Directory Server and Browser

Overview

In this stage of the tutorial you will install an X.500 directory server and browser client from the Apache Directory project. These applications will be used throughout the rest of this tutorial.

Procedure

To set-up the directory server and browser:
  1. Download Apache Directory Server from http://directory.apache.org/apacheds/1.5/downloads.html.
  2. Run the downloaded installer.
    Important
    During the installation process, you will be asked whether or not to install a default instance of the directory server. Choose the default instance.
  3. Start the directory service as described in the section called “Starting Apache Directory Server”.
  4. Install Apache Directory Studio as described in the section called “Install Apache Directory Studio”.
  5. Start Apache Directory Studio.
    • If you installed the standalone version of Apache Directory Studio, double-click the relevant icon to launch the application.
    • If you installed Apache Directory Studio into an existing Eclipse IDE:
      1. Start Eclipse.
      2. Select Window → Open Perspective → Other.
      3. In the Open Perspective dialog, select LDAP.
      4. Click OK.
  6. Connect the browser to the server as described in the section called “Connecting the browser to the server”.

Starting Apache Directory Server

If you install Apache Directory Server on Windows, the default instance of the directory server is configured as a Windows service. Hence, you can stop and start the directory server using the standard Services administrative tool.
If you install on a Linux or Mac OS platform, follow the instructions in Installing and Starting the Server for starting and stopping the directory server.

Install Apache Directory Studio

The Apache Directory Studio is an Eclipse-based suite of tools for administering an X.500 directory server. In particular, for this tutorial, you need the LDAP Browser feature, which enables you to create new entries in the Directory Information Tree (DIT).
There are two alternative ways of installing Apache Directory Studio:
  • Standalone application—download the standalone distribution from the Directory Studio downloads page and follow the installation instructions from the Apache Directory Studio User Guide.
  • Eclipse plug-in—if you already use Eclipse as your development environment, you can install Apache Directory Studio as a set of Eclipse plug-ins. The only piece of Apache Directory Studio that you need for this tutorial is the LDAP Browser plug-in.
    To install the LDAP Browser as an Eclipse plug-in, follow the install instructions from the LDAP Browser Plug-In User Guide.

Connecting the browser to the server

To connect the LDAP browser to the LDAP server:
  1. Right-click inside the Connections view.
  2. Select New Connection....
    The New LDAP Connection wizard opens.
  3. In the Connection name field, enter Apache Directory Server.
  4. In the Hostname field enter localhost.
  5. In the Port field, enter 10389.

    Figure 7.1. New LDAP Connection Wizard

    LDAP connection wizard
  6. Click Next.
  7. In the Bind DN or user field, enter uid=admin,ou=system).
  8. In the Bind password field, enter secret).

    Figure 7.2. Authentication Step of New LDAP Connection

    form for adding LDAP connection information
  9. Click Finish.
If the connection is successfully established, you should see an outline of the Directory Information Tree (DIT) in the LDAP Browser view.