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 |
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.
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.
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
This is a hot fix for this product. This release does not contain new features or functionality.
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)
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:
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
This is a hot fix for this product. This release does not contain new features or functionality.
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)
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:
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
This is a hot fix for this product. This release does not contain new features or functionality.
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)
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:
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
This is a hot fix for this product. This release does not contain new features or functionality.
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)
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:
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
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.
Switch Policy Library for Java — Exposes policies for all supported switches to developers, offering flexibility in adjusting for switch-specific behavior or adding new switch policies. For details, refer to the related subcomponent release note.
Maven2 Support — A Maven2-style XML description of the Platform SDK component dependencies is now shipped with Platform SDK for Java. Platform SDK-based applications can now be built using Maven.
Improved ADDP support — Advanced Disconnect Detection Protocol (ADDP) can now be configured for closed connections, with configuration details stored in a queue until a session is opened (including TLS initialization).
Subscribe to Attributes — You can now create a subscription to any attribute in any message (as long as you know the related IDs) by using the AttributeSubscriptionList
class and the ConnectionContext
interface.
EspEmail Protocol — The Web Media Platform SDK now includes the EspEmail Protocol, which provides an improved way to handle the submission of web-based e-mail to E-Mail Server Java using the RequestCreateWebEmailIn
and EventCreateWebEmailIn
messages.
Extension of Message Server API — An additional structure has been added to EventLogMessage
to represent data which had previously been presented as a binary stream.
Custom Server Protocol — Allows a router to gather information from a custom server (created using this protocol) within a routing strategy, to use when making routing decisions.
Server-Side TLS — Allows Platform SDK-based servers to secure incoming connections.
Improved Log Filtering — The new Tag
option adds the ability to "wrap" sensitive parts of a log message in pre-defined strings, which can then be used for log filtering.
Hide Data in Logs — Sensitive data can now be hidden in the Platform SDK logs. For details about dealing with sensitive data in logs, refer to the Using the Platform SDK Log Library for Java article in your API Reference.
Warm Standby Application Block Extendibility — The warm standby algorithm utilized by the application block can now be customized.
Improved platform support — The Platform SDKs now include support for Windows 7.
KeyValuePrinter
Class — The following public methods were added to the KeyValuePrinter
class to make printing easier:
public string toString(String key, Object value);
public void appendValue(StringBuffer buf, String key, Object value);
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)
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:
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
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.
The following new subcomponents were added for this release:
For details, refer to the individual subcomponent release notes.
This release of the Platform SDK & Application Blocks for Java includes support for TLS.
Note: Configuring Advanced Disconnect Detection Protocol (ADDP) for closed connections is not supported. ADDP can be configured on an already opened TLS connection, in which case ADDP is automatically enabled.
Alarm Sending/Buffering Enhancements — The Platform SDK now allows extended attributes to be attached to log messages before submission to centralized log storage. Alarm events can also be automatically buffered for up to 24 hours in the event that the connection with Message Server is lost.
Access to System Host Data — The Platform SDK now provides access to system host statistics such as CPU utilization and memory usage so that administrative desktops are able to present the data in a unified way.
Role-based Access — The Platform SDK now exposes access to role capabilities, including the ability to add or modify roles and assign a role to a user.
Last Logged In — This security feature supports the ability to determine a user�s last logged in date and time, as defined by user authentication with Configuration Server.
XML Metadata — The Platform SDK now provides XML Metadata describing application options for use by Administrative desktops.
Hierarchical Data Access — Hierarchical multi-tenancy data layers in Management Framework and Configuration Server can now be accessed using the Platform SDK.
New Management Layer Functionality — The Platform SDK now provides the ability to subscribe to Message Server events that are also buffered until processed.
Caching in Configuration Object Model (COM) Application Block Java — A caching mechanism now exists in the COM Application Block.
Note: This functionality already existed for the .NET version of the COM Application Block.
Improved OS/Platform Support:
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)
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:
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
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.
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)
This release of the Platform SDK contains two types of subcomponents: SDKs and application blocks. Release numbers of the individual subcomponents are provided below:
Supported Operating Systems
New in This Release
Corrections and Modifications
Links to Subcomponent Information
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.
The Management Platform SDK is now able to generate alarms using the new RequestActivateApplicationAlarm,
as well as receive notification of incoming alarms from Solution Control Server (SCS).
The Statistics Platform SDK now provides additional statistics functionality, taking advantage of the full Stat Server protocol. Because of these changes, the Statistics Platform SDK for this release is not compatible with previous versions of the SDK.
The new Packaged Statistics Platform SDK contains the same functionality that was offered in previous versions of the Statistics Platform SDK. The Packaged Statistics Platform SDK is deprecated, and should only be used to provide backwards compatibility for existing applications.
The Configuration Platform SDK now returns configuration data as an XMLDocument
to improve usability and presentation.
The Platform SDKs support new search capabilities introduced in the e-Services Solution.
The Platform SDKs now support client-side port definition of the client/server connection.
Support has been added for JDK 1.6 with this release. Refer to the Genesys Supported Operating Environment Reference Guide for details.
The Platform SDKs now support TCP/IP version 6 (also known as IPv6).
The Platform SDK packaging now uses a version-insensitive IP, allowing multiple versions of the SDKs to be installed at one time for development purposes.
The Platform SDKs now support the following additional platforms and versions:
The Platform SDKs now support Microsoft Terminal Service.
The Platform SDKs now support VMWare virtual platform.
The Configuration Object Model (COM) Application Block now has the ability to cache COM objects.
Documentation for the Platform SDKs has been improved and expanded, and now offer a combined API Reference that provides information about all of the SDKs and Application Blocks from a single source. See the Genesys Documentation website for a complete listing of updated documents.
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)
This release of the Platform SDK contains two types of subcomponents: SDKs and application blocks. Release numbers of the individual subcomponents are provided below:
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 |
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.
Information in this section is included for international customers.
There are no internationalization issues for this product.
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.
Platform SDK 8.0 Deployment Guide, which provides details about installing and configuring the Platform SDKs along with an overview of the Platform SDKs, their related application blocks, and available code examples.
The Platform SDK 8.0 API Reference for the version of the Platform SDK that you are using. This combined guide provides an introduction to the Platform SDKs, together with tips and recommendations about using the Platform SDK to interact with Genesys Servers. It also includes details about the messages, events, data types, and constants defined by each protocol within the Platform SDK.
Information about the Application Blocks that are packaged with this release of the Platform SDK is also included in the Platform SDK 8.0 API Reference, including tips and suggestions about how to use each application block, along with details about the classes, methods, and properties that are defined by the application block.
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.