Red Hat Directory Server 10 Installation Guide Updated for Directory Server 10.6 Last Updated: 2020-12-07 Red Hat Directory Server 10 Installation Guide Updated for Directory Server 10.6 Marc Muehlfeld Red Hat Customer Content Services [email protected] Petr Bokoč Red Hat Customer Content Services Tomáš Čapek Red Hat Customer Content Services Petr Kovář Red Hat Customer Content Services Ella Deon Ballard Red Hat Customer Content Services Legal Notice Copyright © 2020 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, the Red Hat logo, JBoss, OpenShift, 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 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. Abstract This guide is for installation and upgrading the Directory Server and associated services. This documentation is no longer maintained. For details, see . Table of Contents Table of Contents .D . E. P. .R . E. .C . A. .T . E. D. .D . O. .C . U. .M . .E . N. .T . A. .T .I .O . N. 3. .P .R . E. .F . A. .C . E. 3. .C . H. .A . P. .T .E . R. 1.. .P . R. .E . P. .A . R. .I N. .G . .F . O. R. .A . .D . I. R. .E .C . T. .O . .R .Y . .S . E. .R . V. .E .R . .I N. S. T. .A . L. .L .A . T. .I O. N. 5. 1.1. DIRECTORY SERVER COMPONENTS 5 1.2. CONSIDERATIONS BEFORE SETTING UP DIRECTORY SERVER 5 1.3. ABOUT THE SETUP-DS-ADMIN.PL SCRIPT 10 1.4. OVERVIEW OF SETUP 12 .C . H. .A . P. .T .E . R. 2. S. .Y . S. .T .E . M. .R . E. .Q . U. .I R. .E . M. E. N. T. S. 1.9 . 2.1. GENERAL HARDWARE REQUIREMENTS 19 2.2. SOFTWARE REQUIREMENTS 19 .C . H. .A . P. .T .E . R. 3. S. .E . T. .T .I .N . G. U. .P . .R . E. .D . .H . A. .T . .D . I.R . E. .C . T. O. R. .Y . .S .E . R. .V . E. .R . .O . N. R. .E . D. H. .A . T. E. N. T. E. .R . P. .R . I.S . E. .L . I.N . U. X. .2 . 0. 3.1. THE DIRECTORY SERVER SETUP MODES 20 3.2. INSTALLING THE DIRECTORY SERVER PACKAGES 20 3.3. PREPARING THE INSTALLATION 21 3.4. EXPRESS SETUP 22 3.5. TYPICAL SETUP 24 3.6. CUSTOM SETUP 25 .C . H. .A . P. .T .E . R. 4. .A . D. .V . A. .N . C. .E . D. S. .E .T . U. .P . .A . N. .D . .C . O. N. .F . I.G . U. R. A. .T . I.O . .N . .2 . 7. 4.1. INSTALLING DIRECTORY SERVER BEHIND A LOAD BALANCER 27 4.2. WORKING WITH ADMINISTRATION SERVER INSTANCES 28 4.3. CREATING A NEW DIRECTORY SERVER INSTANCE 29 4.4. REGISTERING SERVERS USING REGISTER-DS-ADMIN.PL 31 4.5. UPDATING DIRECTORY SERVER INSTANCES 32 4.6. SILENT SETUP 32 4.7. INSTALLING THE PASSWORD SYNC SERVICE 36 4.8. UNINSTALLING DIRECTORY SERVER 38 .C . H. .A . P. .T .E . R. 5. M. I.G . .R . A. .T .I .N . G. F. .R . O. .M . P. .R . E. V. .I .O . U. .S . .V . E. .R .S . I.O . .N . S. .4 .0 . 5.1. IMPORTANT CONSIDERATIONS 40 5.2. PRE-MIGRATION TASKS 40 5.3. DATABASE MIGRATION METHODS 43 5.4. MIGRATING FROM RED HAT DIRECTORY SERVER 7 AND 8 TO RED HAT DIRECTORY SERVER 10 44 5.5. MIGRATING FROM RED HAT DIRECTORY SERVER 9 TO RED HAT DIRECTORY SERVER 10 45 5.6. MIGRATING THE CONFIGURATION DIRECTORY SERVER 45 5.7. UPGRADING PASSWORD SYNC 46 .C . H. .A . P. .T .E . R. 6. .T .R . O. U. .B . L. E. .S . H. .O . O. T. .I N. .G . .4 . 7. 6.1. COMMON INSTALLATION PROBLEMS 47 .A .P . P. .E . N. .D . I. X. A . .P .A . R. .A . M. E. .T .E . R. .S . .I N. ..I N. F. .F . I.L . E. .S . .4 .8 . A.1. ABOUT .INF FILE PARAMETERS 48 A.2. PARAMETERS IN THE [GENERAL] SECTION 48 A.3. PARAMETERS IN THE [SLAPD] SECTION 50 A.4. PARAMETERS IN THE [ADMIN] SECTION 52 A.5. SAMPLE .INF FILES 52 .G . L. .O . S. .S .A . R. .Y . .5 . 3. .I N. .D . E. .X . 7. .1 . ..