Sun Java logo     Previous      Contents      Index      Next     

Sun logo
Sun Java(TM) System Directory Server 5 2004Q2 Installation and Migration Guide 


The Directory Server Installation and Migration Guide contains the information you need in order to find installation instructions, to update and upgrade existing Directory Server installations, to migrate data from an existing Directory Server instance to an current instance, and to use Directory Server in a Sun Cluster environment.

This preface contains the following sections:

Before performing any of the tasks described in this guide, read the Directory Server Release Notes. For complex deployments, also read the Directory Server Deployment Planning Guide.

Who Should Read This Guide

This guide is intended for anyone installing, updating, or upgrading Directory Server.

The author of this guide assumes you are familiar with the following:

How This Guide Is Organized

This guide is divided into these parts:

Using the Documentation

The Directory Server manuals are available as online files in Portable Document Format (PDF) and Hypertext Markup Language (HTML) formats. Both formats are readable by assistive technologies for users with disabilities. The Sun™ documentation web site can be accessed here:

The Directory Server documentation set can be accessed here:

Table 1 briefly describes each document in the set. The left column provides the name and Web location of each document. The right column describes the general contents of the document.

Table 1  Directory Server Documentation 



Directory Server Release Notes

Contains the latest information about Directory Server, including known problems.

Directory Server Technical Overview

Provides a quick look at many key features of Directory Server.

Directory Server Deployment Planning Guide

Explains how to plan directory topology, data structure, security, and monitoring, and discusses example deployments.

Directory Server Installation and Migration Guide

Covers update, upgrade, and data migration procedures for moving to the latest version of Directory Server.

Directory Server Performance Tuning Guide

Provides tips and explanations you can use to optimize Directory Server performance.

Directory Server Administration Guide

Gives the procedures for using the console and command-line to manage your directory contents and configure every feature of Directory Server.

Directory Server Administration Reference

Details the Directory Server configuration parameters, commands, files, error messages, and schema.

Directory Server Plug-In Developer’s Guide

Demonstrates how to develop Directory Server plug-ins.

Directory Server Plug-In Developer’s Reference

Details the data structures and functions of the Directory Server plug-in API.


Table 2 describes the typeface conventions used in this guide.

Table 2  Typeface Conventions 






API and language elements, HTML tags, web site URLs, command names, file names, directory path names, on-screen computer output, sample code.

Edit your .login file.

Use ls -a to list all files.

% You have mail.


(Monospace bold)

What you type, as contrasted with on-screen computer output.

% su




Book titles.

New words or terms.

Words to be emphasized.

Command-line variables to be replaced by real names or values.

Read Chapter 6 in the Developer’s Guide.

These are called class options.

You must be superuser to do this.

The file is located in the ServerRoot directory.

Table 3 describes placeholder conventions used in this guide.

Table 3  Placeholder Conventions 





Placeholder for the directory prefix under which software binaries reside after installation.

The default install-dir prefix on Solaris systems is /.

The default install-dir prefix on Red Hat systems is /opt/sun.


Placeholder for the directory where server instances and data reside.

You can manage each server under a ServerRoot remotely through your client-side Server Console. The Server Console uses the server-side Administration Server to perform tasks that must execute directly on the server-side system.

The default ServerRoot directory is /var/opt/mps/serverroot.


Placeholder for the directory where a specific server instance resides under the ServerRoot and its associated data resides by default.

The default serverID is the host name.

Table 4 describes the symbol conventions used in this book.

Table 4  Symbol Conventions 





[ ]

Contain optional command options.


�O4, �O

{ }


Contain a set of choices for a required command option.

Separates command option choices.




Joins simultaneous keystrokes in keyboard shortcuts that are used in a graphical user interface.




Joins consecutive keystrokes in keyboard shortcuts that are used in a graphical user interface.




Indicates menu selection in a graphical user interface.


File > New

File > New > Templates

Table 5 describes the shell prompt conventions used in this book.

Table 5  Shell Prompts



C shell


C shell superuser


Bourne shell and Korn shell


Bourne shell and Korn shell superuser


Input and output of Directory Server commands are usually expressed using the Lightweight Data Interchange Format (LDIF) [RFC 2849] . Lines are wrapped for readability.

Resources and Tools on the Web

The following location contains information about Java Enterprise System and its component products such as Directory Server:

Some supported platforms provide native tools for accessing Directory Server. For more tools useful when testing and maintaining LDAP directory servers, download the Sun Java System 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 Directory Server Resource Kit Tools Reference.

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

Additionally, Java Naming and Directory Interface (JNDI) technology supports accessing 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:

Third-party URLs are included in this document to provide additional, related information.


Sun is not responsible for the availability of third-party Web sites mentioned in this document. Sun does not endorse and is not responsible or liable for any content, advertising, products, or other materials that are available on or through such sites or resources. Sun will not be responsible or liable for any actual or alleged damage or loss caused by or in connection with the use of or reliance on any such content, goods, or services that are available on or through such sites or resources.

How to Report Problems

If you have problems with Directory Server, contact Sun customer support using one of the following mechanisms:

So that we can best assist you in resolving problems, please have the following information available when you contact support:

Sun Welcomes Your Comments

Sun is interested in improving its documentation and welcomes your comments and suggestions. Use the web-based form to provide feedback to Sun:

Please provide the full document title and part number in the appropriate fields. The part number is a seven-digit or nine-digit number that can be found on the title page of the book or at the top of the document. For example, the part number of this Installation and Migration Guide is 817-5219-10.

Previous      Contents      Index      Next     

Copyright 2004 Sun Microsystems, Inc. All rights reserved.