Uninstalling Oracle Unified Directory

8 Uninstalling Oracle Unified Directory

You can uninstall Oracle Unified Directory server instances you have configured and completely remove the software from your system.

To completely remove the Oracle Unified Directory software from your system, you must follow the procedures in the following sections in order:

Uninstalling an Oracle Unified Directory Instance

8.1 Uninstalling an Oracle Unified Directory Instance

Follow these procedures 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.
Script.
WebLogic Scripting Tool (WLST)

See uninstall in Administering Oracle Unified Directory.

8.1.1 Uninstalling a Directory Server Instance

You can use a graphical user interface, a command-line utility or a script to uninstall a directory server instance.

8.1.1.1 Uninstalling a Directory Server Instance Using 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:
On UNIX and Linux systems:
```
$ instance-dir/OUD/uninstall
```
On Windows systems:
```
C:\> instance-dir\OUD\uninstall.bat
```
Deselect any components that you do not want to remove and click Uninstall.

By default, all components are selected for removal.
If the server is part of a replication topology, click Yes to continue the deinstallation.

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 deinstall.

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 and Linux 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
```

8.1.1.2 Uninstalling a Directory Server Instance 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:

On UNIX and Linux systems:
```
$ instance-dir/OUD/uninstall --cli
```
On Windows systems:
```
C:\> instance-dir\OUD\uninstall.bat --cli
```
Select the components to be removed.
1. To remove all components, press Enter or Return to accept the default.
2. 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 standalone 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).
To quit the uninstaller without removing files, type q.

The uninstall quits the process and logs the entry.

UNIX and Linux 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
```

8.1.1.3 Uninstalling a Directory Server Instance 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.

8.1.1.4 Deleting a Directory Server Instance Using WLST

You can delete a directory server instance by using the WLST command oud_deleteInstance.

To delete a directory server instance by using WLST:

Connect to WLST as described in Setting Up the Directory Server Using the WebLogic Scripting Tool.
At the command prompt, enter:
```
oud_deleteInstance(instanceName='instanceName')
```
For example, to delete a directory server instance named oud1 use the following command:
```
oud_deleteInstance(instanceName='oud1')
```
You cannot delete any directory server instance in either an UNKNOWN or a RUNNING state.

8.1.2 Uninstalling a Proxy Server Instance

You can use a graphical user interface, a command-line utility, or a script to uninstall a proxy server instance.

8.1.2.1 Uninstalling a Proxy Server Instance Using the GUI

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:
On UNIX and Linux systems:
```
$ instance-dir/OUD/uninstall
```
On Windows systems:
```
C:\> instance-dir\OUD\uninstall.bat
```
Deselect any components that you do not want to remove and click Uninstall.

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 and Linux 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
```

8.1.2.2 Uninstalling a Proxy Server Instance 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:

On UNIX and Linux systems:
```
$ instance-dir/OUD/uninstall --cli
```
On Windows systems:
```
C:\> instance-dir\OUD\uninstall.bat --cli
```
Select the components to be removed.
1. To remove all components, press Enter or Return to accept the default.
2. 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).
To quit the uninstaller without removing files, type q.

The uninstall quits the process and logs the entry.

UNIX and Linux 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
```

8.1.2.3 Uninstalling a Proxy Server Instance 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.

8.1.2.4 Deleting a Proxy Server Instance Using WLST

You can delete a proxy server instance by using the WLST command oud_deleteInstance.

To delete a proxy server instance by using WLST:

Connect to WLST as described in Setting Up the Proxy Server Using the WebLogic Scripting Tool.
At the command prompt, enter:
```
oud_deleteInstance(instanceName='instanceName')
```
For example, to delete a proxy server instance named oud_proxy use the following command:
```
oud_deleteInstance(instanceName='oud_proxy')
```
You cannot delete any proxy server instance in either an UNKNOWN or a RUNNING state.

8.1.3 Uninstalling a Replication Gateway Instance

You can use a graphical user interface, a command-line utility, or a script to uninstall a replication gateway server instance.

This section covers the following topics:

Note:

Should the replication gateway uninstallation fail, for any reason, references to the gateway might remain in the ODSEE server configuration. In this case, remove the following from the ODSEE server configuration manually:

The replication manager entry that is created automatically when the gateway is installed.
The replication agreement(s) to the gateway.

8.1.3.1 Uninstalling a Replication Gateway Instance Using the GUI

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:
On UNIX and Linux systems:
```
$ instance-dir/OUD/uninstall
```
On Windows systems:
```
C:\> instance-dir\OUD\uninstall.bat
```
On the Oracle Unified Directory Server Settings screen, enter the following information:
- The host name on which the replication gateway server instance is installed.
- The UID of the Global Administrator used to connect to the Oracle Unified Directory servers.
- The password of the Global Administrator.
Click Next.
On the ODSEE Server settings screen, enter the following information:
- The bind DN and password of the user configured to connect to the ODSEE server.
- The DSCC Directory Server Manager Password
Click Next.
On the Confirm Replication Gateway Uninstall screen, click Finish.
Review the logs to confirm the file or directory removals. UNIX and Linux 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
```

8.1.3.2 Uninstalling a Replication Gateway Instance 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.

Before you start the uninstall, you must have the bind credentials for:

the Global Administrator used to connect to the OUD server instances
the administrative user who connects to the ODSEE server instance

The following example provides these credentials at the command-line.

Launch the CLI uninstaller, as follows:

On UNIX and Linux systems:

$ instance-dir/OUD/uninstall --cli -h server1.example.com \
  --adminUID admin --adminPasswordFile pwd-filename \
  --bindDNLegacy "cn=Directory Manager" --bindPasswordFileLegacy pwd-filename \
  --dsccPasswordFileLegacy pwd-file

On Windows systems:

C:\> instance-dir\OUD\uninstall.bat --cli -h server1.example.com \
  --adminUID admin --adminPasswordFile pwd-filename \
  --bindDNLegacy "cn=Directory Manager" --bindPasswordFileLegacy pwd-filename \
  --dsccPasswordFileLegacy pwd-file

Type 1 to uninstall the gateway.
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
```

8.1.3.3 Uninstalling a Replication Gateway Instance 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 deinstallation script and add the following uninstall command.

You must type the command on a single line.

instance-dir/OUD/uninstall --cli -h hostname \ 
--adminUID admin --adminPasswordFile pwd-filename \
--bindDNLegacy bindDN --bindPasswordFileLegacy pwd-filename \
--dsccPasswordFileLegacy pwd-filename --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.

8.1.3.4 Deleting a Replication Gateway Instance Using WLST

You can delete a replication gateway instance by using the WLST command oud_deleteInstance.

To delete a replication gateway instance by using WLST:

Connect to WLST as described in Setting Up the Replication Gateway Using the WebLogic Scripting Tool.
At the command prompt, enter:
```
oud_deleteInstance(instanceName='instanceName')
```
For example, to delete a replication gateway instance named oud_replication_gateway use the following command:
```
oud_deleteInstance(instanceName='oud_replication_gateway')
```
You cannot delete any replication gateway instance in either an UNKNOWN or a RUNNING state.

8.1.4 Removing the Oracle Unified Directory Software

You can run the deinstall.sh script (UNIX) or the deinstall.cmd command (Windows) to remove the Oracle Unified Directory software from your system.

To uninstall the Oracle Unified Directory software:

Change to the following directory:
On UNIX or Linux systems:
```
$ cd $ORACLE_HOME/oui/bin
```
On Windows systems, change to:
```
C:\> ORACLE_HOME\oui\bin
```
Enter the following command:
On UNIX or Linux systems:
```
./deinstall.sh
```
On Windows systems:
```
deinstall.cmd
```
On the Welcome screen, click Next.
On the Deinstall Oracle Home screen, verify the location of what is being uninstalled and click Deinstall.

You are prompted to check that no Application Server is associated with the ORACLE_HOME that you are about to deinstall.
A Warning screen that indicates the directories that will be uninstalled is displayed. Click Yes to continue with the deinstallation.
On the Deinstallation Complete screen, click Finish.

The ORACLE_HOME directory and all of its contents are removed.