Skip Headers

Oracle® Beehive 2.0.1.6.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, 2.0.1.4.0, and 2.0.1.5.0) (All Platforms)
 

 

Oracle® Beehive

2.0.1.6.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, 2.0.1.4.0, and 2.0.1.5.0) (All Platforms)

November 2011

The Readme was last updated on November 4, 2011

This Readme accompanies 2.0.1.6.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, 2.0.1.4.0, and 2.0.1.5.0).

This option installs 2.0.1.6.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, 2.0.1.4.0, and 2.0.1.5.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.6.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.6.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.6.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.6.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, and 2.0.1.5.0

Apply 2.0.1.6.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.6.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, 2.0.1.4.0, and 2.0.1.5.0).

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

What's New in this Release

Some of the new features included in this release are:

  • Beehive Central

    • Conference option in the Beehive Central menu

  • Beehive Conferencing

    • Conferencing client Web-based and Web delivered

    • Auto launch of the JavaFX client when joining a conference

    • Application sharing in JavaFX client

    • Can add Web conference to meeting using Zimbra

    • Join conference by ID

  • OBEO

    • Support for Outlook 2010 (32-bit and 64-bit)

    • De-support Outlook 2000 and 2002

    • Option to control the meeting invitation response dialog

    • User control over Oracle Beehive server status notification pop-ups

  • OBEE

    • Support for Windows 7 (32-bit and 64-bit)

    • De-support Windows 2000

  • Supported Software Versions

    • Standards based clients

      • Support for MacOS X 10.7 (iCal, Mail, Finder, iChat)

      • Support for Thunderbird 6.0 with Lightning 1.0b5

      • Support for Pidgin 2.10

      • Support for Filezilla 3.5

    • Mobile access

      • Support for iOS 5 (iphone, iPad)

      • Support for Blackberry OS 7

    • Browser support (does not apply to Beekeeper)

      • Internet Explorer 8, 9

      • Firefox 4, 5, 6

      • Safari 5

    • Update of the Beehive Timezone package

For detailed information on the new features, refer to the Oracle Beehive Release Notes Release 2 (2.0) at the following location:

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

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.6.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 (only for 11.1.0.7.0) 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, 2.0.1.4.0, or 2.0.1.5.0 Environment

If applying on 2.0.1.2.1, 2.0.1.3.0, 2.0.1.4.0 or 2.0.1.5.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 2.0.1.4.0, or 2.0.1.5.0.

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

When upgrading to 2.0.1.6 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, 2.0.1.4, and 2.0.1.5) Only

Oracle Beehive 2.0.1.6.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, 2.0.1.4, and 2.0.1.5). 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.6.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, 2.0.1.4.0, or 2.0.1.5.0, Shut Down Oracle Beehive

Unless you are patching an Oracle Beehive 2.0.1.2.1, 2.0.1.3.0, 2.0.1.4.0 or 2.0.1.5.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, 2.0.1.4.0 or 2.0.1.5.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 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.6.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.6.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 8440319 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 (only for 11.1.0.7.0) 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.6.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.6.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.6.0 Cumulative Patch Set, you can still apply the 10134218 patch at that time, and then complete the 2.0.1.6.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.6.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.6.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, 2.0.1.4.0 or 2.0.1.5.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, 2.0.1.4.0 or 2.0.1.5.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, 2.0.1.4.0 or 2.0.1.5.0 to 2.0.1.6.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 12562203
    

    (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.6.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.6 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.6.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, 2.0.1.4.0 or 2.0.1.5.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/12562203/db

Gather Statistics about Oracle Beehive Data and Code Schemas

After upgrading to Oracle Beehive Release 2 (2.0.1.6) 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>/12562203/Beehive_20160/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:

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

      BeekeeperVersionUpgradeTo20160.zip
      

    A subdirectory will be created containing the script

  3. Run the shell script as follows:

    • In Oracle Beehive instances:

      For Linux and UNIX:

      % BeehiveVersionUpgradeTo20160.sh <PATH_TO_ORACLE_HOME>
      

      or for Windows:

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

      For UNIX and Linux:

      % BeehiveVersionUpgradeTo20160.sh <PATH_TO_ORACLE_HOME>
      

      or for Windows:

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

      For UNIX and Linux:

      % BeekeeperVersionUpgradeTo20160.sh <PATH_TO_ORACLE_HOME>
      

      or for Windows:

      % BeekeeperVersionUpgradeTo20160.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.6.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.6.0 or Oracle Beekeeper 2.0.1.6.0)

    5. To confirm the versions of other subcomponents, expand Oracle Beehive or Oracle Beekeeper 2.0.1.6.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.6.0 
      Oracle Beehive Release 2 Database Support 2.0.1.6.0 
      Oracle Beehive Release 2 Binaries 2.0.1.6.0 
      Oracle Beehive Release 2 Libraries 2.0.1.6.0 
      Oracle Beehive Release 2 Services 2.0.1.6.0 
      Oracle Beehive Release 2 Configuration Wizard 2.0.1.6.0 
      Oracle Commuication and Messaging Services 2.0.1.6.0
      Oracle Beehive Release 2 Oneoffs 2.0.1.6.0
      

      On Windows, also confirm:

      Oracle Collaboration Coexistence Gateway 2.0.1.6.0
      

      On Oracle Beekeeper:

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

Apply Patch 13259069 After Upgrading to 2.0.1.6.0

