Oracle® Collaboration Suite Installation Guide 10g Release 1 (10.1.2) for Microsoft Windows Part Number B25463-03 |
|
|
View PDF |
This appendix guides you through the deinstallation and reinstallation process for Oracle Collaboration Suite.
Section J.4, "Deinstalling Oracle Collaboration Suite Database"
Section J.5, "Deinstalling Oracle Collaboration Suite Infrastructure"
You must run the Deconfig tool as a part of the deinstallation procedure. This tool removes entries in OracleAS Metadata Repository and Oracle Internet Directory for the Oracle Collaboration Suite instance that you want to deinstall.
Note: You will need to set the ORACLE_HOME and ORACLE_SID variables before starting the deinstallation process. |
To run the Deconfig tool, use the following commands.
Drive_Letter:\> cd %ORACLE_HOME%\bin Drive_Letter:\> ocsdeconfig.bat [-u oid_user] [-w password]
If you run the tool without any parameters, it prompts you for the necessary information.
Caution: using the optional command line arguments-u oid_user and -w password poses a security risk and their usage is not recommended. |
Running the ./ocsdeconfig.sh
ocsdeconfig.bat
command calls the ocsdeconfig.pl
script, which passes the Oracle Internet Directory information to the DeconfigureWrapper.
-u oid_user
Specify the Oracle Internet Directory user.
Caution: using the optional command line argument-u oid_user poses a security risk and its usage is not recommended. |
You can specify the Oracle Internet Directory user using the simple name of the user or the distinguished name (DN) of the user. For example, the simple name of the user can be jdoe@mycompany.com
, which corresponds to the DN cn=jdoe,l=us,dc=mycompany,dc=com
.
The Oracle Internet Directory user must have privileges for deinstalling the components that are configured in the Oracle Collaboration Suite 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 Oracle Collaboration Suite 10g Infrastructure instance that is running Oracle Delegated Administration Services and Oracle Application Server Single Sign-On, make sure the user has privileges to configure these components.
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.
-w password
Specify the password for the Oracle Internet Directory user.
Caution: using the optional command line argument-w password poses a security risk and its usage is not recommended. |
-help or -h
You can also run the Deconfig tool with the -h
or -help
parameter to display help:
Drive_Letter:\> ocsdeconfig.pl -h - or - Drive_Letter:\> ocsdeconfig.pl -help
Follow these high-level steps to deinstall Oracle Collaboration Suite (the details are provided in later sections):
Deinstall Applications 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 the Infrastructure instances.
Run the installer and click the Deinstall Products button.
Clean up any remaining files.
Delete the Oracle home.
Note: If you plan to deinstall Oracle Collaboration Suite using Oracle Universal Installer, you will not be able to select Oracle Collaboration Suite components individually. All Oracle Collaboration Suite components, Oracle Collaboration Suite Infrastructure, Oracle Collaboration Suite Database, and Oracle Collaboration Suite Applications, will be deinstalled. |
Notes:
If you used Metadata Repository Creation Assistant to install the OracleAS Metadata Repository on an existing database, and you want to remove the OracleAS Metadata Repository, then select the Remove option. You can also use Metadata Repository Creation Assistant to remove the registration from Oracle Internet Directory.
If you remove an Infrastructure instance, all Applications tier instances that depend on that Infrastructure will no longer work.
To keep the Applications tier instances, you can configure them to use services from another Infrastructure. Refer to the Oracle Collaboration Suite Administrator's Guide for details.
Items to Remove or Clean Up
To deinstall Oracle Collaboration Suite instances, you must clean up the items listed in Table J-1. The procedures are described later in this appendix.
Table J-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 Windows registry | You must remove the entries manually. Refer to: |
Entries for the deleted instance in Oracle Internet Directory | Deconfig tool |
The installer does not permit custom deinstallation of individual components.
The following component-specific deconfiguration occurs when you deinstall an Applications tier instance:
Oracle Real-Time Collaboration
Oracle Discussions
Oracle Workspaces
Oracle Collaboration Suite Web Access
Oracle Mobile Collaboration
Oracle Content Services
Oracle Calendar Server
Oracle Calendar Application System
Oracle Mail
Oracle Collaboration Suite Search
To deinstall an Applications 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.
Refer to Oracle Collaboration Suite Administrator's Guide for details on how to stop the processes.
Run the Deconfig tool.
Drive_Letter:\> cd %ORACLE_HOME%\bin Drive_Letter:\> ocsdeconfig.bat [parameters]
Refer to Section J.1 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.
Delete any remaining files in the Oracle home directory of the deleted instance.
Drive_Letter:\> del %ORACLE_HOME%
The installer does not remove all entries from the Windows registry. To remove all registry entries, refer to Section F.8, "Deinstalling All Oracle Products Manually".
Note: The procedure in Section J.8 removes registry entries for all Oracle products from your computer. Do not perform this procedure if you have other Oracle Collaboration Suite instances or other Oracle products (such as Oracle Database or Oracle Application Server) on your computer and you want to keep them. |
You can use the ocsdeconfig
tool for deinstalling Oracle Collaboration Suite.
The following component-specific deconfiguration occurs when you deinstall Oracle Collaboration Suite using the ocsdeconfig
tool:
Oracle Content Services
Oracle Collaboration Suite Web Access
Oracle Voicemail & Fax (Windows only)
Oracle Mail
Oracle Workspaces
Oracle Calendar Server
Oracle Real-Time Collaboration
To deinstall Oracle Collaboration Suite in silent mode:
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.
Refer to the Oracle Collaboration Suite Administrator's Guide for details on how to stop the processes.
Run the Deconfig tool.
Drive_Letter:\> cd %ORACLE_HOME%\bin Drive_Letter:\> ocsdeconfig.bat [-u oid-user-name] [–w password]
Refer to Section J.1 for parameter details.
Caution: using the optional command line arguments-u oid_user and -w password poses a security risk and their usage is not recommended. |
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.
Delete any remaining files in the Oracle home directory of the deleted instance.
Drive_Letter:\> del %ORACLE_HOME%
The installer does not remove all entries from the Windows registry. To remove all registry entries, refer to Section F.8, "Deinstalling All Oracle Products Manually".
Note: The procedure in Section J.8 removes registry entries for all Oracle products from your computer. Do not perform this procedure if you have other Oracle Collaboration Suite instances or other Oracle products (such as Oracle Database or Oracle Application Server) on your computer and you want to keep them. |
This section describes how to deinstall Infrastructure instances.
The Infrastructure instance could contain all the Infrastructure components, or it could contain only a subset of the components, because you have a distributed 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 have a distributed Identity Management:
Deinstall the instance or instances that are running Oracle Application Server Single Sign-On, Oracle Delegated Administration Services, Oracle Directory Integration and Provisioning, and Oracle Application Server Certificate Authority.
Deinstall the instance running Oracle Internet Directory.
The deinstallation steps for Infrastructure are as follows:
Log in as the operating system user who installed the instance you want to deinstall.
If Oracle Application Server Certificate Authority is configured on the instance you want to deinstall, run the following commands:
Drive_Letter:\> %ORACLE_HOME%\oca\bin\ocactl stop Drive_Letter:\> %ORACLE_HOME%\oca\bin\cmdeinst ocaAdminPassword oidAdminPassword
Replace ocaAdminPassword with the password of the Oracle Application Server Certificate Authority administrator.
Replace oidAdminPassword with the password of the Oracle Internet Directory user who installed Oracle Application Server Certificate Authority. The user must belong to the following groups:
Trusted Application Admins
iAS Admins
Repository Owners group for the metadata repository used by Oracle Application Server Certificate Authority
The ocactl
stop
command stops OCA services. The cmdeinst
command performs the following actions:
Removes Oracle Application Server Certificate Authority entries from Oracle Internet Directory
Removes data from tables in the oca
schema
Removes Oracle Application Server Certificate Authority files created by the Oracle Application Server 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:
Drive_Letter:\> cd %ORACLE_HOME%\bin Drive_Letter:\> oidctl connect=db_connect_string server=odisrv instance=1 stop
In the preceding command, 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. Refer to the instructions in the Oracle Identity Management Integration Guide.
If Oracle Internet Directory is configured as a replica, you must delete this node from the directory replication group (DRG). Refer to Chapter 25, "Oracle Internet Directory Replication Administration", in the Oracle Internet Directory Administrator's Guide for steps.
Run the deconfig.pl
tool.
Drive_Letter:\> cd %ORACLE_HOME%\bin Drive_Letter:\> deconfig.pl
Start the installer.
Select Start, Programs, Oracle - OracleHomeName, Oracle Installation Products, Universal Installer.
Note: If you are running this deinstallation procedure on Solaris 5.10, then you must run the installer from the Oracle Collaboration Suite DVD and not from%ORACLE_HOME% \oui\bin . |
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 Oracle home directory of the deleted instance.
Drive_Letter:\> del %ORACLE_HOME%
The installer does not remove all entries from the Windows registry. To remove all registry entries, refer to Section J.8.
Note: The procedure in Section J.8 removes registry entries for all Oracle products from your computer. Do not perform this procedure if you have other Oracle Collaboration Suite instances or other Oracle products (such as Oracle Database or Oracle Application Server) on your computer and you want to keep them. |
Perform the following tasks to deinstall a Oracle Collaboration Suite Infrastructure and Applications installation on a single computer:
Log in as the operating system user who installed the instance you want to deinstall.
Start the installer, as follows:
Select Start, Programs, Oracle - OracleHomeName, Oracle Installation Products, Universal Installer.
Note: If you are running this deinstallation procedure on Solaris 5.10, then you must run the installer from the Oracle Collaboration Suite DVD and not from%ORACLE_HOME \oui\bin . |
On the Select Installation Method screen, select the Advanced Installation option and click Next.
On the Specify File Locations screen, click Installed Products.
The Inventory dialog box appears. For a single-computer installation, you will find the following items under Oracle Homes:
onebox_apps
onebox_infra
onebox
These items should be removed in the order they are listed in the preceding list.
Select onebox_apps and click Remove. Next, select onebox_infra and click Remove. Finally, select onebox and click Remove.
Exit the Installer.
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 Web Cache or Oracle Mobile Collaboration 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 following entries, 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
In the preceding entry, X is a number, for example, 001.
* HKEY_CURRENT_USER/SOFTWARE/OracleHomeName Number
* HKEY_CLASSES_ROOT/ORACLE
Exit the Registry Editor.
Edit or 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:
Drive_Letter:\OraHome\jdk\jre\bin\classic;Drive_Letter:\OraHome\jdk\jre\bin;Drive_Letter:\OraHome\bin; Drive_Letter:\OraHome\jlib;Drive_Letter:\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). 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:
Drive_Letter:\Oracle\*, C:\Program Files\Oracle\*
Restart your computer.