Skip Headers
Oracle® Collaboration Suite Installation Guide
10g Release 1 (10.1.2) for AIX 5L Based Systems (64-Bit)

Part Number B25471-10
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Master Index
Master Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

J Deinstallation and Reinstallation

This appendix guides you through the deinstallation and reinstallation process for Oracle Collaboration Suite.

J.1 The Deconfig Tool

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.

prompt> cd $ORACLE_HOME/bin
prompt> ./ocsdeconfig.sh [-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 command calls the ocsdeconfig.pl script, which passes the Oracle Internet Directory information to the DeconfigureWrapper.

J.1.1 Parameters

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

-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:

prompt> $ORACLE_HOME/perl/bin/perl ocsdeconfig.pl -h
 - or -
prompt> $ORACLE_HOME/perl/bin/perl ocsdeconfig.pl -help

J.1.2 Log Files Generated by the Deconfig Tool

The Deconfig tool writes its log file to the ORACLE_HOME/cfgtoollogs/OCSDeconfigureWrapper.log file.

J.2 Overview of the Deinstallation Procedure

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

  1. Deinstall Applications tier instances first.

    1. Run the Deconfig tool on the instance.

    2. Run the installer and click the Deinstall Products button.

    3. Clean up any remaining files.

  2. Then deinstall the Infrastructure instances.

    1. Run the installer and click the Deinstall Products button.

    2. Clean up any remaining files.

    3. 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:

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 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 /var/opt/oracle or /etc directory

You must remove the entries manually. Refer to:

  • Step 7 if you are deinstalling Applications tiers.

  • Step 7 if you are deinstalling Oracle Collaboration Suite Database.

  • Step 9 if you are deinstalling Infrastructure.

Entries for the deleted instance in Oracle Internet Directory

Deconfig tool


The installer does not permit custom deinstallation of individual components.

J.3 Deinstalling Applications Tiers

The following component-specific deconfiguration occurs when you deinstall an Applications tier instance:

To deinstall an Applications tier:

  1. Log in as the operating system user who installed the instance you want to deinstall.

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

  3. Run the Deconfig tool.

    prompt> cd $ORACLE_HOME/bin
    prompt> ./ocsdeconfig.sh [parameters]
    
    

    Refer to Section J.1 for parameter details.

  4. Start the installer.

    prompt> $ORACLE_HOME/oui/bin/runInstaller
    
    
  5. 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.

  6. Delete any remaining files in the Oracle home directory of the deleted instance.

    prompt> rm -rf $ORACLE_HOME
    
    
  7. Remove the line for the deinstalled Applications tier from the /etc/oratab file.

    Toward 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. The line would look like the following:

    *:/$ORACLE_HOME/infra:N
    
    

    In the preceding example, ORACLE_HOME is the Oracle home of the Oracle Collaboration Suite Database.


    Note:

    Note that Portal entries in Oracle Internet Directory are not removed by the Deconfig tool or the installer.

J.4 Deinstalling Oracle Collaboration Suite Database

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:

To deinstall Oracle Collaboration Suite in silent mode:

  1. Log in as the operating system user who installed the instance you want to deinstall.

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

  3. Run the Deconfig tool.

    prompt> cd $ORACLE_HOME/bin
    prompt> ./ocsdeconfig.sh [-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.

  4. Start the installer.

    prompt> $ORACLE_HOME/oui/bin/runInstaller
    
    
  5. 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.

  6. Delete any remaining files in the Oracle home directory of the deleted instance.

    prompt> rm -rf $ORACLE_HOME
    
    
  7. Remove the line for the deinstalled Oracle Collaboration Suite Database from the /etc/oratab file.

    Toward 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. The line would look like the following:

    SID:/$ORACLE_HOME/infra:N
    *:/$ORACLE_HOME/infra:N
    
    

    In the preceding example, SID is the system identifier for the Oracle Collaboration Suite Database that you have removed and ORACLE_HOME is the Oracle home of the Oracle Collaboration Suite Database.


    Note:

    Note that OracleAS Portal entries in Oracle Internet Directory are not removed by the Deconfig tool or the installer.

J.5 Deinstalling Oracle Collaboration Suite Infrastructure

This section describes how to deinstall Infrastructure instances.

J.5.1 Deinstallation Order

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:

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

  2. Deinstall the instance running Oracle Internet Directory.

J.5.2 Deinstallation Steps

The deinstallation steps for Infrastructure are as follows:

  1. Log in as the operating system user who installed the instance you want to deinstall.

  2. If Oracle Application Server Certificate Authority is configured on the instance you want to deinstall, run the following commands:

    prompt> $ORACLE_HOME/oca/bin/ocactl stop
    prompt> $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

  3. 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:

    prompt> cd $ORACLE_HOME/bin
    prompt> 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.

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

  5. Run the deconfig.pl tool.

    prompt> cd $ORACLE_HOME/bin
    prompt> ./deconfig.pl
    
    
  6. Start the installer.

    prompt> $ORACLE_HOME/oui/bin/runInstaller
    
    

    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.

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

  8. Delete any remaining files in the Oracle home directory of the deleted instance.

    prompt> rm -rf $ORACLE_HOME
    
    
  9. Remove lines for the deinstalled infrastructure instance from the /etc/oratab file.

    Toward the end of the file, you should see lines that specify the Oracle home directory. If you are deinstalling an infrastructure instance that contains a metadata repository, there will be two lines in the file:

    • One line that begins with a *

    • One line that begins with the database SID

    Remove both lines.

    For example, if the infrastructure instance is installed in /private1/infra, and it includes a metadata repository whose SID is orcl, the lines would look like the following:

    orcl:/private1/infra:N
    *:/private1/infra:N
    
    

J.6 Deinstalling a Single-Computer Installation

Perform the following tasks to deinstall a Oracle Collaboration Suite Infrastructure and Applications installation on a single computer:

  1. Log in as the operating system user who installed the instance you want to deinstall.

  2. Start the installer, as follows:

    prompt> $ORACLE_HOME/oui/bin/runInstaller
    
    

    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.

  3. On the Select Installation Method screen, select the Advanced Installation option and click Next.

  4. On the Specify File Locations screen, click Installed Products.

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

  6. Select onebox_apps and click Remove. Next, select onebox_infra and click Remove. Finally, select onebox and click Remove.

  7. Exit the Installer.

J.7 Harmless Errors in the Log File

If you get the following "unable to delete file" and "unable to find make file" errors in the oraInstalltimestamp.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)
...

J.8 Cleaning Up Oracle Collaboration Suite Processes

If you forgot to shut down Oracle Collaboration Suite processes before starting the installation, you must stop 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 stop 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, then exit the shell by typing exit.

J.9 Reinstallation

The installer does not allow reinstallation of an Oracle Collaboration Suite instance in a directory that already contains an Oracle Collaboration Suite instance. To reinstall Oracle Collaboration Suite in the same directory, you must deinstall and then install it.