Skip Headers

Oracle® Beehive 2.0.1.5.0 Cumulative Patch Set Readme
For Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0) (All Platforms)
 

 

Oracle® Beehive

2.0.1.5.0 Cumulative Patch Set Readme

For Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0) (All Platforms)

March 2011

The Readme was last updated on July 6, 2011

This Readme accompanies 2.0.1.5.0 Cumulative Patch Set for Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0).

This option installs 2.0.1.5.0 Cumulative Patch Set, for installations of Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0) only. Before applying this patch, you must upgrade your Oracle Beehive deployment to Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, or 2.0.1.3.0 or 2.0.1.4.0). Do not attempt to install this patch set on earlier versions of Oracle Beehive.

Table 1, "Oracle Beehive Upgrade Options for 2.0.1.5.0" shows the upgrade and patch options that are available.

Once you have completed an upgrade according to one of these paths, you can then apply this patch set.

Table 1 Oracle Beehive Upgrade Options for 2.0.1.5.0

Your current Oracle Beehive deployed version Your upgrade path option(s)

1.5.1.0.0, 1.5.1.2.0, 1.5.1.3.0, 1.5.1.4.0

Patch to 1.5.1.5.0, then use 2.0.1.2.0 OUI installer, then apply 2.0.1.5.0 Cumulative Patch Set

1.5.1.5.0, 1.5.1.5.1, or 1.5.1.5.2

Use 2.0.1.2.0 OUI installer, then apply 2.0.1.5.0 Cumulative Patch Set

2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, 2.0.1.4.0

Apply 2.0.1.5.0 Cumulative Patch Set



Note:

You can determine your version number by running the beectl version command from any Oracle Beehive Oracle home.

This Readme contains the following topics:

Introduction

This Readme includes information on installation, important notes, and known workarounds for the Oracle Beehive 2.0.1.5.0 Cumulative Patch Set for Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0).

Oracle recommends that you read and understand the information in this document before beginning the installation.

What's New in this Release

Java-based User Interface for Beehive Conferencing

The Beehive Conferencing client now is entirely web-based. When you join a conference, you will be directed to the Beehive Conferencing WebCenter, from which you will automatically launch into the ongoing conference. Although you need to "Accept" and/or "Allow" the application to launch, you do not need to install or manage anything on the desktop.Administrative privileges are not required to run Beehive Conferencing. However, administrative privileges may be required to initially install the Java and JavaFX components required by Beehive Conferencing, if they are not already present on your desktop.

BlackBerry CICAL Service Book Support

When activating a BlackBerry against BlackBerry Enterprise Server (BES) for Applications version 4.1.7 in an Oracle Beehive deployment, a CMIME service book is provisioned to the device to accommodate Enterprise Activation. CICAL service books for calendar, however, are not provisioned. This can cause collisions with other calendar providers (i.e. Facebook, Google Mail, etc.).

For Oracle Beehive version 2.0.1.5, however, there is a patch available for BlackBerry Enterprise Server for Applications version 4.1 SP7 in which customers will now have the ability to have CICAL service books provisioned to the BlackBerry smartphone. This, in turn, will open up the functionality to allow the Oracle Beehive calendar to sync to the device, and avoid collisions with any other third party calendar providers.

The RIM Blackberry BES patch required for Beehive 2.0.1.5 is available at the following link:

http://www.blackberry.com/btsc/KB26987

Important Notes

Please review the following important notes before installing this patch:

Rollback Not Supported

Rollback of this patch is not supported. Before applying this patch, take a backup of both Beehive Database and the Beehive ORACLE HOME.

Set Environment Variable

Set ORACLE_HOME environment variable to your Beehive ORACLE HOME. For example, setenv ORACLE_HOME/app/oracle/products/beehive

Ensure that the Database instance and TNS Listener are up and running.

Ensure Beehive processes are gracefully started and all services are running before shutting down.

Must Install Oracle Beekeeper Prior to Applying Patch

Beekeeper cannot be used without applying the 2.0.1.5.0 Cumulative Patch Set.

BEEKEEPER home can be patched after at least one midtier has been patched in a multi-midtier environment (OR) after all midtiers are patched.

One-off Patch for Database Defect 8440319

Apply the one-off patch for database bug 8440319 in Database Oracle Home before applying this patch set. Check the README.txt in that patch after unzipping for applying the patch. Make sure post-patch steps are executed as documented in the README.txt. Failure to do that will result in failure when applying this Beehive patch set.

When Applying the Patch on 1.5.1.x to 2.0.1.0 Environment

If you are applying the patch set in an 1.5.1.x --> 2.0.1.0 upgraded environment in a Beekeeper home, perform the following mentioned workaround before applying the patch set (This is only in Beekeeper upgraded home).

