This chapter provides an overview of the new features introduced in Oracle Communications Convergence 3.0.3.0.0.

New Features Delivered in Convergence 3.0.3.0.0

This section lists the new features released in Convergence 3.0.3.0.0.

Support for Resetting Passwords

From Convergence 3.0.3.1.0 onwards, you can reset your password using SMS and Secondary Email. From release 3.0.3.4.0 onwards, you can reset your password using Oracle Mobile Authenticator (OMA), SMS, or Email. For instructions, see Convergence Online Help.

By default, this option is disabled. Your administrator can enable it by running the following command:
./iwcadmin -o base.enableforgotpassword -v true

When the option is enabled, you can change your password by clicking the Forgot Password link provided in the Convergence login page. The password reset functionality is protected by two-factor authentication. For more information on enabling two-factor authentication, see Oracle Communications Convergence System Administrator's Guide.

Multi-factor Authentication (MFA) Using SMS and Secondary Email

From release 3.0.3.4.0 onwards, Convergence supports Multi-factor Authentication during login using SMS and Secondary Email. This enhances security by adding an additional layer of authentication beyond just a username and password. It restricts unauthorized individuals to gain access to sensitive information.

By default, this feature is disabled. When this feature is enabled, you can login to Convergence by entering the username, password and then the OTP recieved by SMS or on your Secondary Email.

For more information on using SMS and Secondary Email, see "Overview of Convergence Online Help" in Convergence Online Help.

For more information on configuring multi-factor authentication, see "Configuring Multifactor Authentication using Oracle Mobile Authenticator" in Convergence System Administrator's Guide.

Multi-factor Authentication (MFA) Using Oracle Mobile Authenticator (OMA)

From release 3.0.3.4.0 onwards, Convergence supports Multi-factor Authentication during login using Oracle Mobile Authenticator. This enhances security by adding an additional layer of authentication beyond just a username and password. It restricts unauthorized individuals to gain access to sensitive information.

By default this feature is disabled. When this feature is enabled, you can login to Convergence by entering the username, password and then the OTP generated by Mobile Authenticator.

Directory Server Setup 6.4.0.29.0 or above is required for this feature to work.

For more information on using OMA, see "Overview of Convergence Online Help" in Convergence Online Help.

For more information on configuring multi-factor authentication, see"Configuring Multifactor Authentication using Oracle Mobile Authenticator" in System Administrator's Guide.

Support for Arabic Language

Support for Arabic language is introduced in Convergence 3.0.3.2.0.

Default RMI Listener is localhost from Convergence 3.0.3.2.0 Onwards

The default RMI listener is set to localhost in Convergence 3.0.3.2.0. By default, only the locallhost option is enabled. A new parameter, rmi.uselocalhost is introduced in the adminservice.properties file under the config folder. You can set this parameter to true or false. This configuration parameter requires a server restart for the changes to take effect. The default value for rmi.uselocalhost is true.

For information about Tuning Iwcadmin Configuration Management Connectivity Login Required, see My Oracle Support article 2637365.1 at: https://support.oracle.com/knowledge/More%20Applications%20and%20Technologies/2637365_1.html.

JDK 8 Support

Convergence 3.0.3.0.0 and beyond is supported on JDK 8 and above. Support for JDK 7 is removed.

Support for Oracle Unified Directory

Convergence 3.0.3.0.0 release supports Oracle Unified Directory Server 12.2.1.4. For Oracle Unified Directory support, you must install and run DS setup 6.4.0.30.0.

For more information, see "Preparing the Directory Server" and "rundssetup Reference" in Convergence Installation and Configuration Guide.

New Convergence Configurator Utility

Convergence 3.0.3.0.0 provides a rewritten initial configuration utility (init-config). Prior to Convergence 3.0.3.0.0, init-config was built using the InstallSDK framework, that has been obsoleted. The init-config utility in Convergence 3.0.3.0.0 is a simpler Perl-based command-line utility that removes the InstallSDK dependency. The new utility also makes it easier to support silent configuration in following releases.

