8 Managing Oracle Unified Directory as a Windows Service

This section covers the following topics:

8.1 Managing the Server as a Windows Service

Use the windows-service command to enable or disable the 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

For more information, see windows-service in the Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.

Note:

You can also specify that the server should be run as a Windows service during installation time, if you use the GUI install. On the Review panel, at the end of the installation, select Run the server as a Windows Service.

8.1.1 Configuring the Timeout Value When the 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.

8.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:

  • Use the window-service.bat utility to clean up the existing service.

  • Manually remove the Windows service in the Windows registry.

8.2.1 To Remove a Windows Service by 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.

  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.

8.2.2 To Remove 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 on its Processes tab, and make sure 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 machine. 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 up successfully, thus confirming that the current configuration is valid.

  5. Delete the instance directory to make sure that you have completely uninstalled Oracle Unified Directory.

  6. Restart Windows.

    The Windows service should be removed.