Installation Guide
iv
5.1.3. Installing an Administration Server After Installing Directory Server ...................... 52
5.2. Working with Directory Server Instances ...................................................................... 52
5.2.1. Creating a New Directory Server Instance ......................................................... 52
5.2.2. Installing Only the Directory Server ................................................................... 53
5.3. Registering Servers Using register-ds-admin.pl ............................................................ 53
5.3.1. register-ds-admin.pl Options ............................................................................. 53
5.3.2. Registering an Existing Directory Server Instance with the Configuration
Directory Server ........................................................................................................ 54
5.4. Updating Directory Server Instances ............................................................................ 54
5.5. Silent Setup ............................................................................................................... 54
5.5.1. Silent Setup for Directory Server and Administration Server ................................ 55
5.5.2. Silent Directory Server Instance Creation .......................................................... 56
5.5.3. Sending Parameters in the Command Line ....................................................... 57
5.5.4. Using the ConfigFile Parameter to Configure the Directory Server ....................... 59
5.5.5. About .inf File Parameters ................................................................................ 60
5.6. Installing the Password Sync Service .......................................................................... 66
5.7. Uninstalling Directory Server ....................................................................................... 69
5.7.1. Removing a Single Directory Server Instance .................................................... 69
5.7.2. Uninstalling Directory Server ............................................................................ 69
6. Migrating from Previous Versions 71
6.1. Migration and Upgrade Overview ................................................................................ 71
6.2. Migrating 7.1 Servers ................................................................................................. 72
6.2.1. About migrate-ds-admin.pl ................................................................................ 73
6.2.2. Before Migration .............................................................................................. 75
6.2.3. Migrating a Server or Single Instance ............................................................... 76
6.2.4. Migrating Replicated Servers ............................................................................ 77
6.2.5. Migrating a Directory Server from One Machine to Another ................................. 78
6.2.6. Migrating a Directory Server from One Platform to Another ................................. 80
6.3. Upgrading 8.0 Servers ................................................................................................ 82
6.3.1. Upgrading a Server ......................................................................................... 82
6.3.2. Migrating an 8.0 Directory Server to 8.1 on Another Machine .............................. 85
6.4. Upgrading Password Sync .......................................................................................... 86
7. General Usage Information 87
7.1. Directory Server File Locations ................................................................................... 87
7.2. LDAP Tool Locations .................................................................................................. 88
7.3. Starting the Directory Server Console .......................................................................... 88
7.4. Getting the Administration Server Port Number ............................................................ 89
7.5. Starting and Stopping Servers ..................................................................................... 90
7.5.1. Starting and Stopping Directory Server ............................................................. 90
7.5.2. Starting and Stopping Administration Server ...................................................... 90
7.6. Resetting the Directory Manager Password .................................................................. 90
7.7. Troubleshooting .......................................................................................................... 91
7.7.1. Running dsktune .............................................................................................. 91
7.7.2. Common Installation Problems ......................................................................... 92
Glossary 93
Index 107