This chapter lists the bugs that were fixed in Oracle Communications Convergence 3.0.3.0.0 and subsequent patches.

Note:

For the list of bugs that have been fixed in 3.0.3.X.0 patches, refer to the patch Readme documents on My Oracle Support (MOS).

Fixes in Release 3.0.3.0.0

Table 2-1 lists and describes the bugs fixed in this release of Convergence.

Table 2-1 Fixes in Release 3.0.3.0.0

Reference Description

Bug # 33003005

Convergence upgrade over LDAPS is now working on OL7, using openldap.

Bug # 33109545

The IWC init-config configuration was failing with JDK 1.8.0_291 due to a JNI error caused by a dependency on installsdk libraries.

This has been fixed in Convergence 3.0.3.0.0. For any version prior to that, JDK8 versions jdk 1.8.0_271 or below should be used as a workaround.

Bug # 33563575

Convergence Build and Installer supports JDK 1.8 now.

Bug # 33589870

The legacy setupJDK installer used by Convergence has been replaced with a Perl-based installer for JDK 8 support in Convergence 3.0.3.0.0.

Bug # 33605762

The OWASP html sanitizer jars have been upgraded to the latest version.

Bug # 33703121

Third party jars for Convergence have been upgraded to the latest version.

Bug # 12305572

Third Party jar upgrade for Convergence: remove http-bind, jso.jar, collab-api.jar, xp.jar, saxpath.jar, jaxen-core.jar.

Bug # 35561683

The user can restrict attachment types for end users in Convergence.

Bug # 35639870

You can configure the Convergence deployment to restrict the number of emails that can be sent to recipients within a defined time period.

Bug # 35688083

Email signatures with an apostrophe were being returned with a backslash when composing an email. This issue is now resolved.

Bug # 35908369

Some localized characters in the message body were being replaced with a replacement character when accessed from Convergence. This issue is now resolved.

Bug # 36031577

You can restrict end users from sending emails with modified From addresses.

Bug # 36138933

Convergence supports multi-factor authentication using Oracle Mobile Authenticator when logging in.

Bug # 36228951

Autocomplete can display more than 10 corporate directory users in Convergence using customization.

Bug # 13084765

The 160-character limit for a single SMS has been removed in the SMS UI because messages with a mix of ASCII and non-ASCII characters can be sent beyond character limit.

Bug # 34818478

Convergence now supports the Arabic language.

Bug # 34850101

Convergence supports email forwarding addresses up to 63 characters after @ and .

Bug # 34871810

The spacing issue seen for module names and dropdown fields in RTL mode is now resolved.

Bug # 35249020

The httpClient, httpCore, and httpmime jars have been upgraded to the latest version.

Bug # 35263940

When the Forgot Password option is enabled, users can send OTP and verify it in the LDAP schema 1.

Bug # 33737756
The following third-party jars have been removed from Convergence:
  • jso.jar
  • collab-api.jar
  • xp.jar
  • saxpath.jar
  • jaxen-core.jar

Bug # 35513179

The following third-party jars have been upgraded in Convergence (3.0.3.2.0):

  • commons-cli.jar
  • json.jar
  • log4j jars
  • owasp library jar

Bug # 35524533

Convergence now allows attachment downloads with a hash special character.

Bug # 28089615

The issue of the base.sslport configuration getting lost after a Convergence upgrade is now resolved.

Bug # 30679290

A 'Forgot Password' link has been added to Convergence login page allowing users to reset their passwords on their own.

Bug # 33968355

The ObjectClass: sunUCPreferences attribute is added to a user's LDAP entry upon their first login to Convergence using an add operation instead of a replace operation.

Bug # 34351809

When a group was selected in Convergence, it performed the search against the UID of the users instead of their email ID, causing similar UIDs to be included in the group listing. This issue is now resolved.

Bug # 34644720

The init-config script for Convergence assumed the bind DN would start with cn=, leading to errors when the DN started with something else, for example, uid=. This issue is now resolved.

Bug # 34644883

