Preface
The Directory Proxy Server Administration Guide contains the information you need in order to administer the Sun Java System Directory Proxy Server.
This preface contains the following sections:
Before performing any of the tasks described in this guide, read the Directory Proxy Server Release Notes.
Who Should Read This Guide
This guide is intended for system administrators who will configure and operate one or more servers.
The author of this guide assumes you are familiar with the following:
- Sun Java System Directory Proxy Server 5 and its administration
- Specifications for LDAP and related protocols
- Internet and World Wide Web technologies
How This Guide Is Organized
This guide is organized into the following parts:
Using the Documentation
The Directory Proxy 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:
http://docs.sun.com
The Directory Proxy Server documentation set can be accessed here:
http://docs.sun.com/coll/JES_DirectoryServer_52p2
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 Proxy Server Documentation
Document
|
Contents
|
Directory Proxy Server Release Notes
http://docs.sun.com/doc/817-6253
|
Contains the latest information about Directory Proxy Server, including known problems.
|
Directory Proxy Server Administration Guide
http://docs.sun.com/doc/817-5221
|
Gives the procedures to manage your directory contents and configure every feature of Directory Proxy Server.
|
Java Enterprise System 2004Q2 Release Notes
http://docs.sun.com/doc/817-5503
|
Contains the latest information about update, upgrade, and data migration procedures for moving to the latest version of Directory Proxy Server.
|
Java Enterprise System 2004Q2 Installation Guide
http://docs.sun.com/doc/817-5760
|
Covers update, upgrade, and data migration procedures for moving to the latest version of Directory Proxy Server.
|
Conventions
Table 2 describes the typeface conventions used in this guide.
Table 2 Typeface Conventions
Typeface
|
Meaning
|
Examples
|
AaBbCc123
(Monospace)
|
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.
|
AaBbCc123
(Monospace bold)
|
What you type, as contrasted with on-screen computer output.
|
% su
Password:
|
AaBbCc123
(Italic)
|
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
Item
|
Meaning
|
Examples
|
install-dir
|
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.
|
ServerRoot
|
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.
|
slapd-serverID
|
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
Symbol
|
Meaning
|
Notation
|
Example
|
[ ]
|
Contain optional command options.
|
O[n]
|
\x7f O4, \x7f O
|
{ }
|
|
Contain a set of choices for a required command option.
Separates command option choices.
|
d{y|n}
|
\x7f dy
|
+
|
Joins simultaneous keystrokes in keyboard shortcuts that are used in a graphical user interface.
|
|
Ctrl+A
|
-
|
Joins consecutive keystrokes in keyboard shortcuts that are used in a graphical user interface.
|
|
Esc-S
|
>
|
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
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 Proxy Server commands are usually expressed using the LDAP 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 Proxy Server:
http://wwws.sun.com/software/learnabout/enterprisesystem/index.html
Third-party URLs are included in this document to provide additional, related information.
|
Note
|
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 Proxy Server, contact Sun customer support using one of the following mechanisms:
This site has links to the Online Support Center and ProductTracker, as well as to maintenance programs and support contact numbers.
This site includes patches, support documents, security information, and the Sun System Handbook.
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 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 Administration Guide is 817-6255-10.