Sun Java(TM) System Directory Server 5 2004Q2 Administration Reference |
Preface
The Directory Server Administration Reference provides comprehensive information on the command-line utilities and scripts provided with Directory Server, configuration attributes, file formats, schemas, and error and connection codes.
Most Directory Server administrative tasks can be performed through the Server Console, the graphical user interface provided with Directory Server. For information on using the Server Console, refer to the Administration Server Administration Guide, and for details of how to use the console to manage Directory Server in particular, refer to the Directory Server Administration Guide.
This reference deals with the other methods of managing the Directory Server, namely altering the server configuration attributes via the command line and using the command-line utilities.
This preface contains the following sections:
Before using this reference, read the Directory Server Release Notes.
Who Should Read This ReferenceThis reference is intended for system administrators maintaining Directory Server.
The author of this reference assumes you are familiar with the following:
How This Reference Is OrganizedThis reference is divided into these chapters:
Covers the command-line tools provided with Directory Server.
Provides details of how the configuration is organized.
Provides an overview of the files stored under the instance directory.
Lists error messages generated by Directory Server.
Covers support locales and language-related attribute subtypes.
Covers LDAP URL syntax.
Covers LDIF syntax.
Covers LDIF syntax.
Provides an overview of directory schema, and lists files describing schema.
Lists object classes accepted by the default schema.
Lists operational attributes used by Directory Server.
Points to the complete list of terms used in this documentation set.
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 reference.
Table 3 describes placeholder conventions used in this reference.
Table 4 describes the symbol conventions used in this reference.
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 Administration Reference is 817-5235-10.