% cd $ORACLE_HOME/.patch_storage% unzip<patch_extract_location>/10160421/Beehive_20150/custom/scripts/beepatch/9041410_workaround.zip

When Applying the Patch on 2.0.1.0.0, 2.0.1.1.0 or 2.0.1.2.0 Environment

If applying on 2.0.1.0.0, 2.0.1.1.0 or 2.0.1.2.0 installation, shutdown all the processes in all Beehive midtiers including BEEKEEPER and DMZ homes before applying the patch set.

When Applying the Patch on 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0 Environment

If applying on 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0 installation, these are ZDU (Zero Downtime Upgrade) and you need not shutdown all midtiers. Shutdown the processes only in the midtier where the patch set is getting applied.

Schema Cloning will be done when applied on top of 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0.

ZDU Upgrade to 2.0.1.5 on 11.2 must include workaround to Database Defect 9345099

When upgrading to 2.0.1.5 on database 11.2 , follow the steps below to workaround the database bug 9345099.

Before attempting a ZDU upgrade, log in to your Oracle Beehive database as SYS using SQL*Plus, and enter the following command:

ALTER SYSTEM SET EVENT = '31151 trace name context forever, level 0x100' 
scope=spfile SID='*';

For each database instance, set the following event:

ALTER SYSTEM SET EVENTS '31151 trace name context forever, level 0x100';

Do not disable the event after the upgrade is done.


Note:

Add the above mentioned event to the list of existing events, ensuring not to overwrite any existing events that you may have set.


Note:

Ensure that all the steps for ZDU upgrade are strictly followed.

Review Oracle Beehive Release Notes

Before applying this (or any) patch on Oracle Beehive, always review the latest Oracle Beehive Release Notes for complete information about known issues, workarounds, and new features in Oracle Beehive. You can find PDF and HTML versions of the Release Notes on the Oracle Technology Network Web site, at the following URL:

http://www.oracle.com/pls/bee2/homepage

Ensure Sufficient Hard Drive Space Before Patching

Before applying this (or any) patch on Oracle Beehive, ensure there is sufficient hard drive space on the Oracle Beehive server. Oracle recommends at least 10 GB of free space.

Search Service Refactoring Requires Additional Configuration

If you are installing this patch on 2.0.1.2.0 or earlier, the patch includes a refactoring of the Oracle Beehive Search Service (which was added in 2.0.1.2.1). This is a substantial change which may require additional post-configuration steps:

  • The existing search index is erased during patching. As a result, after the upgrade any search operation on existing data will return no results. You can perform post-installation steps to build a new search index of existing artifacts, using a new beectl command, beectl add_search_recovery_scope.

  • If you are using Oracle Secure Enterprise Search (SES) with Oracle Beehive, you must take additional steps to configure SES integration.

  • After the upgrade, the search service is enabled, new objects will be indexed, and default values for partitioning, jobs, and search service parameters are set. Depending on your deployment, you may need to make further configuration changes to tune the search service.

For a brief summary of post-installation steps, see Search Service Post-Installation Configuration at http://www.oracle.com/technology/products/beehive/patchdoc/beehive_20121_readme.htm#BABFAJJI. For a detailed explanation of the new search service and its configuration, see MetaLink note 1135054.1.

Configure Data Directories

Depending on whether your Oracle Beehive deployment uses Oracle RAC nodes or not, configure data directories for data pump jobs as per the below link:

http://download.oracle.com/docs/cd/E16671_01/bh.200/e16641/upgrade_overview.htm#CJAHGGEC

Installation Requirements

You must conform to each of the following requirements and perform all pre-installation tasks before installing the patch:


Caution:

Failure to carefully read and understand these requirements may cause Oracle Beehive to malfunction, including interruption of service, loss of data, or both.

Install on Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4) Only

Oracle Beehive 2.0.1.5.0 Cumulative Patch Set can only be installed on Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4). If you have an earlier version of Oracle Beehive, you must first upgrade to Oracle Beehive Release 2, before applying this patch.

Backup your Oracle Beehive Deployment

Before installing 2.0.1.5.0 Cumulative Patch Set, Oracle strongly recommends that you perform a backup of your database and the Oracle Beehive Oracle home.

Install on All Oracle Beehive Application Tiers

In a multi-midtier environment, you must install this patch in every Oracle Beehive Oracle Home, including Application tiers, Oracle Beehive DMZ Oracle Homes, Oracle Beehive Coexistence Connector Oracle Homes, and Oracle Beekeeper Oracle Homes.

Patch has to be applied in the midtiers one by one. All processes in that midtier will be started at the end of Patch set.

Except When Patching 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0, Shut Down Oracle Beehive

