2 Installing the Patch Set

This chapter provides information on installing the patch set.

This section includes the following topics:

Section 2.1, "Installing the Patch Set on an Existing Oracle Collaboration Suite Installation"
Section 2.2, "Installing the Patch Set on a New Oracle Collaboration Suite Installation"
Section 2.3, "Installing the Oracle Voicemail & Fax Patch"
Section 2.4, "Installing the Patch Set on the Oracle Web Conferencing Document and Voice Conversion Servers"
Section 2.5, "Installing the Patch Set on an Oracle Calendar Standalone Installation"
Section 2.6, "Silent and Non-Interactive Patch Set Installation"
Section 2.7, "Installing the Patch Set on Single Computer Installations"

2.1 Installing the Patch Set on an Existing Oracle Collaboration Suite Installation

This section applies to customers who want to install the patch set on an existing installation of Oracle Collaboration Suite.

Back up the Oracle Collaboration Suite infrastructure, all information storage databases, and all middle tiers.

Caution:

If you run setup.bat from any location other than the root directory of the CD-ROM, your Oracle Collaboration Suite installation could be permanently damaged. Run setup.bat from the root directory of Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) CD 1, as in the following example:
```
drive_letter:\setup.bat
```
You cannot deinstall the patch set. However, if you have backed up the system, you can restore the system to a state prior to installation of the patch set.

Apply the patch set to the infrastructure by executing setup.bat from the root directory of Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) CD 1.

Note:

If you are using a non-Oracle Collaboration Suite application server installation, do not install the patch set on the infrastructure. Installing the Oracle Collaboration Suite middle tier with Oracle Email and Oracle Wireless on the same machine where the infrastructure is installed requires installing an Oracle Email patch and Oracle Wireless patch onto the infrastructure. Contact Oracle Support and obtain the Email patch for bug 3883900 and the Wireless patch for bug 3884509. If you are not using a non-Oracle Collaboration Suite application server installation, apply the patch set to the infrastructure as documented in this procedure.

See Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1) for a description of a non-Oracle Collaboration Suite application server installation.

If you have not configured the information storage database for Oracle Email, you can skip this step. Otherwise, run setup.bat from the root directory of Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) CD 1 on all information storage databases that are configured for Oracle Email.

Note:

This note applies to customers who have upgraded from Oracle Collaboration Suite 9.0.3 to 9.0.4.1.1. If an information store database of Oracle Collaboration Suite version 9.0.3 was in use with text-based indexing and search enabled, and if no manual steps were performed to re-create the text index after upgrading to Oracle Collaboration Suite 9.0.4.1.1, upgrading information store to 9.0.4.2.1 will appear to fail when running the installer. The following errors appear in the log file:

Creating oracle text INDEX preferences...
BEGIN
*
ERROR at line 1:
ORA-20000: Oracle Text error:
DRG-10700: preference does not exist: oratextstore
ORA-06512: at "CTXSYS.DRUE", line 157
ORA-06512: at "CTXSYS.CTX_DDL", line 105
ORA-06512: at line 2

This error can be ignored if there are no other errors appearing in the install log. The text index still functions and will not affect any other email functionality. Use the following workaround to re-create the text index:

drop INDEX es_ot_ix_search;

