C Deinstallation and Reinstallation

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

Section C.1, "Deinstallation Procedure:Overview"
Section C.2, "Deinstalling Procedure"
Section C.3, "Cleaning Up Oracle Application Server Processes"
Section C.4, "Reinstallation"

C.1 Deinstallation Procedure: Overview

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

Run the installer and click the Deinstall Products button.
Clean up any remaining files.

Items to Remove or Clean Up

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

Table C-1 Items to Deinstall

Item to Clean Up	Tool to Use
Files from the Oracle home directory	Installer If the installer does not remove all the files, you can remove the remaining files using the `rm` command.
Entries for the deleted instance in the Inventory directory	Installer
Instance name from Farm page	Installer
Entries for the deleted instance in the `/etc` directory	You have to remove the entries manually. See Step 6.

The installer does not permit custom deinstallation of individual components.

C.2 Deinstalling Procedure

Log in as the operating system user who installed the instance you want to deinstall.
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.

Start the installer.


prompt> $ORACLE_HOME/oui/bin/runInstaller

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.
Delete any remaining files in the deleted instance's Oracle home directory.
```
prompt> rm -rf $ORACLE_HOME
```
Remove the line for the deinstalled instance from the /etc/oratab file.

Towards the end of the file, you should see lines that specify the Oracle home directory. Remove the line for the Oracle home that you deinstalled. For example, if your Oracle home is /private1/j2ee, the line would look like the following:
```
*:/private1/j2ee:N
```

C.3 Cleaning Up Oracle Application Server Processes

If you forgot to shut down Oracle Application Server processes before starting the installation, you have to kill the processes because the files for these processes are deleted. To check for processes that are still running, run the ps command:


prompt> ps -ef

To kill a process, use the kill command:


prompt> kill -9 process_id

You can determine the process_id from the ps command.

If you need to shut down the dcmctl shell process, you can try exiting the shell by typing exit.

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