Unless you are patching an Oracle Beehive 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0 deployment, before installing this patch set, shut down all processes on all Oracle Beehive Application tiers, including Oracle Beekeeper, Oracle Beehive Coexistence Connector, and Oracle Beehive DMZ Oracle homes. Make sure that all Oracle Beehive processes were started normally prior to shutting them down.

If you are patching an Oracle Beehive 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0 deployment, you may perform a Zero Downtime Upgrade (ZDU) patch. In this case, you can leave your Oracle Beehive Application tiers up and running, only shutting down one Application tier server at a time when you patch that server. The ZDU method allows you to avoid extensive downtime of your Oracle Beehive deployment.

Each of your Oracle Beehive servers will be started automatically as you apply the patch set to them.

Disable Fast Validation in the Database

You must disable fast validation in the database before installing Oracle Beehive 2.0.1.5.0 Cumulative Patch Set.

Log in to your Oracle Beehive database as SYS using SQL*Plus, and enter the following command:

ALTER SYSTEM SET "_disable_fast_validate"=TRUE SCOPE=BOTH SID= '*';

After you install the Oracle Beehive 2.0.1.5.0 Cumulative Patch Set, you can re-enable fast validation using the following commands:

ALTER SYSTEM RESET "_disable_fast_validate" SCOPE=SPFILE SID='*';
ALTER SYSTEM SET "_disable_fast_validate"=FALSE SCOPE=MEMORY SID='*';

Apply Database Patch in Database Oracle Home

If you have not already done so (such as when applying a previous patch), apply the oneoff patch for Oracle Database bug 8440319 in your Oracle Beehive database Oracle home before applying this patch set. Review the README in that patch after unzipping for instructions for applying the patch. Perform all post-patch steps as documented in that README. This Oracle Beehive patch will fail if the post-patch steps are not performed.

Patch Required for Upgraded Beehive Instances on Oracle Database 11.2

Bug 10134218. If you have upgraded your Oracle Database to 11.2, you may require a patch in order to successfully install the Oracle Beehive 2.0.1.5.0 Cumulative Patch Set.

If both of the following conditions are true:

  • You have patched from Oracle Beehive 2.0.1.2.0 to either 2.0.1.2.1 or 2.0.1.3.0

  • After performing the patch, you upgraded your Oracle Database from version 11.1 to 11.2

Then you must apply a special patch, else the Beehive 2.0.1.5.0 Cumulative Patch Set will fail during installation.


Note:

If you do not apply the required patch and you experience the failure during the Oracle Beehive 2.0.1.5.0 Cumulative Patch Set, you can still apply the 10134218 patch at that time, and then complete the 2.0.1.5.0 installation.

If you need to apply this special patch, contact Oracle Support to get the correct version of the 10134218 patch for your operating system and upgrade scenario.

Install Patch 7311226 on 11.1.0.7.x

If you are using Oracle Database 11.1.0.7.x, install patch 7311226 so that Oracle text index full optimization can resume where it left off on the next run. If you are using 11.2.x.x or higher, you do not need to install the patch.

Installation


Note:

  • You must patch Oracle Beekeeper Oracle home(s) only after at least one Oracle Beehive Oracle home has been patched (using the -first_midtier option), and at least one instance of Oracle Beehive must be UP and running when you apply the patch to Oracle Beekeeper

  • Versions of Oracle Beekeeper without this Patch Set applied will not work with Oracle Beehive servers that have the 2.0.1.5.0 Cumulative Patch Set applied. You must patch Oracle Beekeeper before you can use it with a patched Oracle Beehive instance.


