1. Installing Oracle Unified Directory
  2. Managing Oracle Unified Directory as a Windows Service

9 Managing Oracle Unified Directory as a Windows Service

You can enable or disable the Oracle Unified Directory server as a Microsoft Windows service.

Topics:

9.1 Managing the Oracle Unified Directory Server as a Windows Service

Use the windows-service command to enable or disable the Oracle Unified Directory server as a Windows service.

To enable the server as a Windows service, use the following command:

C:\> instance-dir\OUD\bat\windows-service.bat -e

To disable the server as a Windows service, use the following command:

C:\> instance-dir\OUD\bat\windows-service.bat -d

See windows-service in Administering Oracle Unified Directory.

Note:

You can also specify that the Oracle Unified Directory server should run as a Windows service, if you use the GUI installation. On the installation Review panel, select Run the server as a Windows Service.

See also Configuring the Timeout Value when the Oracle Unified Directory Server Starts.

9.1.1 Configuring the Timeout Value when the Oracle Unified Directory Server Starts

If the system is heavily loaded when it boots, the process that starts the server might time out while waiting for the server to start. By default, the server attempts to start 100 times, with an interval of 5 seconds between attempts.

You can configure the number of attempts that the server makes to start by setting the value of the OUD_WINDOWS_SERVICE_START_NTRIES system environment variable.

9.2 Removing the Oracle Unified Directory Windows Service

The uninstall process should cleanly uninstall and remove Oracle Unified Directory from your system. However, for Windows platforms, there might be times when the uninstall fails to remove files due to an active Windows service.

You can remove the remaining Windows service in two ways:

9.2.1 Removing a Windows Service Using windows-service.bat

You can use the windows-service.bat command to clean up any existing Windows services. This command is located in instance-dir\OUD\bat.

To clean up any existing Windows services:

  1. Use the windows-service.bat command with the --cleanupService option.

    Type the serviceName that you want to remove. 

    C:\> instance-dir\OUD\bat\windows-service.bat --cleanupService serviceName
  2. Restart Windows to complete the cleanup.

    Note:

    This command removes Oracle Unified Directory services only. The command will not clean up another product's services.

9.2.2 Removing the Oracle Unified Directory Service From the Windows Registry

You can manually remove any remaining Windows service entries from the Windows registry.

Caution:

Make sure that you know what you are doing when removing entries in your Windows registry. You can permanently damage your operating system.

  1. Run the Task Manager, click the Processes tab, and ensure that opends_service.exe is not running.

    If it is, select the process and click the End Process button at the bottom right of the Task Manager dialog.

  2. Run regedit and go down the registry tree following this path.
    My Computer->HKEY_LOCAL_MACHINE->SYSTEM->CurrentControlSet->Services->Oracle Unified Directory

    If you installed more than one instance of Oracle Unified Directory, the added services are named Oracle Unified Directory-2, Oracle Unified Directory-3, and so on.

    Check that the service that you about to remove points to the correct instance.

  3. Delete the entry from the Registry.
  4. Search the registry for LEGACY_OUD control sets that might be saved in other control sets.

    Search the following:

    HKEY_LOCAL_MACHINE->SYSTEM->ControlSetxyz->Enum->Root->LEGACY_ORACLE_UNIFIED_DIRECTORY-w

    where w is the number of Oracle Unified Directory instances that you have registered as a service and xyz is the number of configuration profiles saved on the system. This entry is typically found in ControlSet001, but it can be located elsewhere.

    Depending on your profile, your system configuration, and the control set you are trying to edit, the registry entries might be protected from deletion. In this case, you might need Administrator privileges to perform this operation, or the system control set might be refreshed the next time Windows starts successfully, thus confirming that the current configuration is valid.

  5. Delete the instance directory to ensure that you have completely uninstalled Oracle Unified Directory.
  6. Restart Windows.

    The Windows service should be removed.