begin
  ctx_ddl.create_preference('oratextstore', 'BASIC_STORAGE');
  ctx_ddl.set_attribute('oratextstore', 'I_TABLE_CLAUSE',
     'tablespace esoratext storage(buffer_pool keep)');
  ctx_ddl.set_attribute('oratextstore', 'K_TABLE_CLAUSE',
     'tablespace esoratext');
  ctx_ddl.set_attribute('oratextstore', 'R_TABLE_CLAUSE',
     'tablespace esoratext
  lob (data) store as (storage(buffer_pool keep)cache)');
  ctx_ddl.set_attribute('oratextstore', 'N_TABLE_CLAUSE',
     'tablespace esoratext');
  ctx_ddl.set_attribute('oratextstore', 'I_INDEX_CLAUSE',
     'tablespace esoratext');
  ctx_ddl.set_attribute('oratextstore', 'P_TABLE_CLAUSE',
     'tablespace esoratext');
end;
/

CREATE INDEX es_ot_ix_search ON es_imt_msgbody(text)
  indextype IS ctxsys.context
  parameters ('DATASTORE es_search_dspref
     FILTER        CTXSYS.NULL_FILTER
     SECTION GROUP  es_search_sec_group
     STORAGE        oratextstore';

Apply the patch set to the middle tiers by running setup.bat from the root directory of Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) CD 1.

See Also:

Chapter 5, "Getting Started with Installation" in the Oracle Collaboration Suite Installation and Configuration Guide for Windows for details regarding starting the Oracle Universal Installer

Notes:

Oracle Email server shutdown and startup tasks are logged in the %ORACLE_HOME%\oes\log\install_server_check.log file.
During installation of the patch set on the middle tier, Oracle Email servers are shut down by the installation program. This process can take up to five minutes, during which time there will be no message on the screen.

After installing the patch set on the middle tier in Windows 2003 environments, copy the DNS support executables to the %ORACLE_HOME%\bin directory as follows (see Bug 4092679 for more details):

copy %ORACLE_HOME%\bin\esls_dns.exe %ORACLE_HOME%\bin\esls.exe
copy %ORACLE_HOME%\bin\esnnarc_dns.exe %ORACLE_HOME%\bin\esnnarc.exe
copy %ORACLE_HOME%\bin\esnni_dns.exe %ORACLE_HOME%\bin\esnni.exe
copy %ORACLE_HOME%\bin\esnno_dns.exe %ORACLE_HOME%\bin\esnno.exe
copy %ORACLE_HOME%\bin\essmi_dns.exe %ORACLE_HOME%\bin\essmi.exe
copy %ORACLE_HOME%\bin\essmo_dns.exe %ORACLE_HOME%\bin\essmo.exe

If you are installing either or both the Oracle Voicemail & Fax patch and the Oracle Web Conferencing document and voice conversion servers patch, proceed to Section 2.3 and Section 2.4, respectively. Otherwise, proceed to Chapter 3, "Patch Set Postinstallation Instructions".

2.2 Installing the Patch Set on a New Oracle Collaboration Suite Installation

This section applies only to customers who are installing the patch set on a new Oracle Collaboration Suite installation.

Install the Oracle Collaboration Suite 9.0.4.1.1 infrastructure, as instructed in Chapter 6 of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1).
Install the Oracle Collaboration Suite 9.0.4.1.1 information storage database, as instructed in Chapter 6 of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1).

After you install the information storage database, Oracle recommends that you upgrade it to Oracle Database 9.2.0.5, or later.
Install the Oracle Collaboration Suite 9.0.4.1.1 middle tier, as instructed in Chapter 6 of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1).

During middle tier installation, deselect Oracle Files from the Component Configuration screen, or cancel the Oracle Files configuration assistant during the configuration phase.
Configure Oracle Email, as instructed in Chapter 11 of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1).
Install and configure Oracle Voicemail & Fax, as instructed in Chapter 7 of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1).
Back up the Oracle Collaboration Suite infrastructure, information storage database, and middle tier.

If you have configured the information storage database for Oracle Email, apply the Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) to all three tiers: infrastructure, information storage database, and middle tier, as instructed in Section 2.1, "Installing the Patch Set on an Existing Oracle Collaboration Suite Installation".

Note:

If you are using a non-Oracle Collaboration Suite application server installation, install the patch set on the information store and middle tier. Installing the Oracle Collaboration Suite middle tier with Oracle Email and Oracle Wireless on the same machine where the infrastructure is installed requires installing an Oracle Email patch and Oracle Wireless patch onto the infrastructure. Contact Oracle Support and obtain the Email patch for bug 3883900 and the Wireless patch for bug 3884509. If you are not using a non-Oracle Collaboration Suite application server installation, apply the patch set to all three tiers, as documented in this procedure.

See Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1) for a description of a non-Oracle Collaboration Suite application server installation.

If you have not configured the information storage database for Oracle Email, apply the Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) to the infrastructure and middle tier only, as instructed in Section 2.1, "Installing the Patch Set on an Existing Oracle Collaboration Suite Installation".

Proceed to Chapter 3, "Patch Set Postinstallation Instructions", and follow all instructions except those for Oracle Files.
Configure Oracle Files, including the optional Oracle Workflow integration, as instructed in Chapter 12 of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1).
Configure Oracle9iAS Wireless as instructed in the Oracle9iAS Wireless Administrator's Guide.
Configure the rest of the middle tier components according to their respective chapters in the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1).

2.3 Installing the Oracle Voicemail & Fax Patch

Included on the Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.0) Client CD is a patch that must be applied to the Oracle Voicemail & Fax telephony server.

Apply the patch, located in the \Windows_Server_Patches\Voicemail_Server\VoicemailPatchSet9042 directory, as follows, to each computer on which an Oracle Voicemail & Fax telephony server resides:

Select Start, then select Run and enter services.msc in the Open field and click OK.
In the Services window, stop all the services with names that begin with UM, as will as the rmid and rmiregistry services.
Navigate to the Windows_Server_Patches\Voicemail_Server \VoicemailPatchSet90421\Disk1\install\win32 folder and double click the install_patch.bat file.

