Setting up the Directory Server by Using the GUI

The following topics present a step by step installation using the oud-setup graphical interface.

To Set Up the Directory Server Using the GUI

1. When you have installed the software, change to the ORACLE_HOME subdirectory.

   (UNIX, Linux)  $ cd OUD-base-location/ORACLE_HOME
   (Windows)      C:\> cd OUD-base-location\ORACLE_HOME

2. Ensure that your JAVA_HOME environment variable is set to a supported JVM installation (at least Java 1.6).
3. Run the oud-setup command to configure the directory server installation.

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

   The utility launches the graphical installer and creates the Oracle Unified Directory instance in OUD-base-location/instance-dir.

   The default instance directory name is asinst_1, with subsequent instances on the same server named asinst_2, asinst_3, and so on. To specify a different instance name, set the INSTANCE_NAME environment variable before you run the setup, for example:

   $ export INSTANCE_NAME=my-oud-instance

4. On the Welcome panel, click Next.
5. On the Server Settings panel, enter the following information:
   1. Host Name. Enter the directory server's host name or IP address.

      The default is the local host name.

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

      The default port that is proposed is the first available port that ends with 389. On UNIX platforms, if you run the installer as a non-root user, the default is 1389, if available.

   3. Administration Connector Port. Enter 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 Oracle Fusion Middleware Administration Guide for Oracle Unified Directory.

   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 to indicate that the LDAPS (that is, LDAP over SSL) listener should be enabled. Enter the port number on which the directory server listens for connections.

         The default secure port that is proposed is the first available port that ends with 636. On UNIX platforms, if you run the installer as a non-root user, the default secure port is 1636, if available.

      2. StartTLS Access. Click Enable StartTLS for LDAP to specify that the LDAP connection handler should allow clients to use the StartTLS extended operation to initiate secure communication over an otherwise insecure connection.
      3. Certificate. Select one of the following radio buttons to obtain the certificate that the server should use for SSL, StartTLS, or both:

         • Generate Self-Signed Certificate generates a self-signed certificate that can be used to secure the communication. While this is convenient for testing purposes, many clients will not trust the certificate by default, and you might need to configure it manually.

         • Use an Existing Certificate uses a certificate in an existing JKS keystore, a PKCS #12 file, or a PKCS #11 token. For more information about obtaining certificates, see Configuring Key Manager Providers in Oracle Fusion Middleware Administration Guide for Oracle Unified Directory.

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

           If more than one certificate is defined in the specified key store, you are asked to select one of the certificates from a drop down menu.

      4. Click OK to continue.
   5. Root User DN. Enter the Root User DN, or keep the default, cn=Directory Manager.
   6. Password. Enter 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. Enter 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 Runtime options panel, click Change to configure any specific JVM setting, or click Next to run the server with the default JVM settings.

   For more information, see Configuring the Java Runtime Settings During Installation.

10. On the Review panel, review your configuration.

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

    To display the equivalent command-line installation, select Show Equivalent Command-Line from the drop down menu at the top of the panel. This option displays the non-interactive commands that are run to set up the server with the specified configuration, and can be useful for scripting purposes.

11. Click Finish.
12. Click Close.
13. Test whether the directory server has been set up and started successfully by searching an entry in the directory. For example:

    On UNIX systems:

    instance-dir/oud/bin/ldapsearch -h localhost -p 1389 \
      -D "cn=directory manager" -w password -b "dc=example,dc=com" "(objectclass=*)"

    On Windows systems:

    instance-dir\oud\bat\ldapsearch.bat -h localhost -p 1389 \
      -D "cn=directory manager" -w password -b "dc=example,dc=com" "(objectclass=*)"