Setting Up the Directory Server

You can set up the directory server in two modes:

• Graphical user interface (GUI) mode. GUI mode uses a Java-based graphical installer that enables you to set up the directory server, load it with data, and get it running in very little time. The installer asks some basic questions about the server configuration and then gives you the choice of leaving your database empty, loading the server with data from your own LDIF or loading the server with automatically generated sample data. The installer also enables you to configure security and replication, and, optionally, to start the server when the configuration is complete. Finally, the installer includes the ability to invoke the GUI control panel at the end of the configuration process.

• Command-line interface (CLI) mode. The command-line mode prompts you for required information before the configuration begins.

To Set Up the Directory Server Using the GUI

1. After you have unpacked the software, change to the installation subdirectory.

   (UNIX, Linux)  $ cd SunOpenDS_SE2.2
   (Windows)      C:\> cd SunOpenDS_SE2.2 

2. Type setup to configure the directory server installation.

   The utility launches the graphical installer.

   (UNIX, Linux)  $ setup
   (Windows)      C:\> setup.bat

3. On the Welcome panel, click Next.
4. On the License panel, select the checkbox to accept the license and click Next.
5. On the Server Settings panel, type the following information:
   1. Host Name. Type the directory server's host name or IP address.

      The default is the local host name.

   2. LDAP Listener Port. Type the LDAP port for the directory server.

      If you run the installer as the root user, the default port is 389 . If you run the installer as a non-root user, the default port is 1389.

   3. Administration Connector Port. Type the port that will be used for administration traffic.

      The default administration port is 4444. For more information, see Managing Administration Traffic to the Server in Sun OpenDS Standard Edition 2.2 Administration Guide.

   4. LDAP Secure Access. If you want to configure SSL, StartTLS, or both, click Configure.

      Complete the following information:

      1. SSL Access. Select Enable SSL and type a valid port for secure LDAP operations.

         If you run the installer as the root user, the default secure port is 636. If you run the installer as a non-root user, the default secure port is 1636.

      2. StartTLS Access. Click Enable StartTLS for LDAP.
      3. Certificate. If you are in a testing environment, select Generate Self-Signed Certificate.

         For production servers, click Use an Existing Certificate, and then click the Keystore Type. Type the Keystore Path, and Keystore PIN if necessary.

      4. Click OK to continue.
   5. Root User DN. Type the Root User DN, or keep the default, cn=Directory Manager.
   6. Password. Type the root user bind password.
   7. Password (confirm): Retype the root user bind password.
   8. Click Next to continue.
6. On the Topology Options panel, select one of the following:
   1. This will be a stand-alone server.
   2. This server will be part of a replication topology.

      For instructions on setting up a replicated topology, see Setting Up Replication During Installation.

7. Click Next to Continue.
8. On the Directory Data panel, specify how to load data into your directory:
   1. Directory Base DN. Type the base DN for your directory.

      The default Base DN is dc=example,dc=com.

   2. Directory Data. Select one of the data options.
      • Only Create Base Entry creates an entry with the base DN specified previously.
      • Leave Database Empty sets up a database but does not populate any entries.
      • Import Data from LDIF File imports LDIF data from the file specified in the Path field.
      • Import Automatically-Generated Sample Data generates the number of sample entries specified in the Number of User Entries field.
9. On the Review panel, review your configuration.

   Click Start Server when Configuration has Completed to automatically start the server after the directory server has been configured. On Windows systems, click Start Server as a Windows service, if desired.

10. Click Finish.
11. (Optional) On the Finished panel, click Launch Control Panel to see the server configuration status and to perform basic administration tasks on the server.
12. Click Close.

To Set Up the Directory Server Using the CLI

1. After you have unpacked the software, change to the installation subdirectory.

   (UNIX, Linux)  $ cd SunOpenDS_SE2.2
   (Windows)      C:\> cd SunOpenDS_SE2.2 

2. Type setup with the --cli option to launch the install in interactive mode.

   (UNIX, Linux)  $ setup --cli
   (Windows)      C:\> setup.bat -cli 

3. Type Yes and press Enter to accept the license agreement.
4. Type the root user DN, or press Enter or Return to accept the default (cn=Directory Manager).
5. Provide a password for the root user and re-enter the password to confirm it.
6. Type the LDAP port number for your directory server, or press Enter or Return to accept the default.

   If you run the installer as the root user, the default port is 389. If you run the installer as a non-root user, the default port is 1389.

7. Type the port number that will be used for administration traffic.

   The default administration port is 4444. For more information, see Managing Administration Traffic to the Server in Sun OpenDS Standard Edition 2.2 Administration Guide.

8. Type the base DN for the directory data, or press Enter or Return to accept the default.

   The default Base DN is dc=example,dc=com.

9. Type an option to set up the directory data.
   • Only create the base entry creates an entry with the base DN specified previously.
   • Leave the database empty sets up a database but does not populate any entries.
   • Import data from an LDIF file imports LDIF data from a file, specified in the following step.
   • Load automatically-generated sample data generates the number of sample entries specified in the following step.
10. Type yes if you want to enable SSL and enter the port for LDAPS clients.

    If you run the installer as the root user, the default secure port is 636. If you run the installer as a non-root user, the default secure port is 1636.

11. Type yes if you want to enable StartTLS.
12. If you enabled SSL or StartTLS in the previous steps, select the certificate type.
13. Type yes or press Enter or Return to accept the default to start the server after the configuration has completed.
14. Confirm your configuration, and type 1 or press Enter or Return to accept the default to complete the configuration process.