To install 2.0.1.5.0 Cumulative Patch Set for Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0), perform the following steps on each Oracle Beehive server and Oracle Beekeeper Oracle home in your deployment:

  1. Make sure that the Oracle Beehive Database instance and TNS Listener are up and running.

  2. If you are applying this Cumulative Patch on Oracle Beehive 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0, shut down all processes in the Oracle Beehive Application tier where the patch will be applied, before applying this patch set. Other Application tiers (including DMZ installations) can be UP and running when applying the patch on a given Application tier. (Oracle Beekeeper instances must be shut down.)

    If you are patching an Oracle Beehive Coexistence Connector instance (any version), you must shut down all processes in the Coexistence Connector Oracle Home before applying the patch.


    Note:

    This means that when updating from 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0 to 2.0.1.5.0, you can perform a rolling patch by patching one Application tier at a time, without shutting down your Oracle Beehive deployment. (You cannot use the rolling patch method when updating from any previous version.)

    Make sure that Oracle Beehive processes were gracefully started and all services were running before shutting down a given Application tier.


    Note:

    If you have not deployed Oracle Universal Records Management (URM), the Records Management Service will be disabled. You do not need to enable this service prior to patching.

    However, all other Oracle Beehive services must be enabled and running before you shut down your Oracle Beehive deployment, including services you may normally leave disabled, such as the Device Management Service.


  3. Unzip the downloaded package to a convenient location.

  4. On Linux and UNIX only, set your current directory to the directory where the patch is located. For example:

    % cd 10160421
    

    (You do not need to take this step on Windows.)

  5. If you are patching an Oracle Beehive server, set the ORACLE_HOME environment variable to your Oracle Beehive Oracle home. For example:

    On UNIX and Linux platforms:

    % setenv ORACLE_HOME /app/oracle/products/beehive
    

    On Windows:

    set ORACLE_HOME=C:\Beehive_Home
    

    If you are patching an Oracle Beekeeper instance, set the ORACLE_HOME environment variable to your Oracle Beekeeper Oracle home. For example:

    On UNIX and Linux platforms:

    % setenv ORACLE_HOME /app/oracle/products/2.0.1.5.0/beekeeper_1
    

    On Windows:

    set ORACLE_HOME=C:\Beekeeper_Home
    
  6. Use the following commands to apply the patch:

    • When applying the patch to the first Oracle Beehive (non-DMZ, non-Beekeeper, non-coexistence connector) instance, run the opatch command with the -first_midtier option:


      Note:

      Do not start with a DMZ instance. You must patch a non-DMZ instance first.

      When using RAC database with non-ASM configuration, if you want the patch to use only a particular node, you can provide the connect string for that node only in the below command (as the -dbconnstr value).


      % $ORACLE_HOME/OPatch/opatch napply -post -sys_passwd <sys password> -dbconnstr "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<db hostname>)(PORT=<db listen port>))
      (CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=<db service name>)))" -first_midtier -opatch_post_end
      

      Note:

      On Windows, omit the double-quotes surrounding the value of -dbconnstr:
      patch.bat napply -post -sys_passwd <sys password>  -dbconnstr (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<db hostname>)(PORT=<db listen port>))
      (CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=<db service name>))) -first_midtier -opatch_post_end
      

    • Only for ZDU Patch

      After applying the patch in the ZDU method on the first 2.0.1.5 midtier, some adjustments may be required for Search Service processing. If the patch is not applied in a ZDU method, then no adjustments will be required.

      1. To determine if adjustments are required, execute the following command:

                                        beectl list_properties 														
      						--component _current_site:SearchDatabase:DefaultAccessSchema 
      						--all_visibilities
       
      

      If this command generates an error, "No properties are available because the value of property SearchDatabase in system object <someid> is null", then no adjustment is necessary. Else, a list of properties and values will be displayed, and some adjustments will be necessary for proper configuration of Search Service.

      2. If adjustments are necessary, follow the steps below to adjust the configuration for correct Search Service processing:

      a) Obtain the new database schema name:

      beectl list_schemas --schema_type 1 --status 4 
      

      The expected output will have the following format:

      schema_name: BEE_CODE schema_id: 86 version_id: 2.0.1.6.0 schema_type: 1 status: 4 creation_time: 2011-06-22 14:50:04.0 activation_time: 2011-06-22 14:50:04.0 description: BEE_CODE code schema 
      

      Note the schema name BEE_CODE in this example.

      b) Update the SearchDatabase schema name and restart the midtier:

                                       beectl modify_property 
      						--component _current_site:SearchDatabase:DefaultAccessSchema 
      						--name UserName --value <BEE_CODE schema name> 
      						--activate_configuration 
                                       beectl restart --all
      
    • When applying the patch to additional Oracle Beehive (non-DMZ, non-Beekeeper, non-coexistence connector) instances, run the opatch command without the -first_midtier option:

      % $ORACLE_HOME/OPatch/opatch napply -post -sys_passwd <sys password> -dbconnstr "(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<db hostname>)(PORT=<db listen port>))
      (CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=<db service name>)))" -opatch_post_end
      

      Note:

      On Windows, omit the double-quotes surrounding the value of -dbconnstr:
      patch.bat napply -post -sys_passwd <sys password> -dbconnstr (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=<db hostname>)(PORT=<db listen port>))
      (CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=<db service name>))) -opatch_post_end
      

    • When applying the patch to a separate Oracle Beekeeper Oracle home:


      Note:

      • You must patch Oracle Beekeeper Oracle home(s) only after at least one Oracle Beehive Oracle home has been patched (using the -first_midtier option)

      • At least one Oracle Beehive instance must be up and running when you apply the patch set to Oracle Beekeeper. Oracle Beehive instances are automatically started after applying the patch. If you subsequently shut down patched instances, be sure to start up at least one patched instance before applying the patch to Oracle Beekeeper Oracle homes.

      • The command-line syntax for applying the patch is case sensitive


      On UNIX and Linux:

      % $ORACLE_HOME/OPatch/opatch napply
      

      On Windows:

      patch.bat napply
      
    • When applying the patch to an Oracle Beehive DMZ instance Oracle home, use the following command:

      On UNIX and Linux:

      % $ORACLE_HOME/OPatch/opatch napply
      

      On Windows:

      patch.bat napply
      

      Note:

      After applying a patch, Oracle Beehive will attempt to restart a patched instance, including DMZ instances. However, if you have not yet performed the Update hasbind File Ownership post-installation step, a DMZ instance may be unable to use privileged ports. In this case, shut down the DMZ instance, and restart it after performing post-installation steps.

    • When applying the patch to an Oracle Beehive Coexistence Connector Oracle home, use the following command:

      On UNIX and Linux:

      % $ORACLE_HOME/OPatch/opatch napply -post -password <OC4J Admin Password> -opatch_post_end
      

      On Windows:

      patch.bat napply -post -password <oc4jadmin password > -opatch_post_end 
      

    The value of <oc4jadmin password> is the password initially entered for the OC4J admin account when you installed the Oracle Beehive Coexistence Connector in this deployment.

  7. Be sure to repeat all steps in this procedure on each Oracle Beehive server in your deployment.

