Description:
TIBCO Adapter SDK 5.4.1 now supports TRA 5.6.0, TRA 5.6.1 and TRA 5.6.2, in addition to the currently supported TRA versions listed in the product documentation.  The only TRA features supported by the adapter are those included in the documentation for TIBCO Adapter SDK.

Limitation and Restrictions:
===================
Please refer to the TRA 5.6.0, TRA 5.6.1 and TRA 5.6.2 documentation for supported versions of TIBCO Administrator (see LBN1-9DNP7O).

TIBCO Adapter SDK 5.4.1 only supports JRE 1.5.0 with TRA 5.6.0, TRA 5.6.1 and TRA 5.6.2.

64-bit TRA is required on HP Itanium platform, because Adapters based on SDK 5.4.1 is a 64-bit application on HP Itanium. On all supported platforms, except HP Itanium, TIBCO Adapter SDK 5.4.1 is supported with either 32-bit or 64-bit TRA packages.

In order to run an adapter built with TIBCO Adapter SDK 5.4.1 using the 64-bit TRA package (which uses the 64-bit JVM), a workaround must be implemented. The workaround is described below, under Known Issues.

Configuration
============
No adapter configuration changes are required to use TRA 5.6.0, TRA 5.6.1 and TRA 5.6.2.

Known Issues
=============

Issue 1: Custom adapters and examples which have been developed using the C++ API provided by TIBCO Adapter SDK 5.4.1 (maverick53) fail to start with JMS transport.

Symptoms:
=========
After installing TRA 5.6.0, TRA 5.6.1 or TRA 5.6.2, TIBCO Adapter projects using Enterprise Message Service as transport will not start up from TIBCO Designer and gives the following error:

Message "Code = AESDKC-0156, Category = JmsComm, Severity = errorRole, Description = could not open JMS shared library jms." displays.

Impact:
======
Loss of Functionality. Adapter does not start.

Cause:
======
The JMS libraries shipped with TRA is not compatible with the ones shipped with SDK.

Workaround:
==========
Please note that the workaround varies, based on the platform used:

On Windows:
Remove the libeay32.dll and ssleay32.dll from &ltTIBCO_HOME>/adapters/sdk/version/&ltlib>
On UNIX:
Remove the libssl and libcrypto openssl libraries from the TIBCO_HOME/adapters/sdk/version/lib directory

------------------------------------------------------------------------------

Issue 2: Custom adapters and examples which have been developed using the Java API of TIBCO Adapter SDK 5.4.1 fail to start with 64-bit TRA 5.6.0, TRA 5.6.1 and TRA 5.6.2.

Symptoms:
===========
After installing 64-bit TRA 5.6.0, TRA 5.6.1 or TRA 5.6.2, TIBCO Adapter SDK 5.4.1 will not start up and gives the following error:

“Failed to load shared library, library name: /tibco/jre/1.5.0/bin/classic/libjvm”

Impact:
======
Loss of Functionality. Adapter does not start.

Cause:
======
The adapter includes 32-bit libraries that cannot run with the 64-bit JVM that with the 64-bit packages of TRA

Workaround:
===========
Follow these steps
1. Remove the adapter executable from directory where the custom &ltadapter_executable> had been created.
2. Copy &ltTIBCO_HOME>/tra/5.6/bin/wrap64 to TIBCO_HOME/adapter/&ltadapter_name>/&ltversion>/bin, and rename wrap64 to &ltadapter_executable>
3. Open the &ltTIBCO_HOME>/adapter/&ltadapter_name>/versison/bin/&ltproperties_file> file and modify the tibco.env.CUSTOM_LIB_PATH variable to &ltRV_HOME>/lib/64

TIBCO Adapter (TM) SDK 5.4.1 supports TRA 5.6.0, TRA 5.6.1 and TRA 5.6.2