Release Note

Contents

Introduction

As of February 1, 2012, Genesys is no longer an affiliate of Alcatel-Lucent; any indication of such affiliation within Genesys products or packaging is no longer applicable. Please see the Genesys website at http://www.genesys.com for more details.

This release note applies to all 8.1 releases of Web API Server.

• Links in the Contents section enable you to access information regarding a specific release. Releases are listed by version number rather than in date order. For this reason, a recent release may be listed after earlier releases, if the version number is lower. Except when otherwise noted in the information for a specific release, each release includes all of the features and corrections that were introduced for the applicable operating system at earlier dates, regardless of the version numbering.
• The Release Number table lists the supported operating systems for each release at a high level. For more detailed information, see the Genesys Supported Operating Environment Reference Guide.
• The Known Issues and Recommendations section is a cumulative list. It includes information on when individual items were found and, if applicable, corrected.
• The Corrections and Modifications section for each release may list additional issues that were corrected without first being documented as Known Issues.
• The Discontinued Support section is cumulative. It lists functionality that is no longer supported and the release number of the version in which support was discontinued.

Use of Third-Party Software

Supported Operating Systems

New in This Release

This is a hot fix release of this product. This release contains no new features or functionality.

Corrections and Modifications

This release includes the following correction and modification:

In Build 2 of 8.1.200.05, released on 10/13/2014, Web API Installer is now compatible with UTF8. (ESR-8463)

