Sun Java(TM) System Directory Server 5 2004Q2 Installation and Migration Guide |
Preface
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 GuideThis 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 OrganizedThis guide is divided into these parts:
Indicates where to find the latest installation instructions.
Helps you determine whether to update or upgrade Directory Server from previous versions.
Describes how to perform an update, which does not involve data migration.
Describes how to perform an upgrade, which does involve data migration.
Shows how to upgrade an entire 4.x topology of Directory Server instances.
Shows how to upgrade an entire 5.x topology of Directory Server instances.
Describes how to install and configure both the Sun Cluster HA for Directory Server data service and the associated Administration Server data service.
Using the DocumentationThe 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:
http://docs.sun.com/coll/DirectoryServer_04q2
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.
ConventionsTable 2 describes the typeface conventions used in this guide.
Table 3 describes placeholder conventions used in this guide.
Table 4 describes the symbol conventions used in this book.
Table 5 describes the shell prompt conventions used in this book.
Table 5 Shell Prompts
Shell
Prompt
C shell
machine-name%
C shell superuser
machine-name#
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 WebThe following location contains information about Java Enterprise System and its component products such as Directory Server:
http://wwws.sun.com/software/learnabout/enterprisesystem/index.html
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:
http://wwws.sun.com/software/download/
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:
http://java.sun.com/products/jndi/
The JNDI Tutorial contains detailed descriptions and examples of how to use JNDI. It is available at:
http://java.sun.com/products/jndi/tutorial/
Third-party URLs are included in this document to provide additional, related information.
How to Report ProblemsIf 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:
- Description of the problem, including the situation where the problem occurs and its impact on your operation
- Machine type, operating system version, and product version, including any patches and other software that might be affecting the problem
- Detailed steps on the methods you have used to reproduce the problem
- Any error logs or core dumps
Sun Welcomes Your CommentsSun is interested in improving its documentation and welcomes your comments and suggestions. Use the web-based form to provide feedback to Sun:
http://www.sun.com/hwdocs/feedback/
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.