Ownership of iwc.appsrv.DocumentRootDirectory folder was set incorrectly during init_config and it results in root ownership instead of the intended <iwc.webContainerUserID>:<iwc.webContainerGroupID>.

Bug # 34647898

In Convergence, the issue with mailto links not working in plain text emails has been fixed.

Bug # 36448184

Clicking on the mailto HTML link, a new message compose window opens up but with an empty recipient (To:) address

Bug # 36965055

Password prompt appears sporadically when deleting emails in quick succession

Bug # 37194988

Javascript can be run when input into the Create Link text input field

Bug # 37302913

ThirdParty jar upgrade

This chapter describes the known problems and workarounds in Oracle Communications Convergence 3.0.3.0.0.

General and Installation Issues

This section groups together the general known issues for Convergence.

Online Help is Available Only in English

Release: 3.0.3.4.0

Bug number: 37271535

From Convergence 3.0.3.4.0 onwards, Convergence Online Help will be be available only in English.

Use of OSversionOverride Option

Release: 3.0.3.4.0

Bug number: 33905460

Convergence has to use OSversionOverride option for commpkg operations on Oracle Linux 7 or Oracle Linux 8.

No Support for Smart Phones

Release: 3.0.3.0.0

Bug number: NA

This release of Convergence does not include support for smart phones.

After Reloading UI, the Mail Tab is Displayed

Release: 3.0.3.0.0

Bug number: 12213298

When you reload Convergence in the browser, the Mail tab appears, even if you were viewing a different tab before reloading Convergence.

Messaging Issues

This section groups together the known issues pertaining to the messaging service in Convergence.

Convergence Mail Attachment Search does not Work with Messaging Server 8.1

Patch set: 3.0.3.0.0

Bug number: 29960010

When you configure Convergence with Messaging Server 8.1, Mail Attachment search does not work from Mail > Attachments.

To work around this issue, use elastic search. If elastic search is not configured, by default, bruteforce is used.

Error displayed in Tablet While Moving a Message in Two-Pane Layout

Release: 3.0.3.0.0

Bug number: 28625579

This issue is seen with tablets only. In the two-pane layout, when a user moves email messages across folders, an error is displayed in the Move Message dialog box on clicking OK. However, the message is moved to the selected folder and the error can be ignored.

Email List is Not Automatically Refreshed in Tablet After Deleting an Email in Two-Pane Layout

Release: 3.0.3.0.0

Bug number: 28643608

This issue is seen with tablets only. In the two-pane layout, when a user deletes an email, the email list is not automatically refreshed. However, the email list is getting refreshed when a user clicks on the Get Mail icon.

SMIME Feature is Not Working in Convergence 3.0.3.0.0

Patch sets: 3.0.3.0.0

Bug number: 35104338

SMIME functionalities in Convergence can only be run on browsers that support Java Applet. Since the latest browsers do not support Java Applet, SMIME features are not working in Convergence 3.0.3.X.0.

Calendar Issues

This section groups together the known issues pertaining to the calendar service in Convergence.

Yahoo Event Invitations Do Not Properly Display

Release: 3.0.3.0.0

Bug number: 18760552

When a user receives an iMIP/iTIP event notification email from Yahoo, the details are not properly displayed. The UI message format is broken, and RSVP options are not correctly displayed. In addition, the event isn't added to the calendar.

To work around this issue, add the channel option wrapsmtplonglines to control the Message Transfer Agent (MTA) behavior when it sees illegally long lines in incoming SMTP messages as per Editing MTA Channel Options. Also, manually add the event to your calendar.

See the Oracle wiki for more information:

https://wikis.oracle.com/display/CommSuite/Editing+MTA+Channel+Options

Yahoo Event Responses Are Not Displayed Properly

Release: 3.0.3.0.0

Bug number: 17388807, 16773937

When a Yahoo user has been invited to an event and that Yahoo user has replied to the invitation, the organizer of the event is likely to have problems viewing the Yahoo user's response in the calendar event.

To work around this issue, refer to the email with the Yahoo user's response to the invitation.

Cannot Invite a User to an Event if User Display Name Includes Double Quotes

