Contents

About This Guide

Purpose of This Guide
Prerequisites
Typographical Conventions
Default Paths and Filenames
Downloading Directory Server Tools
Suggested Reading

Part 1 Installation

Chapter 1 Installing Sun ONE Directory Server

Before You Start

Planning Your Directory Deployment
Obtaining Directory Server Software

Installation

Determining What to Install
Determining How to Install
Preparing Installation Information
Installing on Solaris Systems
Installing on Other UNIX Systems
Installing on Windows Systems

Uninstallation

Uninstalling on Solaris Systems
Uninstalling on Other UNIX Systems
Uninstalling on Windows Systems

Troubleshooting

Chapter 2 Upgrading From Previous Versions

Before You Upgrade

When Upgrading a Single Server Instance
When Upgrading Multiple Replicated Servers
For Help With Upgrades

Upgrading a Single Server

Installing the New Server
(4.x to 5.2) Handling Custom Schema
Migrating Existing Data
(4.x to 5.2) Creating Replication Agreements
(Optional) Reusing the Existing Port Number

(4.x to 5.2) Upgrading Replicated Servers

Preparing the New Master
Upgrading the Consumers
Upgrading a Branch
Adding Additional Servers
Example 4.x Upgrade Scenario

(5.x to 5.2) Upgrading Replicated Servers

Upgrading 5.x Servers
Adding Additional Servers
Example 5.x Upgrade Scenario

Part 2 Tuning

Chapter 3 Top Tuning Tips

Chapter 4 Hardware Sizing

Suggested Minimum Requirements

Minimum Available Memory
Minimum Local Disk Space
Minimum Processing Power
Minimum Network Capacity

Sizing Physical Memory

Sizing Memory for Directory Server
Sizing Memory for the Operating System
Sizing Total Memory
Dealing With Insufficient Memory

Sizing Disk Subsystems

Sizing Directory Suffixes
How the Directory Server Uses Disks
Distributing Files Across Disks
Disk Subsystem Alternatives
Monitoring I/O and Disk Use

Sizing for Multiprocessor Systems
Sizing Network Capacity
Sizing for SSL

Chapter 5 Tuning the Operating System

Checking Platform Support
Patching the System
Enforcing Basic Security

Isolate the System
No Dual Boot
Strong Passwords
(Windows) Local Security Policy
(UNIX Platforms) Users and Groups
Disabling Unnecessary Services

Keeping Accurate Time
Restarting After System Failure
Generating Basic Tuning Recommendations
Tuning System Settings

(Windows) Deferred Procedure Calls
File Descriptors
(HP-UX) Large File Support
(HP-UX) Threads Pending Timeout
(HP-UX) Threads Per Process
Transmission Control Protocol (TCP) Settings

Chapter 6 Tuning Cache Sizes

Types of Cache

Database Cache
Entry Cache
Import Cache
File System Cache
Total Aggregate Cache Size

How Searches Use Cache
How Updates Use Cache
How Suffix Initialization Uses Cache
Optimizing For Searches

All Entries and Indexes in Memory
Plenty of Memory, 32-Bit Directory Server
Less Memory, Some File System Cache
Low Memory, Low File System Cache

Optimizing for Updates
Cache Priming and Monitoring
Other Optimizations

Chapter 7 Tuning Indexing

About Indexes
Benefits: How Searches Use Indexes
Costs: How Updates Affect Indexes

Presence Indexes
Equality Indexes
Substring Indexes
Browsing (Virtual List View) Indexes
Approximate Indexes
International Indexes
Example: Indexing an Entry

Tuning Indexing for Performance

Allowing Only Indexed Searches
Limiting Index List Length
Troubleshooting Index Fragmentation

Chapter 8 Tuning Logging

Access Logging
Audit Logging
Error Logging
Multi-Master Replication Change Logging
Retro Change Logging
Transaction Logging

Chapter 9 Managing Use of Other Resources

Limiting Resources Available to Clients
Using Available System Resources

Managing Access Control
Configuring Server Plug-Ins

Appendix A Installed Product Layout

The ServerRoot Directory
The Server Instance Directory
Internal Use Only

Appendix B Using the Sun Crypto Accelerator Board

Before You Start
Creating a Token
Generating Bindings for the Board
Importing Certificates
Configuring SSL

Appendix C Installing Sun Cluster HA for Directory Server

Before You Start
Setting Up Network Resources
Installing the Servers

Installing on the Active Node
Installing on Other Nodes

Installing the Data Service Packages
Configuring the Servers
Example Registration and Configuration
Configuring Extension Properties

What You Can Configure
How the Fault Monitor Operates

Synchronizing HA Storage and Data Services
Creating an Additional Directory Server Instance
Uninstalling

Index