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:
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.
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.
-
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 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 theTEMP
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.
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.
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.
-
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
). -
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 theTEMP
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.
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.
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.
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.
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.