Release: 3.0.3.0.0

Bug number: 17386456

If a user display name includes double quotes (for example, display"name), that user cannot be added to an invitation.

There is no workaround for this issue.

Calendar Properties Labels Incorrectly Aligned for Japanese Locale

Release: 3.0.3.0.0

Bug number: 13495595

When using Convergence in Japanese, Simplified Chinese, Traditional Chinese and Korean languages, some labels for Calendar properties are incorrectly aligned.

Address Book Issues

This section groups together the known issues pertaining to the address book service in Convergence.

Convergence Login Fails if User Has Large Number of piStore Entries

Release: 3.0.3.0.0

Bug number: 12813939

Convergence login fails if user has large number of piStore entries.

To work around this issue, reset following convergence parameters to accommodate long LDAP command delay:

  • ugldap.timeout

  • ab.storeentrieslimit

  • ab.pstore.lookthrulimit

Wait for ugldap.timeout to expire then refresh the Convergence login screen.

Options Issues

There are no known issues pertaining to Convergence user options.

Oracle WebLogic Server Issues

This section groups together the known issues for Convergence Oracle WebLogic Server.

Oracle WebLogic Server does not Support Oracle Solaris 10

Patch set: 3.0.3.0.0

Bug number: 29719615

When you use Oracle WebLogic Server, Convergence configuration script fails to deploy Convergence on Solaris 10. Oracle Solaris 10 is not a certified platform for Oracle WebLogic Server 12.2.1.3.0.

Context path of static files is fixed to iwc_static for Convergence Deployed on Oracle WebLogic Server

Patch set: 3.0.3.0.0

Bug number: 31028618

When you configure Convergence on Oracle WebLogic Server, it deploys two applications, Convergence and Convergence_Client. By default, the context root for Convergence is /iwc. You can modify this context root during the initial configuration.

The context root for Convergence_Client is /iwc_static and you cannot modify this option during the initial configuration.

Advertising Issues

There are no known issues pertaining to the advertising module in Convergence.

Customization Issues

This section groups together the known issues for Convergence customizations.

Default IWCP Command Format in XML and Invalid Commands Return XML Only

Release: 3.0.3.0.0

Bug number: 12807684

Response of invalid commands with explicit fmt-out=text/json only return XML.

Convergence Does Not Display Right-to-Left Languages Properly

SR number: 1-473996841, 1-584006005, 1-622051802

Bug number: 12247522 (SUNBT6745772)

This issue occurs if you enable customization and perform the steps to add a custom language to Convergence, then log in as a user created in LDAP with a language preference set to the custom language (for example, Arabic). The UI displays text and aligns widgets left-to-right instead of right-to-left.

Convergence Hangs After Adding New Language

Release: 3.0.3.0.0

Bug number: 12247514 (SUNBT6745757)

This issue occurs if you enable customization and perform the steps to add a custom language to Convergence, creating a directory structure as shown in this example:

c11n_Home/allDomain/nls/new_language/resources.js

Convergence does not load the directory and the Convergence UI never appears.

To work around this issue, create an empty resources.js file in the c11n_Home/allDomain/nls directory (in addition to the resources.js file in the new_language directory).

This chapter lists any important documentation updates in this release of Oracle Communications Convergence.

Convergence Glossary

A glossary is included as an appendix to Convergence System Administrator's Guide.

New Appendices

Convergence Installation and Configuration Guide is enhanced with:

  • An appendix containing reference information about the Unified Communications Suite installer and the commpkg command.

  • An appendix containing reference information about preparing the directory server and the rundssetup script.

  • An appendix containing reference information about scripts used in Convergence.

  • An appendix containing reference information about Migrating ODSEE deployment to OUD deployment.

This chapter lists any features deprecated or removed from Oracle Communications Convergence.

Deprecated Features

Convergence no longer supports social add-on services.

Removed Features

There are no removed features in this release of Convergence.

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 customer access to and use of Oracle support services will be pursuant to the terms and conditions specified in their Oracle order for the applicable services.