11 Upgrading Standalone Installations of Oracle Calendar

This chapter explains how to upgrade standalone installations of Oracle Calendar server and application system. The upgrade process involves installing a new version of the component and running an upgrade script to perform the upgrade.

11.1 Upgrading Oracle Calendar Server or CorporateTime Server 5.4

Oracle Collaboration Suite supports upgrading the following releases of the standalone Oracle Calendar server.

• CorporateTime 5.4

• Oracle Calendar Release 2 (9.0.4.1) server

• Oracle Calendar Release 2 (9.0.4.2) server

To upgrade a standalone installation of Oracle Calendar or Oracle CorporateTime 5.4, first install Oracle Calendar 10g Release 1 (10.1.1) server in a new Oracle home and then proceed with the steps in the following sections:

• Upgrading From CorporateTime 5.4

• Upgrading From All Supported Oracle Calendar Server Releases

See Also:

Appendix C, "Installing Oracle Calendar Server Standalone," in the installation guide for your operating system for instructions on installing Oracle Calendar 10g Release 1 (10.1.1) server:

• Oracle Collaboration Suite Installation Guide for Solaris Operating System

• Oracle Collaboration Suite Installation Guide for Linux

• Oracle Collaboration Suite Installation Guide for hp-ux

11.1.1 Upgrading From CorporateTime 5.4

To upgrade from CorporateTime 5.4, run the preupgrade script as root from the 10.1.1 Oracle home:

DESTINATION_ORACLE_HOME/ocal/upgrade/ocalPreUpg.sh

where DESTINATION_ORACLE_HOME is the 10.1.1 Oracle home.

When the preupgrade script completes, run the upgrade assistant as described in Section 11.1.2.

11.1.2 Upgrading From All Supported Oracle Calendar Server Releases

To upgrade from all releases:

1. Shut down the Oracle Calendar server in both the Release 2 (9.0.4.2) Oracle home and the 10g Release 1 (10.1.1) Oracle home, if it is running.

2. Start the Oracle Calendar Upgrade Assistant by running the following script from the 10.1.1 Oracle home:

   DESTINATION_ORACLE_HOME/ocal/upgrade/ocalUpg.sh -srcpath SOURCE_ORACLE_HOME -dstpath DESTINATION_ORACLE_HOME
   
   

   where:

   • DESTINATION_ORACLE_HOME is the 10.1.1 Oracle home.

   • SOURCE_ORACLE_HOME is the 9.0.4 or 5.4 Oracle home.

     If you are upgrading from CorporateTime 5.4, use /users/unison for the value of SOURCE_ORACLE_HOME.

   The upgrade script migrates all your existing settings and data to the new installation.

3. Check the log file located in DESTINATION_ORACLE_HOME/ocal/upgrade/log for any errors that occured during the upgrade.

11.1.3 Verifying the Oracle Calendar Server Upgrade

To verify the upgrade of the Oracle Calendar server:

1. Start the Oracle Calendar server by entering the following command:

   $DESTINATION_ORACLE_HOME\ocal\bin\unistart
   
   

   Make sure the server starts without any errors.

2. Verify that you are able to see all existing users, resources and event calendars using the following commands:

   $DESTINATION_ORACLE_HOME/ocal/bin/uniuser -ls -n <NODEID> 
   $DESTINATION_ORACLE_HOME/ocal/bin/ uniuser -resource -ls -n <NODEID> 
   $DESTINATION_ORACLE_HOME/ocal/bin/uniuser -eventcal -ls -n <NODEID> 
   
   

3. Make sure that you can log in as an existing user using any Oracle Calendar client.

11.1.4 Completing the Oracle Calendar Server Upgrade

The Oracle Calendar administrator is now located in the destination Oracle home. Modify your Web server configuration so that it points to the new location. For example, if DESTINATION_ORACLE_HOME is the directory containing Oracle Calendar 10g Release 1 (10.1.1), then the Web server configuration should include DESTINATION_ORACLE_HOME/ocad/config/ocad.conf.

