F Deinstallation and Reinstallation

F.1 New Tool: Deconfig Tool

In this release, there is a new tool called the Deconfig tool that you need to run as part of the deinstallation procedure. This tool removes entries in OracleAS Metadata Repository and Oracle Internet Directory for the Oracle Application Server instance that you want to deinstall.

The Deconfig tool does not remove partner application entries. If you need to remove partner application entries, follow the steps in Section H.4.1, "Obsolete Partner URLs Still Remain on the OracleAS Single Sign-On Administration Screen".

The Deconfig tool does not remove OracleAS Clusters from the farm. If you are deinstalling OracleAS Cluster, you will need to run the dcmctl removecluster command after deinstalling the instances. See Section F.5, "Deinstalling OracleAS Cluster (Identity Management)"for details.

To run the Deconfig tool, run the Perl interpreter on the ORACLE_HOME\bin\deconfig.pl script. Use the Perl interpreter provided with Oracle Application Server.

C:\> cd ORACLE_HOME\bin
C:\> ORACLE_HOME\perl\5.6.1\bin\MSWin32-x86\perl.exe deconfig.pl [-u oid_user]
         [-w password] [-r realm] [-dbp sys_db_password]

If you run it without any parameters, the tool prompts you for the necessary information.

C:\> ORACLE_HOME\perl\5.6.1\bin\MSWin32-x86\perl.exe deconfig.pl -h
 - or -
C:\> ORACLE_HOME\perl\5.6.1\bin\MSWin32-x86\perl.exe deconfig.pl -help

F.2 Deinstallation Procedure: Overview

Follow these high-level steps to deinstall Oracle Application Server (the details are provided in later sections):

1. Deinstall middle-tier instances first.

   1. Run the Deconfig tool on the instance.

   2. Run the installer and click the Deinstall Products button.

   3. Clean up any remaining files.

2. Then deinstall OracleAS Infrastructure instances.

   1. Run the Deconfig tool on the instance.

   2. Run the installer and click the Deinstall Products button.

   3. Clean up any remaining files.

Notes:

• If you used OracleAS Metadata Repository Creation Assistant to install the OracleAS Metadata Repository on an existing database, and you want to remove the OracleAS Metadata Repository, select the "Remove" option in OracleAS Metadata Repository Creation Assistant. You can also use OracleAS Metadata Repository Creation Assistant to remove the registration from Oracle Internet Directory.

• If you remove an infrastructure instance, all middle-tier instances that depend on that infrastructure will no longer work.

  If you want to keep the middle-tier instances, you can configure them to use services from another infrastructure. See the Oracle Application Server Administrator's Guide for details.

Items to Remove or Clean Up

To deinstall Oracle Application Server instances, you have to clean up the items listed in Table F-1. The procedures for doing so are described later in this appendix.

The installer does not permit custom deinstallation of individual components.

F.3 Deinstalling OracleAS Cold Failover Cluster Installations

If you are deinstalling an OracleAS Cold Failover Cluster installation:

1. Take all the resources in the Oracle Fail Safe group offline.

2. Then perform the steps described in this appendix.

If you do not take the resources offline, the installer will hang during the deinstallation because Oracle Fail Safe is trying to fail over the resources.

F.4 Deinstalling OracleAS Single Sign-On Instances in OracleAS Cluster (Identity Management)

If you have multiple OracleAS Single Sign-On instances installed in a cluster against the same Oracle Internet Directory and you would like to deinstall some of the instances but keep others running, perform the following steps before running the Deconfig tool.

Note that if the OracleAS Single Sign-On instance that you wish to deinstall was the last instance to be installed against the Oracle Internet Directory, you should not perform this step. Instead, perform the steps in Section F.7, "Deinstalling OracleAS Infrastructure".

1. Open the file located at ORACLE_HOME\deconfig\DeconfigWrapper.properties for editing.

2. Search for the line that begins with "SSO=". For example, the line might look like the following:

   SSO=C:\OraHome_1/jdk/bin/java -jar C:\OraHome_1/sso/lib/ossoca.jar deinstall C:\OraHome_1 "%OID_USER%" %OID_PASSWORD%
   
   

