Release 7.3.0.3 Server Administration Guide PingDirectory | Contents | ii Contents PingDirectory™ Product Documentation................................................ 20 Overview of the Server............................................................................. 20 Server Features.................................................................................................................................20 Administration Framework.................................................................................................................21 Server Tools Location....................................................................................................................... 22 Preparing Your Environment....................................................................22 Before You Begin.............................................................................................................................. 22 System requirements..............................................................................................................22 Installing Java......................................................................................................................... 23 Preparing the Operating System (Linux).......................................................................................... 24 Configuring the File Descriptor Limits.................................................................................... 24 File System Tuning.................................................................................................................25 Setting the Maximum User Processes...................................................................................26 About Editing OS-Level Environment Variables.....................................................................26 Install sysstat and pstack (Red Hat)...................................................................................... 26 Install dstat (SUSE Linux)...................................................................................................... 26 Disable File System Swapping...............................................................................................27 Omit vm.overcommit_memory................................................................................................ 27 Managing System Entropy..................................................................................................... 27 Set File System Event Monitoring (inotify).............................................................................27 Tune IO Scheduler................................................................................................................. 27 Running as a Non-Root User (Linux)............................................................................................... 28 Enabling the Server to Listen on Privileged Ports (Linux)..................................................... 28 Installing the Server.................................................................................. 29 Getting the Installation Packages..................................................................................................... 29 To Unpack the Build Distribution............................................................................................29 About the RPM Package........................................................................................................29 About the Layout of the Directory Server Folders............................................................................ 30 About the Server Installation Modes.................................................................................................31 Before You Begin.............................................................................................................................. 31 Setting Up the Directory Server in Interactive Mode........................................................................ 32 To Install the Directory Server in Interactive Mode................................................................32 Installing the Directory Server in Non-Interactive Mode................................................................... 33 To Install the Directory Server in Non-Interactive Mode........................................................ 34 To Install the Directory Server in Non-Interactive Mode with a Truststore............................. 34 Installing a Lightweight Server.......................................................................................................... 34 Running the Status Tool................................................................................................................... 35 To Run the Status Tool..........................................................................................................35 Where To Go From Here..................................................................................................................37 Working with Multiple Backends....................................................................................................... 37 Importing Data................................................................................................................................... 38 Generating Sample Data........................................................................................................38 To Import Data on the Directory Server Using Offline Import................................................ 38 PingDirectory | Contents | iii Running the Server........................................................................................................................... 39 To Start the Directory Server................................................................................................. 39 To Run the Server as a Foreground Process........................................................................39 To Start the Server at Boot Time...........................................................................................39 Logging into the Administrative Console................................................................................40 Stopping the Directory Server...........................................................................................................40 To Stop the Server.................................................................................................................40 To Schedule a Server Shutdown........................................................................................... 41 To Restart the Server.............................................................................................................41 Run the Server as a Microsoft Windows Service............................................................................. 41 To Register the Server as a Windows Service......................................................................41 To Run Multiple Service Instances........................................................................................ 42 To Deregister and Uninstall Services.....................................................................................42 Log Files for Services.............................................................................................................42 Uninstalling the Server...................................................................................................................... 42 To Uninstall the Server in Interactive Mode...........................................................................42 To Uninstall the Server in Non-Interactive Mode................................................................... 43 To Uninstall Selected Components in Non-Interactive Mode.................................................44 Upgrading the Server................................................................................44 Upgrade Overview and Considerations............................................................................................ 44 Update servers in a topology............................................................................................................44 To Upgrade the Directory Server......................................................................................................45 Upgrade the RPM package...............................................................................................................46 Revert an update...............................................................................................................................46 Revert to the most recent server version...............................................................................47 Configure SCIM After Upgrade.............................................................................................. 47 Tuning the Server......................................................................................48 About Minimizing Disk Access.......................................................................................................... 48 Memory Allocation and Database Cache......................................................................................... 49 Directory Server Process Memory........................................................................................ 49 A Method for Determining Heap and Database Cache Size..................................................49 Automatic DB Cache Percentages.........................................................................................50