Oracle® Application Server Installation Guide
10g Release 2 (10.1.2) for Microsoft Windows Part No. B14094-02 |
|
![]() Previous |
![]() Next |
This appendix guides you through the deinstallation and reinstallation process for Oracle Application Server.
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.
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.
-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 OracleAS Single Sign-On, make sure the user has privileges to configure these components. For a list of components and groups that grant the privileges, see Section 8.3, "Groups Required to Configure or Deinstall Components".
If you want to run the tool as the Oracle Internet Directory superuser, be sure to use cn=orcladmin
, and not just orcladmin
. These are two different users. If you want more details about these users, see Section 8.1, "Default Users in Oracle Internet Directory".
-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, 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:
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
Follow these high-level steps to deinstall Oracle Application Server (the details are provided in later sections):
Deinstall middle-tier instances first.
Run the Deconfig tool on the instance.
Run the installer and click the Deinstall Products button.
Clean up any remaining files.
Then deinstall OracleAS Infrastructure instances.
Run the Deconfig tool on the instance.
Run the installer and click the Deinstall Products button.
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 10g Release 2 (10.1.2) instances, you have to clean up the items listed in Table F-1. The procedures for doing so are described later in this appendix.
Table F-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 Windows registry | Deconfig tool
What we had in 9.0.4: You have to remove the entries manually. See Section F.8, "Deinstalling All Oracle Products Manually". Note: You can remove the entries only if the computer is not running other Oracle Application Server instances or other Oracle products, because the procedure described in the section removes entries for all Oracle products. |
Entries for the deleted instance in Oracle Internet Directory | Deconfig tool |
The installer does not permit custom deinstallation of individual components.
If you are deinstalling an OracleAS Cold Failover Cluster installation:
Take all the resources in the Oracle Fail Safe group offline.
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.
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.
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.
Start the installer.
Select Start > Programs > Oracle - OracleHomeName > Oracle Installation Products > Universal Installer.
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.
Restart your computer to stop any remaining processes associated with the deinstallation.
Delete any remaining files in the deleted instance's Oracle home directory.
C:\> del %ORACLE_HOME%
The installer does not remove all entries from the Windows registry. If you want to remove all registry entries, see Section F.8, "Deinstalling All Oracle Products Manually".
Note: The procedure in Section F.8, "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. |
Note that OracleAS Portal entries in Oracle Internet Directory are not removed by the Deconfig tool or the installer.
This section describes how to deinstall OracleAS Infrastructure instances.
The OracleAS Infrastructure instance could contain all the OracleAS Infrastructure components, or it could contain only a subset of the components, because you have a distributed OracleAS Infrastructure installation. Here are some common scenarios and their deinstallation order:
If you have an Identity Management + OracleAS Metadata Repository instance, you have only one instance to deinstall.
If you installed Identity Management and OracleAS Metadata Repository separately:
Deinstall the Identity Management instance.
Deinstall the OracleAS Metadata Repository.
If you have a distributed Identity Management:
Deinstall the instance(s) that are running OracleAS Single Sign-On, Oracle Delegated Administration Services, Oracle Directory Integration and Provisioning, and/or OracleAS Certificate Authority.
Deinstall the instance running Oracle Internet Directory.
Deinstall the OracleAS Metadata Repository.
Log in as the operating system user who installed the instance you want to deinstall.
If OracleAS Certificate Authority is configured on the instance you want to deinstall, run the following commands:
C:\> %ORACLE_HOME%\oca\bin\ocactl stop C:\> %ORACLE_HOME%\oca\bin\cmdeinst ocaAdminPassword oidAdminPassword
Replace ocaAdminPassword with the password of the OracleAS Certificate Authority administrator.
Replace oidAdminPassword with the password of the Oracle Internet Directory user who installed OracleAS Certificate Authority. The user must belong to the following groups:
Trusted Application Admins
iAS Admins
Repository Owners group for the metadata repository used by OracleAS Certificate Authority
The "ocactl
stop
" command stops OCA services. The cmdeinst
command performs the following actions:
removes OracleAS Certificate Authority entries from Oracle Internet Directory
removes data from tables in the oca
schema
removes OracleAS Certificate Authority files created by the OracleAS Certificate Authority Configuration Assistant during installation
If Oracle Directory Integration and Provisioning is configured and running in the instance you want to deinstall, stop the Oracle Directory Integration and Provisioning server.
Ensure that Oracle Internet Directory is running.
You can stop Oracle Directory Integration and Provisioning by running the following command:
C:\> cd ORACLE_HOME/bin C:\> oidctl connect=db_connect_string server=odisrv instance=1 stop
db_connect_string is the service name as listed in the file ORACLE_HOME\network\admin\tnsnames.ora
.
For any additional Oracle Directory Integration and Provisioning servers that you started, you must stop them too. See the instructions in the Oracle Identity Management Integration Guide.
If Oracle Internet Directory is configured as a replica, you need to delete this node from the directory replication group (DRG). See Chapter 25, "Oracle Internet Directory Replication Administration", in the Oracle Internet Directory Administrator's Guide for steps.
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. Note: If you are deinstalling an instance that includes the Oracle Internet Directory or OracleAS Single Sign-On components, you need to run the Deconfig tool as the Oracle Internet Directory superuser (cn=orcladmin
). If the instance does not include Oracle Internet Directory or OracleAS Single Sign-On, then you need to run the tool as a user with the proper privileges, as shown in Table 8-4.
Start the installer.
Select Start > Programs > Oracle - OracleHomeName > Oracle Installation Products > Universal Installer.
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.
Restart your computer to stop any remaining processes associated with the deinstallation.
Delete any remaining files in the deleted instance's Oracle home directory.
C:\> del %ORACLE_HOME%
The installer does not remove all entries from the Windows registry. If you want to remove all registry entries, see Section F.8, "Deinstalling All Oracle Products Manually".
Note: The procedure in Section F.8, "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. |
Log in as the operating system user who installed OracleAS Developer Kits.
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.
Select Start > Programs > Oracle - OracleHomeName > Oracle Installation Products > Universal Installer.
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.
Restart your computer to stop any remaining processes associated with the deinstallation.
Delete any remaining files in the deleted instance's Oracle home directory.
C:\> del %ORACLE_HOME%
The installer does not remove all entries from the Windows registry. If you want to remove all registry entries, see Section F.8, "Deinstalling All Oracle Products Manually".
Note: The procedure in Section F.8, "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. |
If you get the following "unable to delete file" and "unable to find make file" errors in the oraInstall
timestamp
.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) ...
The following procedure removes all Oracle products from your computer.
Caution: These 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.
Select Start > Run, type in regedit, and click OK. This displays the Registry Editor.
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
Exit the Registry Editor.
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.
Delete the following system variables if they exist:
DISCO_JRE
DISCO_VBROKER
VBROKER_JAVAVM
VBROKER_TAG -D
WV_GATEWAY_CFG
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
Click OK
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.
Delete the Oracle user.
Right-click My Computer (on Windows 2003, the icon is labeled with the name of your computer) and select Manage.
Expand Local Users and Groups.
Select Users.
Delete the user that installed Oracle products.
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.
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.
See Section H.4, "Deinstallation Problems and Solutions" for help with common deinstallation problems.