Post-Installation Steps

After performing the installation, perform the steps in the following sections, where applicable:

Update hasbind File Ownership

On Linux and UNIX Oracle Beehive servers, if your $ORACLE_HOME/beehive/bin/hasbind file was owned by root (in order to use privileged ports) before applying this patch, be sure to change it back to ownership by the root user. For example, you could execute the following commands using an account with superuser privileges:

$ cd $ORACLE_HOME/beehive/bin
$ chown root hasbind
$ chmod a+x hasbind
$ chmod a+s hasbind

See Also:

For more information about the hasbind file and reasons for modifying it, see "Modifying Oracle Beehive Ports using Privileged Port Numbers" in Chapter 5, "Managing Oracle Beehive Services" in the Oracle Beehive Administrator's Guide.

Reset Fast Validation in the Database

After you install the Oracle Beehive 2.0.1.5.0 Cumulative Patch Set, you can re-enable fast validation using the following commands:

ALTER SYSTEM RESET "_disable_fast_validate" SCOPE=SPFILE SID='*';
ALTER SYSTEM SET "_disable_fast_validate"=FALSE SCOPE=MEMORY SID='*';

Run Perl Script post_upgrade_db_actions.pl

If, and only if, you installed this patch on Oracle Beehive 2.0.1.2.1, 2.0.1.3.0, or 2.0.1.4.0, since the patch involves schema cloning, you must run the post_upgrade_db_actions.pl script.

If you installed this patch on Oracle Beehive 2.0.1.2.0 or earlier, you do not need to run this script.


Note:

When you enter the <CONNECT_STRING> argument for the perl script, you must enclose it in double-quotes.

For complete instructions, see "Running Perl Script post_upgrade_db_actions.pl," in Chapter "Upgrading Oracle Beehive Overview" of the Oracle Beehive Installation Guide for your platform.

Run SQL Script uds_post_upgrade_seed.sql

Bug 9722573. After applying this patch, you must run a SQL script to clean up group membership data in UDS. Log in to your Oracle Beehive database using SQL+Plus as the current BEE_CODE user, and run the script uds_post_upgrade_seed.sql. The script is located in the following folder:

BEEHIVE_HOME/beehive/tmp/patch/10160421/db

After running post_upgrade_db_actions.pl and uds_post_upgrade_seed.sql,run the following script to verify any invalid objects:

$DB_HOME/rdbms/admin/utlrp.sql 

You may have invalid objects in inactive schemas, this is expected.

Gather Statistics about Oracle Beehive Data and Code Schemas

After upgrading to Oracle Beehive Release 2 (2.0.15) and before your users access your upgrade Oracle Beehive deployment, you must gather statistics about the Oracle Beehive data and code schemas. Else, you may experience serious performance degradation or service interruptions. To know how to gather statistics, refer the following link:

http://download.oracle.com/docs/cd/E16671_01/bh.200/e16641/upgrade_overview.htm#CJAEAJDC

Upgrade Inventory Version

