Oracle® Application Server Installation Guide
10g Release 2 (10.1.2) for hp HP-UX Itanium, and Linux Itanium Part No. B15870-01 |
|
![]() Previous |
![]() Next |
This appendix guides you through the deinstallation and reinstallation process for Oracle Application Server.
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 ORACLE_HOME/bin/deconfig.pl
script. Use the Perl interpreter provided with Oracle Application Server.
prompt> cd $ORACLE_HOME/bin prompt> $ORACLE_HOME/perl/bin/perl deconfig.pl [-u oid_user] [-w password] [-r realm] [-dbp sys_db_password]
If you run it without any parameters, then the tool prompts you for the necessary information.
-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.
Follow these high-level steps to deinstall Oracle Application Server (the details are provided in later sections):
Run the Deconfig tool on the instance.
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 10g Release 2 (10.1.2) instances, you have to clean up the items listed in Table D-1. The procedures are described later in this appendix.
Table D-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 |
Entries for the deleted instance in the Inventory directory | Installer |
Instance name from Farm page | Installer |
Entries for the deleted instance in the /var/opt/oracle or /etc directory
|
You have to remove the entries manually. See:
|
Entries for the deleted instance in Oracle Internet Directory | Deconfig tool |
Note: The installer does not permit custom deinstallation of individual components. |
To deinstall Oracle Application Server Middle Tier:
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.
Run the Deconfig tool.
prompt> cd $ORACLE_HOME/bin prompt> $ORACLE_HOME/perl/bin/perl deconfig.pl [parameters]
See Section D.1, "New Tool: Deconfig Tool" for parameter details.
Start the installer.
prompt> $ORACLE_HOME/oui/bin/runInstaller
Follow these steps in the installer.
Welcome screen: Click Deinstall Products.
Inventory screen: Select the instance you want to deinstall, and click Remove.
Confirmation screen: Verify the components selected for deinstallation. Click Yes to continue.
Deinstallation Progress screen: Monitor the progress of the deinstallation.
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 middle-tier 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
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 oraInstall
timestamp
.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.
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.