Sun ONE logo     Previous     Contents     Index     Next    
Sun ONE Directory Server Administration Guide

About This Guide

Sun ONE Directory Server 5.2 is a powerful and scalable distributed directory server based on the industry-standard Lightweight Directory Access Protocol (LDAP). Sun ONE Directory Server software is part of the Sun Open Net Environment (Sun ONE), Sun's standards-based software vision, architecture, platform, and expertise for building and deploying Services On Demand.

Sun ONE Directory Server is the cornerstone for building a centralized and distributed data repository that can be used in your intranet, over your extranet with your trading partners, or over the public Internet to reach your customers.

Purpose of This Guide

This Administration Guide describes all of the procedures you need to configure and maintain a directory service based on the Sun ONE Directory Server. It includes the procedures for configuring all Directory Server features from the console and from the command line when appropriate.


This guide describes how to administer the directory server and its contents. However, this manual does not describe many of the basic directory and architectural concepts that you need to successfully design and deploy your directory service. You should be familiar with those concepts, which are covered in the Sun ONE Directory Server Deployment Guide.

When you have done the preliminary planning for your directory deployment, you can configure your system and install the Sun ONE Directory Server. The instructions for installing the various Directory Server components are contained in the Sun ONE Directory Server Installation and Tuning Guide.

Finally, this guide assumes you are familiar with the Directory Server console and the basic commands described in the Sun ONE Directory Server Getting Started Guide. In particular, the command-line procedures rely on the ldapmodify command, and you should understand the LDIF (LDAP data interchange format) input used by this tool. Also, the Sun ONE Server Console Server Management Guide contains general background information on how to use Sun ONE servers.

Typographical Conventions

This section explains the typographical conventions used in this book.

Monospaced font - This typeface is used for literal text, such as the names of attributes and object classes when they appear in text. It is also used for URLs, filenames and examples.

Italic font - This typeface is used for emphasis, for new terms, and for text that you must substitute for actual values, such as placeholders in path names.

The greater-than symbol (>) is used as a separator when naming an item in a menu or sub-menu. For example, Object > New > User means that you should select the User item in the New sub-menu of the Object menu.


Notes, Cautions and Tips highlight important conditions or limitations. Be sure to read this information before continuing.

Default Paths and Filenames

All path and filename examples in the Sun ONE Directory Server product documentation are one of the following two forms:

  • ServerRoot/... - The ServerRoot is the location of the Sun ONE Directory Server product. This path contains the shared binary files of the directory server, the administration server, and LDAP commands.
  • The actual ServerRoot path depends on your platform, your installation, and your configuration. The default path depends on the product platform and packaging as shown in Table 1.

  • ServerRoot/slapd-serverID/... - The serverID is the name of the Directory Server instance that you defined during installation or configuration. This path contains database and configuration files that are specific to the given instance.

  • Note

    Paths specified in this manual use the forward slash format of Unix and commands are specified without file extensions. If you are using a Windows version of Sun ONE Directory Server, use the equivalent backslash format. Executable files on the Windows platforms have the same name with the .exe or .bat extension.

    Table 1    Default ServerRoot Paths

    Product Installation

    ServerRoot Path

    Solaris Packages1

    /var/mps/serverroot - After configuration, this directory contains links to the following locations:

    • /etc/ds/v5.2 (static configuration files)
    • /usr/admserv/mps/admin (Sun ONE Administration Server binaries)
    • /usr/admserv/mps/console (Server Console binaries)
    • /usr/ds/v5.2 (Directory Server binaries)

    Compressed Archive Installation on Solaris and Other Unix Systems


    Zip Installation on Windows Systems

    C:\Program Files\Sun\MPS

    1If you are working on the Solaris Operating Environment and are unsure which version of the Sun ONE Directory Server software is installed, check for the existence a key package such as SUNWdsvu using the pkginfo command. For example: pkginfo | grep SUNWdsvu.

Directory Server instances are located under ServerRoot/slapd-serverID/, where serverID represents the server identifier given to the instance on creation. For example, if you gave the name dirserv to your Directory Server, then the actual path would appear as shown in Table 2. If you have created a Directory Server instance in a different location, adapt the path accordingly.

Table 2    Example dirserv Instance Locations

Product Installation

Instance Location

Solaris Packages


Compressed Archive Installation on Solaris and Other Unix Systems


Zip Installation on Windows Systems

C:\Program Files\Sun\MPS\slapd-dirserv

Downloading Directory Server Tools

Some supported platforms provide native tools for accessing Directory Server. More tools for testing and maintaining LDAP directory servers, download the Sun ONE Directory Server Resource Kit (DSRK). This software is available at the following location:

Installation instructions and reference documentation for the DSRK tools is available in the Sun ONE Directory Server Resource Kit Tools Reference.

For developing directory client applications, you may also download the Sun ONE LDAP SDK for C and the Sun ONE LDAP SDK for Java from the same location.

Additionally, Java Naming and Directory Interface (JNDI) technology supports accessing the Directory Server using LDAP and DSML v2 from Java applications. Information about JNDI is available from:

The JNDI Tutorial contains detailed descriptions and examples of how to use JNDI. It is available at:

Suggested Reading

Sun ONE Directory Server product documentation includes the following documents delivered in both HTML and PDF:

Other useful information can be found on the following Web sites:

Previous     Contents     Index     Next    
Copyright 2003 Sun Microsystems, Inc. All rights reserved.