Web API Server no longer runs out of memory when sending chat requests. Previously, for each request sent to Chat Server, Web API Server created a thread that did not exit on its own, and the accumulation of these threads caused Web API Server to run out of memory. (ER# 320298397)

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix release of this product. This release contains no new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:

In this release, clients no longer incorrectly terminate chat sessions in situations with heavy loads.

Previously it happened that, with loads of 30�50 connections per second to Web API Server, clients could not establish a connection to Chat Server, producing the message java.lang.IllegalArgumentException: Exception while registering mbean when running with a heavy load.

Note: The figure of 30�50 connections per second depends on the performance of hardware and the network: on weak servers (especially those running under Virtual Machines) this issue could arise with only 10�20 connections per second from Chat clients. (ER# 315257631)

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in this release of Web API Server.

• New sample web pages that demonstrate the Hosted Web API Server capabilities for Hosted Provider Edition e-mail and chat services for multiple tenants.
• Ability to add an E-mail Server or a Chat Server to a tenant and configure that tenant in Genesys Administrator Extension to use a Hosted Web API Server, in addition to the existing premise-based configuration.

Corrections and Modifications

There are no corrections or modifications for this release.

Top of Page

Supported Operating Systems

New in This Release

This is a hot fix release of this product. This section describes new features that were introduced in this release of Web API Server.

• This release contains two new Java samples for use in Genesys Hosted Provider Edition: E-mail Multitenant and Chat Multitenant. Their features and functionality are the same as the Java Samples for E-mail and Chat, respectively, and the descriptions of those samples in the eServices 8.1 Web API Client Developer's Guide apply, except that the Multitenant samples do not make use of the constants.jsp file or of any JavaScript libraries. Instead, these functionalities are accomplished separately in each sample, by a set of statements located at the beginning of the sample's code. In particular, each file starts off with the following material, not found in the existing samples:
  • For the E-mail Multitenant sample, the Email.jsp file starts off with a group of statements setting the local constants, such as the tenant's name.
  • For the Chat Multitenant sample,
    • The HtmlChatCommand.jsp file starts off with a group of statements setting the values of mask_html and mask_html_for_textarea.
    • The HtmlChatFrameset.jsp file starts off with a group of statements that look for a valid tenant and produce an error message if none is found.
    • The HtmlChatPanel.jsp file starts off with a group of statements setting the local constants, such as the tenant's name.

Corrections and Modifications

This release also includes the following correction and modification:

Web API Server no longer fails to connect to backup servers when the primary server is in an application cluster. (ER# 284043291)

Top of Page

Supported Operating Systems

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in the initial 8.1 release of Web API Server.

• Additional operating system support:
  • Red Hat Enterprise Linux 5 64-bit compatibility
  • Red Hat Enterprise Linux 5 64-bit native
  • Windows Server 2008 64-bit native
• Ability to receive connection parameters from special properties file or through environment variables instead of, or in addition to, the parameters that are specified in the web.xml configuration file.
• Support of TLS with Configuration Server, Solution Control Server, Chat Server, Interaction Server, Stat Server, E-mail Server, and Universal Contact Server.
• Client-side port definition with Configuration Server, Solution Control Server, and Message Server.
• New sample named Chat HA to work with High Availability (HA) Chat Server.
• New sample Facebook Chat, Facebook Email, and Facebook Callback to demonstrate chat, email and web callback media processing from Facebook.
• Facebook users can now work with chat, email, and web callback media by using applications they have created in Facebook.

Corrections and Modifications

This release also includes the following correction and modification:

Web API Server now successfully connects to Solution Control Server (SCS) 7.1.1 with Configuration Server 7.2. Previously, when Web API Server attempted to connect to this version of SCS, a NullPointer exception occurred. (ER# 277443920)

Top of Page

Known Issues and Recommendations

This section provides the latest information on known issues and recommendations associated with this product.

Web API Server fails to connect to backup servers when the primary server is in an application cluster. For example,

1. The primary Chat Server is configured as part of an application cluster.
2. The primary server is configured with a backup server, but the backup server is not part of the cluster.
3. Web API Server has a connection to the cluster.
4. Both primary and backup Chat Servers are running.
5. Then the primary Chat Server stops.
6. Web API Server does not connect to the backup Chat Server.

The e-mail samples in this release of Web API Server are not compatible with Email Server Java (ESJ) 8.0.1 and lower. (ER# 261672121)

Workaround: If you want to use ESJ 8.0 or 8.0.1, you should only use 8.0 or 8.0.1 e-mail samples. The following SimpleSamples802 folders should be populated with the contents of the same folders from SimpleSamples80 or SimpleSamples801: Email and EmailWithAttachment.

The value of the Credit card type selected in the Cobrowse with Dynamic Startup Page example is not retained throughout the example. The Credit card type value of Visa is always displayed on the shared response live page. (ER# 261672121)

Top of Page

Discontinued Support

This section documents features that are no longer supported in this software. This cumulative list is in release-number order with the most recently discontinued features at the top of the list.

Solaris 8 is no longer supported.

Top of Page

Internationalization

Information in this section is included for international customers.

When using the Korean language, the Tenant name in Web API Server TestTool801 is displayed as ??. (ER# 245443333)

Top of Page

Additional Information

Additional information on Genesys Telecommunications Laboratories, Inc. is available on our Customer Care website. The following documentation also contains information about this software. Please consult the eServices 8.1 Deployment Guide first

• eServices 8.1 Deployment Guide describes deployment procedures for all eServices components. It also contains a high-level description of the eServices system, its architecture, and a list of new features in the current release.

• eServices 8.1 User's Guide provides overall information about and recommendations on the use and operation of Genesys eServices.

• eServices 8.1 Reference Manual provides a reference listing of all configuration options and of field codes used in standard responses.

• eServices 8.1 Web API Client Developer's Guide describes the structure of the Web API, explains the Simple Samples, and describes procedures for customizing them.

• For a listing of classes, methods, fields, and constants of the Web API portion of the Web API Server component, see:

  • eServices 8.1 .NET Web API Reference for the .NET Web API
  • The API References of the Platform SDK for the Java-based Web API

• eServices (Multimedia) 8.0 Selected Conceptual Data Models for the UCS Database describes a portion of the Universal Contact Server (UCS) database.

• 8.1 Universal Contact Server Manager Help is a guide to the Universal Contact Server Manager user interface.

• eServices 8.1 Knowledge Manager Help is a guide to the Knowledge Manager user interface.

• Universal Routing 8.1 Interaction Routing Designer Help is a guide to Interaction Routing Designer, including the portion of it that designs interaction workflows and business processes for eServices.

• Universal Routing 8.1 Business Process User's Guide contains step-by-step instructions for using Interaction Routing Designer to design interaction workflows. It also describes the sample business processes supplied with eServices.

• Genesys Desktop 7.6 Help is a guide to using the Genesys Desktop.

• Genesys 8.1 Security Deployment Guide describes the deployment and configuration of some of the security features provided in Genesys software.

• Genesys Events and Models Reference Manual includes a set of basic interaction models, showing the components involved and the event messages sent among them. For authoritative description of the event messages, see the next item.

• The API References of the Platform SDK, which provide the authoritative information on methods and functions for each SDK, including requests and events. The class Message includes all event and request messages.

• eServices Social Media Solution Guide describes deployment and use of the Genesys Social Messaging product.

Product documentation is provided on the Customer Care website, the Genesys Documentation website, and the Documentation Library DVD (produced monthly).

Note: For the DVD, the New Documents on this DVD page indicates the production date for that disc. Due to disc production schedules, documentation on the Genesys Documentation website may be more up-to-date than what is available on disc immediately after a product is released or updated. To determine the version of a document, check the version number that is located on the second page in PDFs or on the About This File topic in Help files.

Top of Page