After the patch is successfully applied, upgrade the inventory version of Oracle Beehive components:

  1. Navigate to the upgrade inventory script in the following location:

    <extracted_patch_location>/10160421/Beehive_20150/custom/scripts

  2. Extract the ZIP file containing a script to a folder on your local file system:

    • In Oracle Beehive instances, extract the files from the following .zip:

      BeehiveVersionUpgradeTo20150.zip
      
    • In Oracle Beekeeper instances, extract the files from the following .zip:

      BeekeeperVersionUpgradeTo20150.zip
      

    A subdirectory will be created containing the script

  3. Run the shell script as follows:

    • In Oracle Beehive instances:

      For Linux and UNIX:

      % BeehiveVersionUpgradeTo20150.sh <PATH_TO_ORACLE_HOME>
      

      or for Windows:

      % BeehiveVersionUpgradeTo20150.bat <PATH_TO_ORACLE_HOME>
      
    • In Oracle Beehive DMZ and Coexistence Connector instances:

      For UNIX and Linux:

      % BeehiveVersionUpgradeTo20150.sh <PATH_TO_ORACLE_HOME>
      

      or for Windows:

      % BeehiveVersionUpgradeTo20150.bat <PATH_TO_ORACLE_HOME>
      
    • In Oracle Beekeeper instances:

      For UNIX and Linux:

      % BeekeeperVersionUpgradeTo20150.sh <PATH_TO_ORACLE_HOME>
      

      or for Windows:

      % BeekeeperVersionUpgradeTo20150.bat <PATH_TO_ORACLE_HOME>
      

    Where <PATH_TO_ORACLE_HOME> is the path of the Oracle home (Oracle Beehive or Oracle Beekeeper) that you are upgrading

  4. Repeat steps 1 through 3 on all Oracle Beehive and Oracle Beekeeper instances whose inventories need to be updated to 2.0.1.5.0

  5. To verify that the inventory on an instance has been updated, perform the following steps:

    1. Navigate to the following directory:

      % cd <Updated_Beekeeper_ORACLE_HOME>/oui/bin
      or
      % cd <Upgraded_Beehive_ORACLE_HOME>/oui/bin
      
    2. Start Oracle Universal Installer by invoking the runInstaller in this directory:

      % ./runInstaller
      or, on Windows:
      % setup.exe
      
    3. In the Oracle Universal Installer interface, click Installed Products. An inventory window will open

    4. In the inventory window, you can see all of the Oracle home names on the current host. Expand your Oracle Beehive or Oracle Beekeeper name by clicking on the plus (+) just before it. Confirm that the version number is now Beehive Release 2 (2.0.1.5.0 or Oracle Beekeeper 2.0.1.5.0)

    5. To confirm the versions of other subcomponents, expand Oracle Beehive or Oracle Beekeeper 2.0.1.5.0 by clicking on the plus (+) just before it. Traverse through the list of subcomponents and confirm the following upgraded components:

      On Oracle Beehive:

      Oracle Beehive Release 2 Configuration 2.0.1.5.0 
      Oracle Beehive Release 2 Database Support 2.0.1.5.0 
      Oracle Beehive Release 2 Binaries 2.0.1.5.0 
      Oracle Beehive Release 2 Libraries 2.0.1.5.0 
      Oracle Beehive Release 2 Services 2.0.1.5.0 
      Oracle Beehive Release 2 Configuration Wizard 2.0.1.5.0 
      Oracle Commuication and Messaging Services 2.0.1.5.0
      Oracle Beehive Release 2 Oneoffs 2.0.1.5.0
      

      On Windows, also confirm:

      Oracle Collaboration Coexistence Gateway 2.0.1.5.0
      

      On Oracle Beekeeper:

      Oracle Beekeeper 2.0.1.5.0
      Oracle Beekeeper OC4J 2.0.1.5.0
      Oracle Beehive Release 2 Oneoffs 2.0.1.5.0
      Oracle Beehive Release 2 Configuration Wizard 2.0.1.5.0
      

Search Service Post-Installation Configuration

The Oracle Beehive 2.0.1.3.0 Cumulative Patch (which is included in this cumulative patch set) included a refactoring of the Oracle Beehive Search Service. This is a substantial change which may require additional post-configuration steps in the following areas:

Building a New Search Index of Existing Artifacts

If you installed this patch on Oracle Beehive 2.0.1.2.0 or earlier, the existing search index is erased during patching. As a result, after the upgrade any search operation on existing data will return no results.

If you installed this patch on Oracle Beehive 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0 and used the Zero Downtime Upgrade (ZDU) method, search indexing is suspended during the patching process. Changes in the system that occurred during patching are not indexed.

You can build a new search index of existing artifacts, using a new beectl command, beectl add_search_recovery_scope:

beectl add_search_recovery_scope 
  --scope <recovery_scope> 
  [--entity_type <entity_type>]
  [--start_date <start_date>]
  [--end_date <end_date>]

