UnboundID Directory Server

UnboundID Corp.
  Return to Documentation Index

Getting Started with the UnboundID Directory Server

The UnboundID Directory Server is a high-performance, extensible, user-friendly, pure-Java LDAPv3 directory server. This document provides a basic set of instructions that can help you start using the server.

Installing the UnboundID Directory Server

The UnboundID Directory Server will be distributed in a zip file. Extract the contents of this zip file in the location where you want the server to reside.

To provide the initial Directory Server configuration, simply run the setup command provided in the Directory Server intallation root. This will attempt to use an existing Java installation to launch the setup utility, but if for some reason no Java installation cannot be found, or if is not at least Java SE version 6.0, then it may be necessary to set the JAVA_HOME environment variable in order to specify the location of the Java SE 6.0 or higher installation that you wish to use for the server.

If possible, a graphical interface will be displayed that will prompt you for the necessary information. Otherwise, an interactive text-based installation will be used. If you wish to force the text-based installation, then you can add the "--cli" argument to the command line (e.g., "./setup --cli"). The setup utility will allow you to configure a number of things, including:

Starting and Stopping the Directory Server

In order to start the UnboundID Directory Server on a UNIX-based system, run the bin/start-ds command. On Windows systems, use bat\start-ds.bat. The Directory Server will be started in the background, and control will be returned to the terminal once the server has been started. If you wish to keep the server running in the foreground, then you may add the "--nodetach" argument to the command line (e.g., "bin/start-ds --nodetach").

To stop the Directory Server on a UNIX-based system, use the bin/stop-ds command. On Windows systems, use bat\stop-ds.bat. If you wish to restart the server rather than stop it, then you may add the "--restart" argument to the command line (e.g., "bin/stop-ds --restart").

Utilities Provided with the Directory Server

A number of administrative utilities and other tools are included with the Directory Server. They are located in the bin directory on UNIX-based systems, and in the bat directory for Windows systems.

The primary utility for interacting with the Directory Server configuration is the dsconfig tool. This may be used in either interactive or non-interactive mode. The interactive mode provides a text-based menu-driven interface that allows you to view and manage the various components within the server, while the non-interactive is ideal for use in administrative scripts. Initially, it is recommended that you use the interactive mode to familiarize yourself with the configurable elements of the server, and the interactive mode does provide the ability to display the non-interactive command line that may be used to perform the same task. The interactive mode may be used by launching the dsconfig tool with no arguments. Use the --help argument to see what other options are available. Note that the Directory Server must be running in order to use the dsconfig tool, whether in interactive or non-interactive mode. For more information about the configurable components within the Directory Server, see the Configuration Reference Guide.

A number of other command-line utilities are provided with the server. In each case, the "--help" argument may be used to obtain information about how they may be used.

Administrative Utilities LDAP Client Utilities LDIF Utilities Other Tools
Copyright 2008-2013 UnboundID Corp. All Rights Reserved.