Skip Headers
Oracle® Fusion Middleware Installation Guide for Oracle Unified Directory
11g Release 2 (11.1.2)

Part Number E23737-05
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
PDF · Mobi · ePub

9 Uninstalling Oracle Unified Directory

There are two steps to uninstalling Oracle Unified Directory from your 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:

9.1 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:

For more information about the uninstall command, see uninstall in the Oracle Fusion Middleware Administrator's Guide for Oracle Unified Directory.

9.1.1 Uninstalling a Directory Server Instance

You can uninstall a directory server instance by using the graphical user interface, or the command line.

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

  1. Launch the graphical uninstaller, as follows:

    (UNIX, Linux) $ instance-dir/OUD/uninstall
    (Windows)     C:\> instance-dir\OUD\uninstall.bat
    
  2. Deselect any components that you do not want to remove and click Uninstall.

    By default, all components are selected for removal.

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

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

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

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

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

  1. Launch the CLI uninstaller, as follows:

    (UNIX, Linux) $ instance-dir/OUD/uninstall --cli
    (Windows)     C:\> instance-dir\OUD\uninstall.bat --cli
    
  2. 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.

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

  4. 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).

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

  6. Check that all files and directories have been removed. If they have not been removed, manually remove them.

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

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

  1. 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
    
  2. Run the script.

  3. Check for remaining directories in the logs, and if any directories or files remain, manually delete them.

9.1.2 Uninstalling a Proxy Server Instance

You can uninstall a proxy server instance by using the graphical user interface, or the command line.

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

  1. Launch the graphical uninstaller, as follows:

    (UNIX, Linux) $ instance-dir/OUD/uninstall
    (Windows)     C:\> instance-dir\OUD\uninstall.bat
    
  2. Deselect any components that you do not want to remove and click Uninstall.

    By default, all components are selected for removal.

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

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

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

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

  1. Launch the CLI uninstaller, as follows:

    (UNIX, Linux) $ instance-dir/OUD/uninstall --cli
    (Windows)     C:\> instance-dir\OUD\uninstall.bat --cli
    
  2. 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.

  3. 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).

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

  5. Check that all files and directories have been removed. If they have not been removed, manually remove them.

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

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

  1. 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
    
  2. Run the script.

  3. Check for remaining directories in the logs, and if any directories or files remain, manually delete them.

9.1.3 Uninstalling a Replication Gateway Instance

You can uninstall a replication gateway server instance by using the graphical user interface, or the command line. 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.

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

  1. Launch the graphical uninstaller, as follows:

    (UNIX, Linux) $ instance-dir/OUD/uninstall
    (Windows)     C:\> instance-dir\OUD\uninstall.bat
    
  2. 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.

  3. On the ODSEE Server settings screen, enter the bind DN and password of the user configured to connect to the ODSEE server.

    Click Next.

  4. On the Confirm Replication Gateway Uninstall screen, click Finish.

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

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

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

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.

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

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

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

  1. 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
    
  2. Run the script.

  3. Check for remaining directories in the logs, and if any directories or files remain, manually delete them.

9.2 Uninstalling the Oracle Unified Directory Software

To remove the Oracle Unified Directory software from your system, run the uninstaller, as follows:

  1. Change to the $ORACLE_HOME/oui/bin directory.

    $ cd $ORACLE_HOME/oui/bin
    

    On Windows systems, change to the $ORACLE_HOME\oui\bat directory.

  2. Run the Oracle Universal Installer with the -deinstall option.

    $ ./runInstaller -deinstall
    
  3. On the Welcome screen, click Next.

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

  5. A Warning screen is displayed, that indicates the directories that will be uninstalled. Click Yes to proceed with the uninstallation.

  6. On the Deinstallation Complete screen, click Finish.

  7. The ORACLE_HOME directory and all of its contents are removed.