Release Note

Platform SDK & Application Blocks for Java

8.0.x

Genesys Telecommunications Laboratories, Inc. © 2009-2011

Contents

Introduction

Release Number AIX HP-UX Linux Solaris Tru64 UNIX Windows
8.0.200.14 [10/18/11] – Hot Fix X X X X   X
8.0.200.13 [09/01/11] – Hot Fix   X       X
8.0.200.12 [07/12/11] – Hot Fix X X X X   X
8.0.200.10 [03/25/11] – Hot Fix X X X X   X
8.0.200.06 [10/07/10] – General X X X X   X
8.0.100.09 [03/09/10] – General X X X X   X
8.0.000.11 [02/18/11] – Hot Fix X X X X   X
8.0.000.09 [07/24/09] – General X X X X   X

Link to 7.6 Product Release Note (Cumulative)
Known Issues and Recommendations
Discontinued Support
Internationalization
Additional Information


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.0 releases of the Platform SDK & Application Blocks for Java.

Use of Third-Party Software

Genesys follows applicable third-party redistribution policies to the extent that Genesys solutions utilize third-party functionality. For additional information on third-party software used in this product, see the Read Me. Please contact your technical support representative if you have any questions.


Release Number 8.0.200.14 [10/18/11] – Hot Fix

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:


The new ServerChannel.closeListener() method allows server applications to shut down safely. Previously, when a listening ServerSocket was closed some external resources that were still in use were also shut down. (ER#s 283578520, 283317761)


Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents
Library Subcomponents
Application Block Subcomponents

Top of Page


Release Number 8.0.200.13 [09/01/11] – Hot Fix

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:


ADDP messaging now includes improved synchronization. Previously, duplicate ADDP messages were sent in some scenarios. (ER# 279154111)


Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents
Library Subcomponents
Application Block Subcomponents

Top of Page


Release Number 8.0.200.12 [07/12/11] – Hot Fix

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:


The Netty-based connection layer implementation has been modified to prevent premature release of system resources. Previously, releasing system resources incorrectly could lead to sudden disconnection of client-side channels. (ER# 274000141)


Warm standby now behaves correctly when Platform SDK connects to a server in backup mode. Previously, attempts to reconnect were unsuccessful because RegistrationException was thrown, stopping the warm standby service. (ER# 275156743)


Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents
Library Subcomponents
Application Block Subcomponents

Top of Page


Release Number 8.0.200.10 [03/25/11] – Hot Fix

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

Corrections and Modifications

This release includes the following corrections and modifications:


The Commons library was extended with a new class, com.genesyslab.platform.commons.protocol.WildcardEndpoint, which allows "anylocal" IP addresses to be specified for server-side protocol implementations. A socket opened with the "anylocal" address will listen for connections on all available network interfaces.

Please note that opening such sockets on hosts which have IPv6 network interfaces may be subject to platform-dependent issues. For more information, refer to:

(ER# 266524191)


Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents
Library Subcomponents
Application Block Subcomponents

Top of Page


Release Number 8.0.200.06 [10/07/10] – General

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in this release of the Platform SDK & Application Blocks for Java.

Corrections and Modifications

This release also includes the following corrections and modifications:


This release of the Platform SDK & Application Blocks for Java supports auto-detection for the Configuration Server port. To enable this feature, set the com.genesyslab.platform.commons.connection.factory.class system property to com.genesyslab.platform.commons.connection.impl.netty.NettyConnectionFactory.

Note: This feature is not enabled by default, and does not support the server channel.

(ER# 245258931)


Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents
Library Subcomponents
Application Block Subcomponents

Top of Page


Release Number 8.0.100.09 [03/09/10] – General

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in this release of the Platform SDK & Application Blocks for Java.

Corrections and Modifications

This release also includes the following corrections and modifications:


Using the Platform SDKs with LivePerson Adapter no longer results in an unhandled exception when parsing dates in returned events. (ER# 231117819)


The Platform SDK for Java now deserializes message attributes of type long correctly. (ER# 111058706)


Java documentation included with the Platform SDKs has been updated to remove incorrect links.

Genesys still recommends checking for and downloading the latest available SDK documentation from the Genesys Developer Zone on a regular basis. (ER# 226399770)


Subcomponents in this Release

This release of the Platform SDK contains three types of subcomponents: SDKs, libraries, and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Subcomponents
Library Subcomponents
Application Block Subcomponents

Top of Page


Release Number 8.0.000.11 [02/18/11] – Hot Fix

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

This is a hot fix for this product. This release does not contain new features or functionality.

This hot fix is based on an earlier release of the product and does not include new features or corrections made in higher-numbered releases.

Corrections and Modifications

This release includes the following corrections and modifications:


Connections that are closed due to an ADDP timeout now include a reason in the cause field. Previously, clients (such as the WarmStandby Application Block) could not distinguish between an ADDP timeout and normal use of the close() method. (ER# 233534651)


The ConnectionId property of DNAction is now decoded properly by using the server byte order. (ER# 265450111)


Subcomponents in this Release

This release of the Platform SDK contains two types of subcomponents: SDKs and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Components
Application Blocks

Top of Page


Release Number 8.0.000.09 [07/24/09] – General

Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information

Supported Operating Systems

The operating systems supported by this release are listed in the Contents, above.

New in This Release

There are no restrictions for this release. This section describes new features that were introduced in the initial 8.0 release of the Platform SDK & Application Blocks for Java.

Corrections and Modifications

This release includes the following corrections and modifications that were made between Release 7.6 or earlier releases and the initial 8.0 release:


Shortcuts to the Application Blocks are now handled correctly when multiple versions of the Platform SDK for Java are installed on a single computer. Previously, shortcuts to different versions of the Application Blocks could be grouped together incorrectly. (ER# 219851827)


Subcomponents in this Release

This release of the Platform SDK contains two types of subcomponents: SDKs and application blocks. Release numbers of the individual subcomponents are provided below:

SDK Components
Application Blocks

Top of Page


Known Issues and Recommendations

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


Documentation provided with the Platform SDKs is still being improved and enhanced. To ensure you are working with the most correct and comprehensive information, please download the most recent SDK documentation from the Genesys Documentation website.


On the Solaris 10 platform, the Platform SDKs cannot open a connection due to an I/O failure in the selector loop in the connect() method. This is a problem with the Solaris 10 JDK. For a workaround, see http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=6322825. (ER# 87809431)


The Tru64 Unix platform does not provide support for JDK 1.5 or later. This limitation prevents all releases of the Platform SDK 8.0 from running on Tru64 Unix platforms.


Some links in the initial Java documentation included with the Platform SDKs may not work correctly. Download the most recent SDK documentation from the Genesys Developer Zone to fix this issue. (ER# 226399770)

Found In: 8.0.000.09 Fixed In: 8.0.100.09

When using the Platform SDKs with LivePerson Adapter, an unhandled exception might occur when the Platform SDK is parsing dates in returned events. This exception can cause the connection to all attached servers to be lost. (ER# 231117819)

Found In: 8.0.000.09 Fixed In: 8.0.100.09

If you specify an IPv6 host in an Endpoint, an exception will occur. This is because, first of all, the Platform SDK for Java is based on NIO, and secondly, NIO does not support IPv6 in Java 1.4 through 1.6. Until Java adds support for IPv6, single stack servers will not be able to use IPv6. For dual stack machines it is possible to "prefer" IPv4 using a system property of java.net.preferIPv4Stack=true. For more information, see http://java.sun.com/j2se/1.4.2/docs/guide/net/ipv6_guide/. (ER# 218480097)

Found In: 7.6.201.03 Fixed In: 

The Platform SDK for Java incorrectly deserializes message attributes of type long. (ER# 111058706)

Found In: 7.5.000.14 Fixed In: 8.0.100.09

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.


There are no discontinued features or functions in this release of the Platform SDK & Application Blocks for Java 8.0.


Top of Page


Internationalization

Information in this section is included for international customers.


There are no internationalization issues for this product.


Top of Page


Additional Information

Additional information on Genesys Telecommunications Laboratories, Inc. is available on our Technical Support website. The following documentation (located on the Developer Documentation CD, the Technical Support website, and the Genesys Documentation website) also contains information about this software. Please consult the Deployment Guide first.

Product documentation is provided on the Technical Support website, the Genesys Documentation website, and the Documentation Library DVD (produced monthly) or the Developer Documentation CD.

Note: For the DVD/CD, the New Documents on this DVD/CD page indicates the production date for that disc. Due to disc production schedules, documentation on the Technical Support 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