There are two steps to uninstalling Oracle Unified Directory from your system:
Uninstall the server instances that you have configured
Remove the software itself from the system
This chapter provides instructions for both steps. You must uninstall the server instances before you uninstall the software.
This chapter contains the following topics:
Section 9.1, "Uninstalling an Oracle Unified Directory Instance"
Section 9.2, "Uninstalling the Oracle Unified Directory Software"
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 the Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.
You can uninstall a directory server instance by using the graphical user interface, or the command line.
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.
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
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.
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
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.
You can uninstall a proxy server instance by using the graphical user interface, or the command line.
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.
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
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.
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
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.
You can uninstall a replication gateway server instance by using the graphical user interface, or the command line. This section covers the following topics:
Section 9.1.3.1, "To Uninstall a Replication Gateway Instance in GUI Mode"
Section 9.1.3.2, "To Uninstall a Replication Gateway Instance by Using the CLI"
Section 9.1.3.3, "To Uninstall a Replication Gateway Instance by Using a Script"
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.
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
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 bind DN and password of the user configured to connect to the ODSEE server.
Click Next.
On the Confirm Replication Gateway Uninstall screen, click Finish.
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
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:
(UNIX, Linux) $ instance-dir/OUD/uninstall --cli -h server1.example.com \ --adminUID admin --adminPasswordFile pwd-filename \ --bindDNLegacy "cn=Directory Manager" --bindPasswordFileLegacy pwd-filename (Windows) C:\> instance-dir\OUD\uninstall.bat --cli -h server1.example.com \ --adminUID admin --adminPasswordFile pwd-filename \ --bindDNLegacy "cn=Directory Manager" --bindPasswordFileLegacy pwd-filename
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
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.
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 \ --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.
To remove the Oracle Unified Directory software from your system, run the uninstaller, as follows:
Change to the $ORACLE_HOME/oui/bin
directory.
$ cd $ORACLE_HOME/oui/bin
On Windows systems, change to the $ORACLE_HOME\oui\bat
directory.
Run the Oracle Universal Installer with the -deinstall
option.
$ ./runInstaller -deinstall
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 uninstall.
A Warning screen is displayed, that indicates the directories that will be uninstalled. Click Yes to proceed with the uninstallation.
On the Deinstallation Complete screen, click Finish.
The ORACLE_HOME
directory and all of its contents are removed.