Uninstalling an Oracle Unified Directory Instance

The following procedures describe how to uninstall the server instance for a directory server, a proxy server, and a replication gateway server.

You can remove a server instance using one of the following modes:

Graphical user interface (GUI) mode.
Interactive command-line mode.
Using a Script.

For more information about the uninstall command, see uninstall in Oracle Fusion Middleware Command-Line Usage Guide for Oracle Unified Directory.

Uninstalling a Directory Server Instance

To Uninstall a Directory Server Instance in GUI Mode

GUI mode is the default and recommended uninstall option. The GUI provides an easy interface for removing a directory server instance.

Launch the graphical uninstaller, as follows:

(UNIX, Linux) $ instance-dir/OUD/uninstall
(Windows)     C:\> instance-dir\OUD\uninstall.bat

Deselect any components that you do not want to remove and click Uninstall.
Note - By default, all components are selected for removal.
If the server is part of a replication topology, click Yes to continue the uninstallation.
The uninstaller starts the server (if it is not already running) and asks you for your Global Administrator login to remove the references to this server in the other replicating directory servers.
If the server is a standalone server and is running, a dialog box is displayed, asking to shut down the server before continuing with the uninstall.
Click Yes to have the uninstaller stop the server for you and continue with the uninstallation.
Review the logs to confirm the file or directory removals. Unix logs the entries at /var/tmp, Linux at /tmp, and Windows in the location defined by the TEMP user environment variable.
Log files are listed as oud-uninstall-IDNumber.log, where IDNumber is a system-generated number for your log.
For Windows systems, check the Windows registry for any remaining keys ending with Oracle Unified Directory. For example:
```
SYSTEM\\CurrentControlSet\\Services\\EventLog\\Application\\Oracle Unified Directory
```

To Uninstall a Directory Server Instance by Using the CLI

You can remove an Oracle Unified Directory instance in interactive, command-line mode by typing uninstall --cli. In interactive mode, you are prompted for any required input.

Launch the CLI uninstaller, as follows:

(UNIX, Linux) $ instance-dir/OUD/uninstall --cli
(Windows)     C:\> instance-dir\OUD\uninstall.bat --cli

Select the components to be removed.
- To remove all components, press Enter or Return to accept the default.
- To remove specific components and retain others, type 2.
  When uninstall prompts you to select the components to be deleted, press Enter or Return to accept the defaults.
If the server is part of a replication topology, type Yes or press Enter or Return to continue the uninstallation.
The uninstaller starts the server (if it is not already running) and requests your Global Administrator login to remove the references to this server in the other replicating directory servers.
If your directory server is a stand-alone server and is running, the uninstall prompts you to stop the server and remove all files.
Press Enter or Return to accept the default (Yes).
If you want to quit the uninstaller without removing files, type q.
The uninstall quits the process and logs the entry.

Note - UNIX logs the entry at /var/tmp, Linux at /tmp, and Windows at the location defined by the TEMP user environment variable.
Check that all files and directories have been removed. If they have not been removed, manually remove them.
For Windows systems, check the Windows registry for any remaining keys ending with Oracle Unified Directory.
For example:
```
SYSTEM\\CurrentControlSet\\Services\\EventLog\\Application\\Oracle Unified Directory
```

To Uninstall a Directory Server Instance by Using a Script

The uninstall command provides two options, --quiet and --no-prompt, for simple scripting. Most directory administrators have their preferred scripting language for automating their system tasks. The directory server provides script-friendly options with its command-line utilities to facilitate quick coding.

Create an uninstallation script and add the following uninstall command.
Make sure to type the command on a single line.
```
instance-dir/OUD/uninstall --cli \ 
--remove-all --no-prompt --forceOnError --quiet
```
Run the script.
Check for remaining directories in the logs, and if any directories or files remain, manually delete them.

Uninstalling a Proxy Server Instance

To Uninstall a Proxy Server Instance in GUI Mode

GUI mode is the default and recommended uninstall option. The GUI provides an easy interface for removing a proxy server instance.

Launch the graphical uninstaller, as follows:

(UNIX, Linux) $ instance-dir/OUD/uninstall
(Windows)     C:\> instance-dir\OUD\uninstall.bat

Deselect any components that you do not want to remove and click Uninstall.
Note - By default, all components are selected for removal.
If the server is running, a dialog box is displayed, asking to shut down the server before continuing with the uninstall.
Click Yes to have the uninstaller stop the server for you and continue with the uninstallation.
Review the logs to confirm the file or directory removals. Unix logs the entries at /var/tmp, Linux at /tmp, and Windows in the location defined by the TEMP user environment variable.
Log files are listed as oud-uninstall-IDNumber.log, where IDNumber is a system-generated number for your log.
For Windows systems, check the Windows registry for any remaining keys ending with Oracle Unified Directory. For example:
```
SYSTEM\\CurrentControlSet\\Services\\EventLog\\Application\\Oracle Unified Directory
```

