Setting Up the Directory Server by Using the CLI

To Set Up the Directory Server Using the CLI

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.
3. Type oud-setup with the --cli option to launch the install in interactive mode.

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

   The utility launches the command—line 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. Enter 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. Enter 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. Enter 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 Oracle Fusion Middleware Administration Guide for Oracle Unified Directory.

8. Press Enter or Return to create base DNs in the server, or Enter No if you do not want to create base DNs.
9. Enter 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.

10. Select 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.
11. 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.

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

    To display the equivalent non-interactive commands, enter 3. This option displays the commands that are run to set up the server with the specified configuration, and can be useful for scripting purposes.

16. 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=*)"