Where:

  • <recovery_scope> is the identifier for a level of scope for the utility to crawl for indexing, such as enterprise, organization, workspace, or folder.

  • <entity_type> indicates searchable entity types. You can specify this option more than once to indicate multiple entities types to index. If you omit this option, all entity types are searched and indexed.

  • <start_date> recovers search index for entities modified on or after this date. If not specified, 30 days before the present will be used as the start date. Permitted value is a string in ISO8601 date-time format. Valid formats are yyyy-MM-dd'T'HH:mm:ss.SS'Z', yyyy-MM-dd'T'HH:mm:ss.SS, yyyy-MM-dd'T'HH:mm:ss'Z', yyyy-MM-dd'T'HH:mm:ss, yyyy-MM-dd'Z', yyyy-MM-dd.

  • <end_date> recovers search index for entities modified before or on this date. If not specified, the present will be used as the end date. Use the same format as for <start_date>.

As soon as you issue an add_search_recovery_scope command, Oracle Beehive starts the background work and immediately returns an operation ID. You can use the operation ID with the beectl list_operation_statuses command to track the progress of the recovery job.

beectl list_operation_statuses --operation_status 1CF3:35AF:opst:6828B43CD3944E06A5CD425F0225CF2500000000004C

The add_search_recovery scope command will immediately add a list of all artifacts identified by the run time options to a queue of items to be indexed. Adding too many items to this queue at once will slow down the system. Oracle recommends reviewing the Recovery Crawler section of Oracle Support Note 1135054.1 prior to running the command.

To minimize performance impact, consider the following strategies:

  • Run the recovery crawler command during off-peak hours

  • Create a batch file to recover a few personal or team workspaces or a few days of email data at a time

  • Monitor the SS_FEEDS load (information in Oracle Support Note 1135054.1)

Configuring Oracle Secure Enterprise Search (SES) Integration

If you are using Oracle Secure Enterprise Search (SES) with Oracle Beehive, if you have not already done so (such as after installing the 2.0.1.2.1, 2.0.1.3.0 or 2.0.1.4.0 patch set) you must take additional steps to configure SES integration. The following procedure provides a high-level outline of the actual configuration steps. For complete instructions, see MetaLink Note 1135054.1.

Perform the following steps to configure SES integration:

  1. Perform the complete procedure for basic SES integration as detailed in Chapter 10, "Integrating Oracle Secure Enterprise Search 10g with Oracle Beehive" of the Oracle Beehive Integration Guide.

  2. If needed, configure your Identity Management solution with the appropriate host, port, realm, and other connection settings.

  3. If needed, create source groups (groupings of data sources, which appear as tabs above the search box).

  4. From the SES Admin console, set up a title URL for Oracle Beehive search results by creating new search attributes, and then modifying the XSL stylesheet to include the new attributes.

  5. From the SES Admin console, add Oracle Beehive search result attributes and filtering attributes.

Deploy the JavaFX Runtime in the DMS

Beehive Conferencing introduced a new Java-based architecture that can be used by end users without requiring any Operating System-specific desktop installation. One of the many advantages of this new architecture is the ability to leverage Java to auto-detect, auto-install, and auto-update all the necessary components required by Beehive Conferencing to run. Therefore, for a user to join a conference, the Beehive Conferencing application needs to access two external resources:

  • JavaScript code (deployJava.js) for launching Java applications and detecting JRE versions.

  • The JavaFX runtime .jar files.

Out of the box, Beehive Conferencing uses the "official" versions of these files by accessing the files through the java.com site over the web. This can cause some issues if a user doesn't have access to the internet, can't access the java.com site (for example, it is unavailable at that time), and/or does not have their proxy settings configured correctly.


Note:

Oracle recommends that you deploy the JavaFX Runtime in the Beehive DMS. For details see Chapter 28, "Installing Oracle Beehive Conferencing Client" of the Oracle Beehive Installation Guide, Release 2.0 at the following link: http://download.oracle.com/docs/cd/E16671_01/index.htm

Resolved Issues

Table 2, "Resolved Issues in Oracle Beehive 2.0.1.5.0 Cumulative Patch Set" lists the issues resolved in this Patch Set (new for 2.0.1.3.0 Patch Set).

The issues that were resolved by the Oracle Beehive 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0 patch sets (and are included in this cumulative patch) are listed in detail in the patch readmes for each patch. You can find the readmes on the Oracle Technology Network Web site, at the following URLs:

Table 2 Resolved Issues in Oracle Beehive 2.0.1.5.0 Cumulative Patch Set

Defect Number Description

10166616

Support for MX HTTPS tunnelling when HTTPS is terminated at a load-balancer.

10276050

RFI backport of bug 9339043 for inclusion in 2.1

10175314

