Primary Note for Oracle Communications Convergence (Doc ID 1298122.1)

Last updated on FEBRUARY 06, 2024

Applies to:

Details

This is the Primary Note for Oracle Communications Convergence which is a component of the Oracle Communications Unified Communications Suite. The Primary Note for the Suite may be found here - Oracle Communications Unified Communications Suite Primary Note (Doc ID 1297190.1)

Audience

The information contained in this note targets product administrators and installers.

About Convergence

Convergence is a web-based Java application deployed on a server in either Oracle GlassFish Server or Oracle WebLogic Server which provides integrated access to voice, video, screen sharing, email, calendar, address book, and IM services via a highly intuitive and richly functional user interface.

Actions

Getting Started

Oracle Communications Convergence 3.0.3.0.0 is the latest version of Convergence, available only as a MOS release.

The documentation links below all refer to the latest release unless otherwise noted.

Documentation

The most recent product documentation may be found here:

• Convergence 3.0.2 Documentation (available in HTML, PDF, ePub or Mobi formats)
  • Installation and Configuration Guide
  • System Administrator's Guide
  • Security Guide
  • Customization Guide
  • Release Notes

The most recent Release Notes and details of what is new in Convergence 3U2 (3.0.2.0.0) may be found here:

• Oracle® Communications Convergence Release Notes Release 3.0.2
• What's New in Convergence 3.0.2

The most recent Release Notes and details of what is new in Convergence 3.0.0 may be found here:

• Convergence 3.0.0.1.0 Release Notes (pdf)
• New Features in Convergence 3.0.0.1.0 (pdf)
• Convergence 3.0.0.0.0 Release Notes (pdf)
• New Features in Convergence 3.0.0.0.0 (pdf)

Deployment Planning

The following documents may prove useful for deployment planning prior to installation:

• Planning Your Convergence Installation
• Oracle Communications Unified Communications Suite Deployment Planning Guide Release 7.0 (pdf)

For compatibility of various Unified Communications Components, see:

• Oracle Unified Communications Compatibility Matrix (Doc ID 2225515.1)

Installation

The following links are short-cuts to sections within the full Installation and Configuration Guide (Release 3.0.2) (unless otherwise specified) that are specific to Convergence:

• Convergence System Requirements
• Installation Scenario - Convergence 3.0.0.1.0 (pdf)
• Configuration Worksheets - Convergence 3.0.0.1.0 (pdf)
• Convergence Initial Configuration

Quick reference for deploying the whole Unified Communications Suite on a single host for evaluation has not yet been updated for Unified Communications Suite 8 but the older document for 7 Update 6 is still available and can be found in the following step-by-step guides:

• Deployment Example: Oracle Communications Unified Communications Suite 7.0.6 on a Single Host (Solaris) (pdf)
• Deployment Example: Oracle Communications Unified Communications Suite 7.0.6 on a Single Host (Linux) (pdf)

The following document provides additional advice if the installation is taking place on Solaris Zones:

• Installing Communications Suite on Solaris Zones (pdf)

Upgrading

The upgrade to Convergence 3 cannot be performed by simply applying a patch but must utilize the Communications Suite Installer.

• Upgrading Convergence - Release 3.0.2
• Upgrading to Convergence Version 3.0.0.0.0 (pdf)

Likewise, the upgrade from Convergence 1 to Convergence 2 cannot be performed by simply applying a patch but must utilize the Communications Suite Installer and these instructions are still available here.

• Upgrading Convergence 1 Update 3 to Convergence 2 (pdf)

NOTE: Due to changes in the Dojo Toolkit (the AJAX toolkit utilized by Convergence) it is not possible to directly use customizations written for Convergence 1 "as is" once upgraded to Convergence 2 or Convergence 3.  Therefore, if a Convergence 1 deployment uses customizations, it is necessary to install a development Convergence 2 or Convergence 3 server in order to port and test the customizations prior to upgrading production servers.

Administration

The Convergence Administration Guide contains a lot of useful information including the following most commonly referenced sections:

• Overview of the Convergence Command-line Utility
• Convergence Configuration Properties Reference
• Convergence Administrative Tasks

Customization

Customization in Convergence 3 should be compatible with customizations in Convergence 2 Patch 1 onwards, although minor tweaks may be necessary depending on whether changes have been made to the underlying Convergence client code itself.  It is best to verify customizations are working as desired prior to rolling out Convergence 3 to production.

The customization framework described in the following documents applies to Convergence 3 and Convergence 2 Patch 1 or later:

• Convergence Customization Guide Release 3.0.2
• Convergence 2.x Customization Guide (pdf)

Note: To implement customizations in Convergence 2 it is necessary to apply Patch 1 (or later revision). 

Note: Due to the changes in the Dojo Toolkit it is necessary to port any Convergence 1 customizations to the new file layout beginning in Convergence 2 Patch 1.  It may also be necessary to rewrite the customizations due to underlying code changes in the Convergence client code itself.

For reference, the Convergence 1 customization guide can be found here:

• Convergence 1.x Customization Guide (pdf)

It is advisable to keep current with Convergence patches since new features are occasionally added which allow additional customizations to be implemented - i.e. not all customization examples in the documentation will work unless the system is running the most current patch.

Performance Tuning

• Tuning GlassFish Server 3.x to Enhance Convergence 3.x Performance
• Convergence 2.x Performance Tuning (pdf)
• In the Communications Suite Tuning and Best Practices (pdf) chapter there are sections for both Convergence and the GlassFish Application Server in which it is deployed. It is strongly recommended that these guides are followed for Convergence 2 and Glassfish 2.1.1.

Patches

Convergence 3

Convergence 3 patchsets are shipped in ARU format and must be applied using "commpkg upgrade".  Be sure to select the correct OS Platform for download.

Convergence 3 Release 3.0.3 is now available as a MOS release only. 

Convergence 3 Release 3.0.2 is available:

• Download the Convergence software for your operating system from the Oracle software delivery web site: - https://edelivery.oracle.com/
  • Please make sure to review the Release Notes and the Full Documentation Set

Earlier patches

• Convergence 3.0.1.4.0. Patchset 26533300
• Convergence 3.0.1.3.0 (aka 3 Update 1 Patch 3), Patchset 23759291 [This patch introduced new config parameters.  See: Convergence 3.0.1.3.0: New Configuration Parameters Introduced (Doc ID 2174653.1)]
• Convergence 3.0.1.2.0 (aka 3 Update 1 Patch 2), Patchset 22670481
• Convergence 3.0.1.1.0 (aka 3 Update 1 Patch 1), Patchset 21926259
• Convergence 3.0.1.0.0 (aka 3 Update 1), Patchset 21136441
• Convergence 3.0.0.2.0 (aka 3 patch 2), Patchset 20063356

Convergence 2

Convergence 2 Patch 7 is now available:

• 145711-07 - Convergence 2.0-7.01 Solaris Sparc: core patch
• 145712-07 - Convergence 2.0-7.01 Solaris x86: core patch
• 145713-07 - Convergence 2.0-7.01 RHEL4.0 RHEL5: core patch

Convergence 1

• 137631-17 - Sun Convergence 1.0-17.01 Solaris Sparc: core patch
• 137632-17 - Sun Convergence 1.0-17.01 Solaris x86: core patch
• 137633-17 - Sun Convergence 1.0-17.01 RHEL4.0 RHEL5: core patch

Knowledge Articles

To browse or search all Convergence knowledge articles in MOS, switch to the "Knowledge" tab then in the "Knowledge Base" section under "Select a product or product line" you need to choose "Oracle Communications Convergence" (the easiest way to do this is to type "convergence" in the field and select the full product name from the list provided in the dropdown). Once the product is correctly selected then clicking on "Search" without entering any search terms should allow the full collection to be browsed. Naturally, entering a search term will restrict the list returned to only articles relevant to that term.

Contacts

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.