To Uninstall a Proxy Server Instance by Using the CLI

You can remove a proxy instance in interactive, command-line mode by typing uninstall --cli. In interactive mode, you are prompted for any required input.

Launch the CLI uninstaller, as follows:

(UNIX, Linux) $ instance-dir/OUD/uninstall --cli
(Windows)     C:\> instance-dir\OUD\uninstall.bat --cli

Select the components to be removed.
- To remove all components, press Enter or Return to accept the default.
- To remove specific components and retain others, type 2.
  When uninstall prompts you to select the components to be deleted, press Enter or Return to accept the defaults.
If your proxy server is running, the uninstall prompts you to stop the server and remove all files.
Press Enter or Return to accept the default (Yes).
If you want to quit the uninstaller without removing files, type q.
The uninstall quits the process and logs the entry.

Note - UNIX logs the entry at /var/tmp, Linux at /tmp, and Windows at the location defined by the TEMP user environment variable.
Check that all files and directories have been removed. If they have not been removed, manually remove them.
For Windows systems, check the Windows registry for any remaining keys ending with Oracle Unified Directory.
For example:
```
SYSTEM\\CurrentControlSet\\Services\\EventLog\\Application\\Oracle Unified Directory
```

To Uninstall a Proxy Server Instance by Using a Script

The uninstall command provides two options, --quiet and --no-prompt, for simple scripting. Most directory administrators have their preferred scripting language for automating their system tasks. Oracle Unified Directory provides script-friendly options with its command-line utilities to facilitate quick coding.

Create an uninstallation script and add the following uninstall command.
Make sure to type the command on a single line.
```
instance-dir/OUD/uninstall --cli \ 
--remove-all --no-prompt --forceOnError --quiet
```
Run the script.
Check for remaining directories in the logs, and if any directories or files remain, manually delete them.

Uninstalling a Replication Gateway Instance

To Uninstall a Replication Gateway Instance in GUI Mode

GUI mode is the default and recommended uninstall option. The GUI provides an easy interface for removing a replication gateway instance.

Launch the graphical uninstaller, as follows:

(UNIX, Linux) $ instance-dir/OUD/uninstall
(Windows)     C:\> instance-dir\OUD\uninstall.bat

Deselect any components that you do not want to remove and click Uninstall.
Note - By default, all components are selected for removal.
If the server is running, a dialog box is displayed, asking to shut down the server before continuing with the uninstall.
Click Yes to have the uninstaller stop the server for you and continue with the uninstallation.
Review the logs to confirm the file or directory removals. Unix logs the entries at /var/tmp, Linux at /tmp, and Windows in the location defined by the TEMP user environment variable.
Log files are listed as oud-uninstall-IDNumber.log, where IDNumber is a system-generated number for your log.
For Windows systems, check the Windows registry for any remaining keys ending with Oracle Unified Directory. For example:
```
SYSTEM\\CurrentControlSet\\Services\\EventLog\\Application\\Oracle Unified Directory
```

To Uninstall a Replication Gateway Instance by Using the CLI

You can remove a replication gateway instance in interactive, command-line mode by typing uninstall --cli. In interactive mode, you are prompted for any required input.

Launch the CLI uninstaller, as follows:

(UNIX, Linux) $ instance-dir/OUD/uninstall --cli
(Windows)     C:\> instance-dir\OUD\uninstall.bat --cli

Select the components to be removed.
- To remove all components, press Enter or Return to accept the default.
- To remove specific components and retain others, type 2.
  When uninstall prompts you to select the components to be deleted, press Enter or Return to accept the defaults.
If your proxy server is running, the uninstall prompts you to stop the server and remove all files.
Press Enter or Return to accept the default (Yes).
If you want to quit the uninstaller without removing files, type q.
The uninstall quits the process and logs the entry.

Note - UNIX logs the entry at /var/tmp, Linux at /tmp, and Windows at the location defined by the TEMP user environment variable.
Check that all files and directories have been removed. If they have not been removed, manually remove them.
For Windows systems, check the Windows registry for any remaining keys ending with Oracle Unified Directory.
For example:
```
SYSTEM\\CurrentControlSet\\Services\\EventLog\\Application\\Oracle Unified Directory
```

To Uninstall a Replication Gateway Instance by Using a Script

The uninstall command provides two options, --quiet and --no-prompt, for simple scripting. Most directory administrators have their preferred scripting language for automating their system tasks. Oracle Unified Directory provides script-friendly options with its command-line utilities to facilitate quick coding.

Create an uninstallation script and add the following uninstall command.
Make sure to type the command on a single line.
```
instance-dir/OUD/uninstall --cli \ 
--remove-all --no-prompt --forceOnError --quiet
```
Run the script.
Check for remaining directories in the logs, and if any directories or files remain, manually delete them.

Skip Navigation Links
Exit Print View
	Oracle Fusion Middleware Installation Guide for Oracle Unified Directory 11g Release 1 (11.1.1)