The voice-user privilege is checked before rendering the voicemail related UI.

10266867

The SMS opt-in text can now be customized through BeeCentralService.

10232538

Phone center shows the Voicemail Transfer Option (dial 8) UI when not available.

11737501

The performance of wiki pages is improved.

10256699

When editing wiki pages, no unnecessary tags are inserted.

10302928

The Beehive conferencing is working as expected.

10215186

The web conference host was unable to use keyboard when presenter grants shared control.

10235672

When Beehive is slow, the conference clients is taking a long time to display the list of running and upcoming conferences for users to join.

11773508, 11775250

Beehive confernce launches beetube incorrectly for host user.

10231196

The performance of the Beehive conference is improved.

10398747, 10363728

On Windows XP, the default screen grabber is unable to capture content rendered through DirectX.

10270176

Meaningful error message are displayed when the user session expires.

10141963

Java Conf CLient - Fix issues with special characters.

10093058

Conferencing - Unable to generate jnlp warning during user join

10270195

Beehive JavaFX conference client failed to connect to session

10384268

The JavaFX client has been enhanced to correctly display the Java warning dialog.

11693479

Users now have the option to join conference either in Beetube or JavaFX client based on user preference.

10297857

The JavaFX client is now supported on Windows 2003/2008 servers.

11056548

Unknown error displayed when invite user already in attendee list

10206889

Signin button is not actioned by enter key.

11672205

Voice chat is now supported on Linux Ubuntu 10.10.

11667296

The Beehive conferencing is working as expected.

10235680

The Beehive conferencing performance has been improved.

10233689

hprofs generated after upgrade to 2.0

10419734

Oracle's BES server now supports CICAL service books, this supports multiple calendars on Blackberry devices.

10244795

Blackberry - Open attachment and view attachment is visible.

10365896

Blackberry - Message is truncated when using "get html" to view html message.

10280501

Blackberry - Compact mode useless on touch devices

10284311

Blackberry - Client uses configuration information after an os update

10025594

Ability to view availability

10248296, 10143875, 11741037

The delegated user has access to only view and manage deleted content from the folder/calendar he was delegated to.

10373899, 10325088

The user can now view the IMIP meeting invites using OBEO + Outlook 2003.

10363467

OBEO uploads the meeting cancellation comments and justification for all cancelled meetings to the server before deleting them.

10389946

OBEO can now read uuencoded attachment format.

10154681

Issue with sending html messages over SMTP has been resolved.

11077418

OBEO does not block messages with lower priority.

11077381

There is no duplication with OBEO client folders.

10303021

The MSXML6 dependency has been removed.

10302870

OBEO performance has been improved.

10227348

The document changes are now properly saved on the server.

10276002

import_email_data fails when data file is bigger than 2g

10338434

The issue of sorting in Zimbra has been resolved.

10191168

Files can now be transferred between iChat clients.

11725328

Synthesis Android calendar first sync is working as expected.

11725359

Reaching limit for max contacts resulting in no more contacts sent

11064934

Mobile DM supports android devices.

10231578

Audit policy created under an organizational scope does not work

11060823

CALDAV - Dismissing reminder of a deleted recurrence instance yields an error

11682416

delete_workspace fails with beeus-00600 error

10154492

The recording of the conference is working as expected.

11679082

full table scan in owc_conferences sql : 3ak9p77n1vxpv,0hwvaxf6nu92w

10171379

Voice passing through bigip is limited to 1024 participants

10240981

The JavaFX conference client is able to reconnect if one BEEAPP is stopped.


Known Issues

Globalization Issues

2.0.1.5.0 Cumulative Patch Set for Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0) is available in English only. There are no translations of any English labels and other text.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible to all users, including users that are disabled. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Accessibility standards will continue to evolve over time, and Oracle is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For more information, visit the Oracle Accessibility Program Web site at http://www.oracle.com/accessibility/.

Accessibility of Code Examples in Documentation

Screen readers may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, some screen readers may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle does not own or control. Oracle neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/support/contact.html or visit http://www.oracle.com/accessibility/support.html if you are hearing impaired.


2.0.1.5.0 Cumulative Patch Set for Oracle Beehive Release 2 (2.0.1.0.0, 2.0.1.1.0, 2.0.1.2.0, 2.0.1.2.1, 2.0.1.3.0, and 2.0.1.4.0)

Copyright © 2008, 2011, Oracle and/or its affiliates. All rights reserved.

This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.

If this software or related documentation is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:

U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data delivered to U.S. Government customers are "commercial computer software" or "commercial technical data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.

This software is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous applications, including applications which may create a risk of personal injury. If you use this software in dangerous applications, then you shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this software in dangerous applications.

Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.

This software and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.