11.2 Upgrading The Oracle Calendar Application System

To upgrade a standalone installation of the Oracle Calendar application system, first install Oracle Calendar 10g Release 1 (10.1.1) application system in a new Oracle home and then follow the instructions in this section to run the upgrade script.

See Also:

Appendix C, "Installing Oracle Calendar Standalone," in the installation guide for your operating system for instructions on installing Oracle Calendar 10g Release 1 (10.1.1) application system:

• Oracle Collaboration Suite Installation Guide for Solaris Operating System

• Oracle Collaboration Suite Installation Guide for Linux

• Oracle Collaboration Suite Installation Guide for hp-ux

11.2.1 Upgrading from Oracle Calendar Release 1 (9.0.3.1) Application System

To run the upgrade script, enter the following command:

DESTINATION_ORACLE_HOME/ocas/upgrade/ocasua.sh -srcver source_version -destver destination_version -appdir OWC_standalone_application_dir -resdir OWC_standalone_resource_dir -destdir DESTINATION_ORACLE_HOME -confdir apache_configuration_dir

where

• DESTINATION_ORACLE_HOME is the Oracle home for Oracle Calendar 10g Release 1 (10.1.1).

• source_version is either CTW3.0 if upgrading from CorporateTime for the Web 3.0 or CTW3.1 if upgrading from CorporateTime for the Web 3.1.

• destination_version (optional) is 10.1.1. If not provided, the default value is 10.1.1.

• OWC_standalone_application_dir is is the absolute path of the 9.0.3 lexacal.fcgi

• OWC_standalone_resource_dir is the absolute path of the 9.0.3. lexacal-private directory

• apache_configuration_dir is the location of the Apache server configuration file httpd.conf.

In the following example, the DESTINATION _ORACLE_HOME is /u01/ocs10, the 9.0.3 lexacal.fcgi is located in /usr/local/apache/fcgi-bin/lexacal and the 9.0.3 lexacal resources are located in /usr/local/apache/lexacal-private. The HTTP server is the Apache Web server and the server configuration file is located in /usr/local/apache/conf. The command is:

/u01/ocs10/ocas/upgrade/ocasua.sh -srcver CTW3.1 -destver 10.1.1-appdir /usr/local/apache/fcgi-bin/lexacal -resdir /usr/local/apache/lexacal-private -destdir /u01/ocs10 -confdir /usr/local/apache/conf

11.2.2 Upgrading from Oracle Calendar Release 2 (9.0.4.2) Application System

To run the upgrade script, enter the following command:

DESTINATION_ORACLE_HOME/ocas/upgrade/ocasua.sh -srcver source_version -destver destination_version -srcdir source_oracle_home -destdir DESTINATION_ORACLE_HOME
-confdir apache_configuration_dir

where

• DESTINATION_ORACLE_HOME is the Oracle home for Oracle Calendar 10g Release 1 (10.1.1).

• source_version is 9.0.4

• destination_version (optional) is 10.1.1. If not provided, the default value is 10.1.1.

• source_oracle_home is the location of the Oracle home for Oracle Calendar Release 2 (9.0.4.2)

• apache_configuration_dir is the location of the Apache server configuration file httpd.conf.

In this example, the DESTINATION _ORACLE_HOME is /u01/ocs10 and the 9.0.4 Oracle home is /u01/ocs904. The HTTP server is the Apache Web server and the server configuration file is located in /usr/local/apache/conf. The command is:

/u01/ocs10/ocas/upgrade/ocasua.sh -srcver 9.0.4 -destver 10.1.1 -srcdir /u01/ocs904 -destdir /u01/ocs10 -confdir /usr/local/apache/conf

11.2.3 Verifying the Oracle Calendar Applications Upgrade

To verify that the upgrade to Oracle Calendar 10g Release 1 (10.1.1) was successful, from a browser access the Oracle Calendar Web client at the following URL:

http://web_server_host:web_server_port/ocas-bin/ocas.fcgi?sub=web

Enter your OracleAS Single Sign-On user name and password when prompted.