Sun Java(TM) System Directory Server 5 2004Q2 Performance Tuning Guide |
Preface
The Directory Server Performance Tuning Guide contains the information you need in order to carry out post-installation configuration and tuning. While Directory Server offers great performance out of the box, you can tune it for even better performance, sometimes with spectacular results.
This preface contains the following sections:
Before performing any of the tasks described in this guide, read the Directory Server Release Notes. Before installing Directory Server for use in a production environment, make sure your deployment objectives are clear. Refer to the Directory Server Deployment Planning Guide for more information. When installing the software, refer to the Directory Server Installation and Migration Guide for instructions.
Who Should Read This GuideThis guide is intended for system administrators and developers aiming to tune Directory Server for top performance.
The author of this guide assumes you are familiar with the following:
How This Guide Is OrganizedThis guide is divided into these chapters:
Provides an quick overview of tuning and what to tune.
Covers tuning operating system settings for top performance.
Covers how caches work, and how you can tune their sizes.
Covers how indexes work, and how you can configure them to enhance search and update rates.
Discusses how to handle the different types of logs for top performance.
Covers tuning how Directory Server limits resources made available to client applications, and how Directory Server makes use of system resources.
Covers how Directory Server implements CoS to help you gauge whether a particular use of CoS fits your performance requirements.
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 are 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:
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 Performance Tuning Guide is 817-5220-10.