Red Hat Directory Server 8.2.3

Installation Guide

Installing Red Hat Directory Server 8.2

Edition 8.2.2

Legal Notice

Copyright © 2010 Red Hat, Inc..
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, MetaMatrix, Fedora, the Infinity Logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack Logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
August 2, 2010, updated January 6, 2011


This manual provides a high-level overview of design and planning decisions you need to make before installing Directory Server, and describes the different installation methods that you can use.
1. Examples and Formatting
1.1. Command and File Examples
1.2. Tool Locations
1.3. LDAP Locations
1.4. Text Formatting and Styles
2. Additional Reading
3. Giving Feedback
4. Documentation History
1. Preparing for a Directory Server Installation
1.1. Directory Server Components
1.2. Considerations Before Setting Up Directory Server
1.2.1. Resolving the Fully-qualified Domain Name
1.2.2. Port Numbers
1.2.3. Firewall Considerations
1.2.4. Directory Server User and Group
1.2.5. Directory Manager
1.2.6. Directory Administrator
1.2.7. Admin Server User
1.2.8. Directory Suffix
1.2.9. Configuration Directory
1.2.10. Administration Domain
1.3. About the Script
1.4. Overview of Setup
2. System Requirements
2.1. General Hardware Requirements
2.1.1. Required JDK
2.1.2. Directory Server Supported Platforms
2.1.3. Directory Server Console Supported Platforms
2.1.4. Password Sync Service Platforms
2.1.5. Web Application Browser Support
2.2. Using dsktune
2.3. Red Hat Enterprise Linux Operating System Requirements
2.3.1. Red Hat Enterprise Linux Patches
2.3.2. Red Hat Enterprise Linux System Configuration
3. Setting up Red Hat Directory Server on Red Hat Enterprise Linux
3.1. Installing OpenJDK
3.2. Installing the Directory Server Packages
3.3. Express Setup
3.4. Typical Setup
3.5. Custom Setup
4. Advanced Setup and Configuration
4.1. Working with Admin Server Instances
4.1.1. Configuring IP Authorization on the Admin Server
4.1.2. Configuring Proxy Servers for the Admin Server
4.1.3. Installing an Admin Server After Installing Directory Server
4.2. Working with Directory Server Instances
4.2.1. Creating a New Directory Server Instance
4.2.2. Installing Only the Directory Server
4.3. Registering Servers Using
4.3.1. Options
4.3.2. Registering an Existing Directory Server Instance with the Configuration Directory Server
4.4. Updating Directory Server Instances
4.5. Silent Setup
4.5.1. Silent Setup for Directory Server and Admin Server
4.5.2. Silent Directory Server Instance Creation
4.5.3. Sending Parameters in the Command Line
4.5.4. Using the ConfigFile Parameter to Configure the Directory Server
4.5.5. About .inf File Parameters
4.6. Installing the Password Sync Service
4.7. Uninstalling Directory Server
4.7.1. Removing a Single Directory Server Instance
4.7.2. Uninstalling Directory Server
5. Migrating from Previous Versions
5.1. Migration and Upgrade Overview
5.2. Migrating 7.1 Servers
5.2.1. About
5.2.2. Before Migration
5.2.3. Migrating a Server or Single Instance
5.2.4. Migrating Replicated Servers
5.2.5. Migrating a Directory Server from One Machine to Another
5.2.6. Migrating a Directory Server from One Platform to Another
5.3. Upgrading 8.1 Servers
5.3.1. Upgrading a Server
5.3.2. Upgrading Servers in Replication
5.3.3. Migrating an 8.1 Directory Server to 8.2 on Another Machine
5.3.4. Upgrading Directory Server on Solaris
5.4. Upgrading Password Sync
6. General Usage Information
6.1. Directory Server File Locations
6.2. LDAP Tool Locations
6.3. Starting the Directory Server Console
6.4. Getting the Admin Server Port Number
6.5. Starting and Stopping Servers
6.5.1. Starting and Stopping Directory Server
6.5.2. Starting and Stopping Admin Server
6.6. Resetting the Directory Manager Password
6.7. Troubleshooting
6.7.1. Running dsktune
6.7.2. Common Installation Problems