The command window prompts you for the ORACLE_HOME path.
Enter the complete ORACLE_HOME path and press Enter.
The Oracle Universal Installer Welcome screen displays.
Click Next to display a list of information stores and the UM password.
Select any information store and enter the password, and proceed with the installation.

When the installation is complete, restart rmid, rmiregistry, and all of the services beginning with UM from the Services window.

Note:

If you configure a new CT Server on an upgraded middle tier, you must run umsave.bat, located in the %ORACLE_HOME%\um\scripts directory, after running uminfra_install.bat (as part of installing Oracle Collaboration Suite). This will upgrade um.jar to Release 2 Patch Set 1 (9.0.4.2.1).

2.4 Installing the Patch Set on the Oracle Web Conferencing Document and Voice Conversion Servers

The Oracle Web Conferencing system uses a document conversion server to convert various types of documents to HTML for presentation, and a voice conversion server to stream voice data during a conference. If you use these features, you must install the patch set on the servers, as follows:

On each system:

Insert the Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) Client CD and navigate to the \Windows\Server\Patches\RTC_DocumentVoice directory.

Run the setup command:

\Windows\Server\Patches\RTC_DocumentVoice\setup.exe

Follow the screen prompts to install the patch set. You will have to enter the password for the RTC_APP schema in the existing RTC repository.

Repeat these three steps for each system hosting either a document conversion server, voice conversion server, or both.

Note:

If there are active connections to the document or voice conversion servers, you will be prevented from shutting them down. The installation will not continue if the servers are up. You can wait and then retry patch set installation, or terminate the processes by force using your operating system tools.

2.5 Installing the Patch Set on an Oracle Calendar Standalone Installation

This section applies to customers who are installing the patch set on a new or existing Oracle Calendar standalone 9.0.4.1.1 installation.

Read Section 1.5, "Oracle Calendar Server Preinstallation Tasks" and Section 1.6, "Oracle Calendar Application System Preinstallation Requirements".
Install the patch set using the steps described in Appendix F of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1). (The procedure for installing Oracle Calendar standalone 9.0.4.2.1 is virtually the same as the procedure for installing Oracle Calendar standalone 9.0.4.1.1). During installation, make sure to specify the ORACLE_HOME where you have Oracle Calendar standalone 9.0.4.1.1 installed. This will update Oracle Calendar standalone 9.0.4.1.1 to Oracle Calendar standalone 9.0.4.2.1.
Proceed to Section 3.1, "Oracle Calendar Server Postinstallation Tasks" and Section 3.2, "Oracle Calendar Application System Postinstallation Tasks".

2.6 Silent and Non-Interactive Patch Set Installation

This installation includes response files for infrastructure, information storage, and middle tier.

Response files are located in the \response directory located in the root directory of the Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) CD 1. You must edit the response files to satisfy your silent or non-interactive installation requirements. To use a response file, first copy it from the CD-ROM to your system.

See Also:

The following sections in Chapter 9, "Silent and Non-Interactive Installation" of the Oracle Collaboration Suite Installation and Configuration Guide Release 2 (9.0.4.1.1) for instructions

"Selecting a Response File"
"Editing a Response File"
"Specifying a Response File"

2.7 Installing the Patch Set on Single Computer Installations

This section provides steps for installing the patch set on Oracle Collaboration Suite (9.0.4.1.1) installed on a single computer.

Note:

Back up Oracle Collaboration Suite before starting the patch set installation.

For single computer installations, you must install the patch set on each of the three tiers in separate sessions of the Oracle Universal Installer in the following sequence: infrastructure, information storage database, and middle tier. For example, after installing the patch set on the infrastructure, you must exit and restart the Oracle Universal Installer to install the patch set on the information storage database. After installing the patch set on the information storage database, you must exit and restart the Oracle Universal Installer once more to install the patch set on the middle tier.

To install the patch set on Oracle Collaboration Suite installed on a single computer, repeat the following procedure for each of the three tiers:

Execute setup.bat from the root directory of Oracle Collaboration Suite Release 2 Patch Set 1 (9.0.4.2.1) CD 1. This starts the Oracle Universal Installer.

Begin the installation. When you reach the second screen of the Oracle Universal Installer (Specify File Locations), in the drop down menu, select the ORACLE_HOME name and path appropriate for the tier onto which you are installing the patch set.

See Also:

Chapter 5, "Getting Started with Installation" in the Oracle Collaboration Suite Installation and Configuration Guide for Windows for more information about using the Oracle Universal Installer.

Click Next to continue installing the patch set.

Click Exit at the end of the installation session.

See Also:

Section 2.1, "Installing the Patch Set on an Existing Oracle Collaboration Suite Installation" for more information about installing the patch set on an existing Oracle Collaboration Suite installation.