3. Comment out the line by adding a pound (#) character at the beginning of the line. In the example above, the line would be changed to look like the following:

   # SSO=C:\OraHome_1/jdk/bin/java -jar C:\OraHome_1/sso/lib/ossoca.jar deinstall C:\OraHome_1 "%OID_USER%" %OID_PASSWORD%
   
   

After modifying the file, perform the steps in Section F.7, "Deinstalling OracleAS Infrastructure" to complete the deinstallation.

F.5 Deinstalling OracleAS Cluster (Identity Management)

To deinstall an OracleAS Cluster (Identity Management), perform the following steps.

1. Deinstall all instances that contain OracleAS Single Sign-On except for the last instance installed. Use the steps in Section F.4, "Deinstalling OracleAS Single Sign-On Instances in OracleAS Cluster (Identity Management)" to perform the deinstallation.

2. Deinstall the last OracleAS Single Sign-On instance using the steps in Section F.7, "Deinstalling OracleAS Infrastructure".

3. If you are using a Distributed OracleAS Cluster (Identity Management), deinstall the Oracle Internet Directory instances using the steps in Section F.7, "Deinstalling OracleAS Infrastructure".

4. After deinstalling all instances, remove the OracleAS Cluster (Identity Management) from its farm by running the dcmctl removecluster command:

   C:\> ORACLE_HOME\dcm\bin\dcmctl removecluster -cl cluster_name
   
   

F.6 Deinstalling Middle Tiers

1. Log in as the operating system user who installed the instance you want to deinstall.

2. Stop all processes associated with the instance you want to deinstall.

   See the Oracle Application Server Administrator's Guide for details on how to stop the processes.

3. Run the Deconfig tool.

   C:\> cd ORACLE_HOME\bin
   C:\> ORACLE_HOME\perl\5.6.1\bin\MSWin32-x86\perl.exe deconfig.pl [parameters]
   
   

   See Section F.1, "New Tool: Deconfig Tool" for parameter details.

4. Start the installer.

   Select Start > Programs > Oracle - OracleHomeName > Oracle Installation Products > Universal Installer.

5. Follow these steps in the installer.

   1. Welcome screen: Click Deinstall Products.

   2. Inventory screen: Select the instance you want to deinstall, and click Remove.

   3. Confirmation screen: Verify the components selected for deinstallation. Click Yes to continue.

   4. Deinstallation Progress screen: Monitor the progress of the deinstallation.

   5. Exit the installer when the deinstallation is complete.

6. Restart your computer to stop any remaining processes associated with the deinstallation.

   
   

   Note: The Oracle<OracleHomeName>ProcessManager and Oracle<OracleHomeName>ASControl services may appear on the Services control panel following deinstallation. These services will go away after the computer is restarted.

   
   

7. Delete any remaining files in the deleted instance's Oracle home directory.

   C:\> del %ORACLE_HOME%
   
   

8. The installer does not remove all entries from the Windows registry. If you want to remove all registry entries, see Section F.10, "Deinstalling All Oracle Products Manually".

   
   

   Note: The procedure in Section F.10, "Deinstalling All Oracle Products Manually" removes registry entries for all Oracle products from your computer. Do not perform this procedure if you have other Oracle Application Server instances or other Oracle products (such as Oracle database or Oracle Developer Suite) on your computer and you want to keep them.

   
   

9. Note that OracleAS Portal entries in Oracle Internet Directory are not removed by the Deconfig tool or the installer.

F.7 Deinstalling OracleAS Infrastructure

This section describes how to deinstall OracleAS Infrastructure instances.

F.8 Deinstalling OracleAS Developer Kits

1. Log in as the operating system user who installed OracleAS Developer Kits.

2. Stop all processes associated with the instance you want to deinstall.

   See the Oracle Application Server Administrator's Guide for details on how to stop the processes.

3. Start the installer.

   Select Start > Programs > Oracle - OracleHomeName > Oracle Installation Products > Universal Installer.

4. Follow these steps in the installer.

   1. Welcome screen: Click Deinstall Products.

   2. Inventory screen: Select the instance you want to deinstall, and click Remove.

   3. Confirmation screen: Verify the components selected for deinstallation. Click Yes to continue.

   4. Deinstallation Progress screen: Monitor the progress of the deinstallation.

   5. Exit the installer when the deinstallation is complete.

5. Restart your computer to stop any remaining processes associated with the deinstallation.

6. Delete any remaining files in the deleted instance's Oracle home directory.

   C:\> del %ORACLE_HOME%
   
   

7. The installer does not remove all entries from the Windows registry. If you want to remove all registry entries, see Section F.10, "Deinstalling All Oracle Products Manually".

   
   

   Note: The procedure in Section F.10, "Deinstalling All Oracle Products Manually" removes registry entries for all Oracle products from your computer. Do not perform this procedure if you have other Oracle Application Server instances or other Oracle products (such as Oracle database or Oracle Developer Suite) on your computer and you want to keep them.

   
   

F.9 Harmless Errors in the Log File

If you get the following "unable to delete file" and "unable to find make file" errors in the oraInstalltimestamp.err file after you deinstall J2EE and Web Cache or Portal and Wireless instances, these are harmless error messages.

Ignoring Exception during de-install oracle.sysman.oii.oiil.OiilDeinstallException:
An error occurred during runtime. oracle.sysman.oii.oiil.OiilDeinstallException:
An error occurred during runtime.
...
Ignoring Exception during de-install oracle.sysman.oii.oiil.OiilDeinstallException:
Unable to delete file 
/home/j2ee/sysman/emd/targets.xml
oracle.sysman.oii.oiil.OiilDeinstallException: Unable to delete file
/home/j2ee/sysman/emd/targets.xml
at instantiateFileEx.deinstallAction(instantiateFileEx.java:935)
...
Ignoring Exception during de-installoracle.sysman.oii.oiil.OiilDeinstallException:
Unable to find make file:
/home/j2ee/network/lib/ins_net_client.mk
oracle.sysman.oii.oiil.OiilDeinstallException: Unable to find make file:
/home/j2ee/network/lib/ins_net_client.mk
at ssmakeux.deinstallAction(ssmakeux.java:246)
...

F.10 Deinstalling All Oracle Products Manually

The following procedure removes all Oracle products from your computer.

1. Delete Registry keys.

   1. Select Start > Run, type in regedit, and click OK. This displays the Registry Editor.

   2. Delete the following folders from the Registry. To delete a folder, select it and select Edit > Delete from the menu.

      In some of the entries below, OracleHomeName indicates the name of the Oracle home, which you entered in the Specify File Locations screen, and Number indicates a random number added to the Oracle home name.

      • HKEY_LOCAL_MACHINE / SOFTWARE / ORACLE

      • HKEY_LOCAL_MACHINE / SYSTEM / CurrentControlSet / Services / OracleHomeName Number

      • HKEY_LOCAL_MACHINE / SYSTEM / ControlSet X / Services / OracleHomeName Number

        X is a number, for example, 001.

      • HKEY_CURRENT_USER / Software / OracleHomeName Number

      • HKEY_CLASSES_ROOT / ORACLE

   3. Exit the Registry Editor.

2. Edit/delete environment variables.

   To display environment variables:

   • Right-click My Computer (on Windows 2003, the icon is labeled with the name of your computer) on the desktop and select Properties. Select the Advanced tab, then click Environment Variables.

   1. Delete the following system variables if they exist:

      • DISCO_JRE

      • DISCO_VBROKER

      • VBROKER_JAVAVM

      • VBROKER_TAG -D

      • WV_GATEWAY_CFG

   2. Modify the Path system variable to remove all references to any previous Oracle home paths:

      Highlight the Path system variable. Click the Edit button and modify the path in the Variable Value field.

      For example, the following shows an Oracle-modified Path system variable:

      C:\OraHome\jdk\jre\bin\classic;C:\OraHome\jdk\jre\bin;C:\OraHome\bin;
      C:\OraHome\jlib;C:\OraHome\jre\1.1.8\bin;C:\WINNT\system32;C:\WINNT;
      C:\WINNT\System32\Wbem
      
      

      The following shows the Path system variable after removal of the Oracle home references:

      C:\WINNT\system32;C:\WINNT;C:\WINNT\System32\Wbem
      
      

3. Click OK

4. Remove Oracle program folders.

   Click Start > Programs (Windows 2000) or Start > All Programs (Windows 2003 or Windows XP). Remove Oracle folders by right-clicking on the folder and selecting Delete.

5. Delete the Oracle user.

   1. Right-click My Computer (on Windows 2003, the icon is labeled with the name of your computer) and select Manage.

   2. Expand Local Users and Groups.

   3. Select Users.

   4. Delete the user that installed Oracle products.

   5. Double click My Computer on your desktop. Inspect the Documents and Settings directory on your hard drive and delete any Oracle user entries.

6. Restart your computer.

7. Remove remaining Oracle home directories from your hard drive.

   For example:

   C:\Oracle\*, C:\Program Files\Oracle\*

8. Restart your computer.

F.11 Reinstallation

The installer does not allow reinstallation of an Oracle Application Server instance in a directory that already contains an Oracle Application Server instance. To reinstall Oracle Application Server in the same directory, you have to deinstall and then install it.

F.12 Troubleshooting

See Section H.4, "Deinstallation Problems and Solutions" for help with common deinstallation problems.