D Deinstallation and Reinstallation

This appendix guides you through the deinstallation and reinstallation process for Oracle Application Server.

Section D.1, "New Tool: Deconfig Tool"
Section D.2, "Deinstallation ProcedureOverview"
Section D.3, "Deinstalling Middle Tier"
Section D.4, "Harmless Errors in the Log File"
Section D.5, "Deinstalling All Oracle Products Manually"
Section D.6, "Reinstallation"

D.1 New Tool: Deconfig Tool

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.

To run the Deconfig tool, run the Perl interpreter on the script. Use the Perl interpreter provided with Oracle Application Server.

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

D.1.1 Parameters

-u oid_user

Specify the Oracle Internet Directory user.

You can specify the Oracle Internet Directory user using the user's simple name or the user's distinguished name (DN). For example, the user's simple name can be jdoe@mycompany.com, which corresponds to the DN cn=jdoe,l=us,dc=mycompany,dc=com.

The Oracle Internet Directory user needs to have privileges for deinstalling the components that are configured in the Oracle Application Server instance that you want to deinstall. These privileges are the same as for installing and configuring the component.

For example, if you are deinstalling an OracleAS Infrastructure instance that is running Oracle Delegated Administration Services and Oracle Application Server Single Sign-On, then make sure the user has privileges to configure these components.

If you want to run the tool as the Oracle Internet Directory superuser, then be sure to use cn=orcladmin, and not just orcladmin. These are two different users.

-w password

Specify the password for the Oracle Internet Directory user.

-r realm

Specify the realm in which to authenticate the user. This value is required only if your Oracle Internet Directory has more than one realm.

-dbp sys_db_password

Specify the password for the SYS user in the database. This is the OracleAS Metadata Repository database used by Oracle Internet Directory.

This value is required only if you are deinstalling an Identity Management-only instance that has Oracle Internet Directory configured.

If you specify this parameter and it is not needed, then the password value is simply not used.

-help or -h

You can also run the Deconfig tool with the -h or -help parameter to display help.

D.1.2 Log Files Generated by the Deconfig Tool

The Deconfig tool writes log entries to the ORACLE_HOME\cfgtoollogs\DeconfigureWrapper.log file.

D.2 Deinstallation Procedure Overview

To deinstall Oracle Application Server, perform the following high-level steps. The details are provided in later sections.

Deinstall the Oracle Application Server Middle Tier instance.
1. Run the Deconfig tool on the instance to remove entries in the Microsoft Windows registry.
2. Run the Oracle Universal Installer to deinstall the product.
3. Remove any remaining files.

Items to Remove or Clean Up

To deinstall an Oracle Application Server instance, you have to remove the items listed in Table D-1. The procedures for doing so are described later in this appendix.

Table D-1 Items to Deinstall

Items to Remove	Tool to Use
Files from the Oracle home directory	Installer If the installer does not remove all the files, then you can remove the remaining files using the `del` command.
Entries for the deleted instance in the Inventory directory	Installer
Instance name from Farm page	Installer
Entries for the deleted instance in the Microsoft Windows registry	Deconfig tool You can also remove the entries manually. Refer to Section D.5, "Deinstalling All Oracle Products Manually".

Note:

The installer does not permit custom deinstallation of individual components.

D.3 Deinstalling Middle Tier

To deinstall Oracle Application Server Middle Tier:

Log in as the operating system user.
Stop all processes associated with the instance.

See Also:
For details on how to stop the processes, refer to Oracle Application Server Administrator's Guide.
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 Also:
For details about the parameters, refer to Section D.1, "New Tool: Deconfig Tool".
Start the Oracle Universal Installer.

Select Start, Programs, Oracle, OracleHomeName, Oracle Installation Products, Universal Installer.
In the installer, perform the following steps:
1. In the Welcome screen, click Deinstall Products.
2. In the Inventory screen, select the instance that you want to deinstall, and click Remove.
3. In the Confirmation screen, verify the components selected for deinstallation. Click Yes to continue.
4. In the Deinstallation Progress screen, monitor the progress of the deinstallation.
5. Exit the installer after deinstallation is complete.
Restart your computer to stop any remaining processes associated with the deinstallation.
Delete any remaining files in the Oracle home directory of the instance that was deleted.
```
C:\> del %ORACLE_HOME%
```

The installer does not remove all entries from the Microsoft Windows registry. If you want to remove all registry entries, then refer to Section D.5, "Deinstalling All Oracle Products Manually".

Note:

The procedure in Section D.5, "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 if you want to keep them.

D.4 Harmless Errors in the Log File

After you deinstall the J2EE and Web Cache instance, you may get the unable to delete file and unable to find make file errors in the oraInstalltimestamp.err file. These error messages would appear as follows:

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

These are harmless error messages and you can ignore them.

D.5 Deinstalling All Oracle Products Manually

The following procedure removes all Oracle products from your computer.

Caution:

The following instructions remove all Oracle components, services, and registry entries from your computer. Exercise extreme care when removing registry entries. Removing incorrect entries can cause your computer to stop working.

Delete Registry keys.
1. Select Start, Run. Type in regedit, and click OK. The Registry Editor window is displayed.
2. Delete the following folders from the registry. To delete a folder, select the folder name, and click Edit, Delete from the menu.
  
  In some of the following entries, OracleHomeName indicates the name of the Oracle home, which you entered in the Specify File Locations screen of the installer, 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 window.
Edit or delete environment variables.

To display environment variables:
1. On the desktop, right-click My Computer (on Windows 2003, the icon is labeled with the name of your computer) and click Properties. Click the Advanced tab, and click Environment Variables.
2. Highlight the Path system variable. Click the Edit button and modify the path in the Variable Value field.
  
  This removes all references to any previous Oracle home paths.
  
  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.4.2\bin;C:\windows\system32;C:\windows;
C:\windows\System32\Wbem
```
  The following shows the Path system variable after removal of the Oracle home references:
```
C:\windows\system32;C:\windows;C:\windows\System32\Wbem
```
Click OK.
Click Start, All Programs. Right-click the folder and select Delete.

All Oracle program folders are removed.
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 name of the user who installed the Oracle product.
5. Double click My Computer on your desktop. Inspect the Documents and Settings directory on your hard drive and delete any Oracle user entries.
Restart your computer.
Remove remaining Oracle home directories from your hard drive.

For example:

C:\Oracle\*, C:\Program Files\Oracle\*
Restart your computer.

D.6 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 the existing instance and then install it.