After upgrading to 2.0.1.6.0, you must apply the patch 13259069.

This patch resolves the issue of artificial load caused on the system when emptying the trash folder with some items that are unremovable.

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, 2.0.1.4.0 or 2.0.1.5.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, 2.0.1.4.0 or 2.0.1.5.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 the following resource:

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

Out of the box, Beehive Conferencing uses the "official" versions of these files by accessing the file 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://www.oracle.com/pls/bee2/homepage

Resolved Issues

Table 2, "Resolved Issues in Oracle Beehive 2.0.1.6.0 Cumulative Patch Set" lists the issues resolved in this 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, 2.0.1.4.0 and 2.0.1.5.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.6.0 Cumulative Patch Set

Defect Number Description

Admin

12706424

The Beectl command 'LIST_CALENDARS --SHOW ALL BY WORKSPACE' returns an error if the workspace was created using beectl.

12381496

When attempting to export a workspace, that has a comma in its name, using the beectl export_workspace command fails.

BDK

12582417

BDK calls related to Categories throws exception.

Beehive Central

12723064

The Calendar & Tasks preference page available in the Beehive Central client should provide the full URL of the "publicfreebusy.ics" resource in addition to the "publicfreebusy.ifb" resource.

12639235

When a user updates their voice mail PIN from Beehive Central the voice principal should be unlocked if it had been previously locked.

RTC

12875240

Web Conferences do not correctly display full screen PowerPoint presentations

12768508

The "Stop Control" button disappears for users on 64-bit Windows 7 machines.

12736975

As a group member creating a new task in a team workspace fails.

12736969

Presenters cannot share their screen on Mac OS 10.7 (Lion)

12723844

The Linux client fails to recognize input and output audio devices for Beehive Voice Chats.

12679444

The desktop Conferencing Client crashes if there is no Documents folder in the host's Personal Workspace.

12641672

Date and Time are not displayed correctly for Day Events.

12339842

The desktop Conferencing Client climbs to 100% CPU usage after a few minutes.

11729573

The Linux client crashes when presenters try to present a second time.

11058925

The client crashes on some Mac machines because of an OpenGL error.

Services

12906949

Using the WebMail interface, when you create a new contact, then tag it with a Category, it does not get synchronized to your mobile device.

12870720

E-mail service is not able to read some big mime files.

12810402

Users with limited privileges should not be able to change a workspace's e-mail address.

12752667

From Beehive Conference page, Install button on top right corner does not work for Safari 5.

12728365

Insufficient information in Delivery Status Notifications.

12696813/10393280

E-mails sent with unbalanced quotes leads to parsing exception stack traces in the logs for invalid e-mail IDs.

12657075

On the iOS client, users cannot edit the server settings.

12613335

Changing the ownership name for a team workspace does not change the primary contact name.

12593483/9436913

Beectl list_groups does not provide a useful view of the external contacts.

12422467/8230840

The SMTP and IMAP servers do not have a log setting that outputs the exact protocol stream.

12385305

When you delete and IMAP folder the e-mail service should purge the folder instead of moving it to the trash folder.

12366449

Can not load specific e-mail message using basic projection.

12346557

E-mails are stuck in queue and not delivered.

11938657

Errors repeatedly in the database alert log after applying 2.0.1.5 patchset with 11.2.0.1 database.

11901785

Beehive Mobile pushmail client does not sync.

11893120

Large dynamic groups do not list all the members.

11898175

Sync range for Events and tasks supported for 999 days.

11893095

No return path when sending external meeting Notification e-mails results in some e-mail servers rejecting them.

11890998

After upgrading Beehive from 2.0.1.2.1 to 2.0.1.4.0, LDAP Sync is no longer syncing updates from OpenLDAP to Beehive UDS.

9476414

Disable a user in OID does not disable them in Beehive.

Webmail

12652280

The Webmail interface does not display ALL folders when expansion of a folder list that contains several folders.

12652240

Attendees can only see the e-mail address of the organizer in meeting view

12564759

Creating a new in the Webmail interface with an invalid e-mail address leads to entered information for the contact being lost.

12370998

The Webmail interface does not show an attachment icon for entries with mail message attachments.

11655729

Certain e-mails forwarded as attachments cannot be deleted from the Webmail interface.

10627801

Attempting to rename a system provided tag from the Webmail interface results in unexpected error.

9362584

Forwarding some e-mails with attachments from the Webmail interface does not result in the attachment being forwarded.

9292356

Any group selected as a result of auto complete from the Webmail interface will be not get expanded properly.

OBEO

12781035

In certain Outlook versions it is not possible to use the Export functionality to export sub-folders under Deleted Items folder. Note: Solution to be provided for Outlook 2007 and Outlook 2010. Existing workaround should hold for Outlook 2003.

12530248

Need to make online conference meetings more obvious to the end users and more intuitive when creating them using Oracle Beehive Extensions for Outlook.

12330506

Interface need to be improved to allow users to control the network connection status notification. Users should be able to chose to see/hide the notification for the profile or just for a session.

8967381

Install the Language pack in a Non-DMS environment.

OBEE


12552436

Error displayed when manipulating a 'beehive link' created for a file that is being uploaded.

10383257

In specific cases workspace permission error is displayed erroneously when modifying user role.


Known Issues

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customers have access to electronic support through My Oracle Support. For information, visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info or visit http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs if you are hearing impaired.


2.0.1.6.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, 2.0.1.4.0, and 2.0.1.5.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.