Exit Print View

Sun OpenDS Standard Edition 2.0 Installation Guide

Get PDF Book Print View

Document Information

Directory Server System Requirements

Installing the Directory Server

Configuring the JVM, Java Options, and Database Cache

Upgrading the Directory Server

Starting and Stopping the Directory Server

Managing the Directory Server as a Service

Uninstalling the Directory Server

To Uninstall the Directory Server in GUI Mode

To Uninstall the Directory Server by Using the Command Line

To Uninstall the Directory Server by Using a Script (UNIX/Linux Only)

Removing the Directory Server Windows Service

To Remove a Windows Service by Using windows-service.bat

To Manually Remove the Directory Server Service From the Windows Registry

Removing the Directory Server Windows Service

The uninstaller can, in most cases, cleanly uninstall and remove the directory server from your system. However, for Windows platforms, there might be times when the uninstaller fails to remove files due to an active directory server Windows service. For example, the uninstall utility might display the following error message.

Uninstall fails screen

In this case, the uninstaller failed due to the presence of the Windows service in the service manager, which prevents the uninstaller from deleting all of the instance's directories. As a result, the Windows service still remains even though the uninstaller has removed some files and directories from the instance server. For example, the bin directory is missing after a failed uninstallation, while other directories have been removed.

Windows server remains

You have two options to remove the remaining Windows service:

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 install-dir\bat.

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

    Type the serviceName that you want to remove.

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

    Note - This command only removes directory server services. The command will not clean up another product's services.

To Manually Remove the Directory Server Service From the Windows Registry

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


Caution - Make sure 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->OpenDS

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

  3. Make sure to check which instance the service that you are about to remove points to.
  4. Delete the entry from the Registry.
    Remove the service
  5. Search the registry for LEGACY_OPENDS control sets that might be saved in other control sets.

    Search the following:


    where w is the number of Sun OpenDSTM Standard Edition 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.

    Removing remaining registry keys

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

  6. Delete the instance directory to make sure you have completely uninstalled the directory server.
  7. Restart Windows.

    The Windows service should be removed.