TIBCO Rendezvous® Release Notes

Software Release 8.4.6 October 2018

Two-Second Advantage® 2

Important Information

SOME TIBCO EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADD-ON FUNCTIONALITY) OF THE LICENSED TIBCO SOFTWARE. THE EMBEDDED OR BUNDLED SOFTWARE IS NOT LICENSED TO BE USED OR ACCESSED BY ANY OTHER TIBCO SOFTWARE OR FOR ANY OTHER PURPOSE. USE OF TIBCO SOFTWARE AND THIS DOCUMENT IS SUBJECT TO THE TERMS AND CONDITIONS OF A LICENSE AGREEMENT FOUND IN EITHER A SEPARATELY EXECUTED SOFTWARE LICENSE AGREEMENT, OR, IF THERE IS NO SUCH SEPARATE AGREEMENT, THE CLICKWRAP END USER LICENSE AGREEMENT WHICH IS DISPLAYED DURING DOWNLOAD OR INSTALLATION OF THE SOFTWARE (AND WHICH IS DUPLICATED IN THE LICENSE FILE) OR IF THERE IS NO SUCH SOFTWARE LICENSE AGREEMENT OR CLICKWRAP END USER LICENSE AGREEMENT, THE LICENSE(S) LOCATED IN THE “LICENSE” FILE(S) OF THE SOFTWARE. USE OF THIS DOCUMENT IS SUBJECT TO THOSE TERMS AND CONDITIONS, AND YOUR USE HEREOF SHALL CONSTITUTE ACCEPTANCE OF AND AN AGREEMENT TO BE BOUND BY THE SAME. ANY SOFTWARE ITEM IDENTIFIED AS THIRD PARTY LIBRARY IS AVAILABLE UNDER SEPARATE SOFTWARE LICENSE TERMS AND IS NOT PART OF A TIBCO PRODUCT. AS SUCH, THESE SOFTWARE ITEMS ARE NOT COVERED BY THE TERMS OF YOUR AGREEMENT WITH TIBCO, INCLUDING ANY TERMS CONCERNING SUPPORT, MAINTENANCE, WARRANTIES, AND INDEMNITIES. DOWNLOAD AND USE OF THESE ITEMS IS SOLELY AT YOUR OWN DISCRETION AND SUBJECT TO THE LICENSE TERMS APPLICABLE TO THEM. BY PROCEEDING TO DOWNLOAD, INSTALL OR USE ANY OF THESE ITEMS, YOU ACKNOWLEDGE THE FOREGOING DISTINCTIONS BETWEEN THESE ITEMS AND TIBCO PRODUCTS. This document contains confidential information that is subject to U.S. and international copyright laws and treaties. No part of this document may be reproduced in any form without the written authorization of TIBCO Software Inc. TIBCO, Two-Second Advantage, Rendezvous, and FTL are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. Enterprise Java Beans (EJB), Java Platform Enterprise Edition (Java EE), Java 2 Platform Enterprise Edition (J2EE), and all Java-based trademarks and logos are trademarks or registered trademarks of Oracle Corporation in the U.S. and other countries. All other product and company names and marks mentioned in this document are the property of their respective owners and are mentioned for identification purposes only. THIS SOFTWARE MAY BE AVAILABLE ON MULTIPLE OPERATING SYSTEMS. HOWEVER, NOT ALL OPERATING SYSTEM PLATFORMS FOR A SPECIFIC SOFTWARE VERSION ARE RELEASED AT THE SAME TIME. SEE THE README FILE FOR THE AVAILABILITY OF THIS SOFTWARE VERSION ON A SPECIFIC OPERATING SYSTEM PLATFORM. THIS DOCUMENT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, OR NON-INFRINGEMENT. THIS DOCUMENT COULD INCLUDE TECHNICAL INACCURACIES OR TYPOGRAPHICAL ERRORS. CHANGES ARE PERIODICALLY ADDED TO THE INFORMATION HEREIN; THESE CHANGES WILL BE INCORPORATED IN NEW EDITIONS OF THIS DOCUMENT. TIBCO SOFTWARE INC. MAY MAKE IMPROVEMENTS AND/OR CHANGES IN THE PRODUCT(S) AND/OR THE PROGRAM(S) DESCRIBED IN THIS DOCUMENT AT ANY TIME. THE CONTENTS OF THIS DOCUMENT MAY BE MODIFIED AND/OR QUALIFIED, DIRECTLY OR INDIRECTLY, BY OTHER DOCUMENTATION WHICH ACCOMPANIES THIS SOFTWARE, INCLUDING BUT NOT LIMITED TO ANY RELEASE NOTES AND "READ ME" FILES. Copyright © 1997 - 2018 TIBCO Software Inc. ALL RIGHTS RESERVED.

TIBCO Rendezvous® Release Notes 3

TIBCO Software Inc. Confidential Information

TIBCO Rendezvous® Release Notes 4

Contents

TIBCO Documentation and Support Services ...... 5 New Features ...... 7 Changes in Functionality ...... 8 Deprecated and Removed Features ...... 9 Migration and Compatibility ...... 12 Known Issues ...... 13 Closed Issues ...... 17 Special Note for IBM i ...... 18

TIBCO Rendezvous® Release Notes 5

TIBCO Documentation and Support Services

How to Access TIBCO Documentation

Documentation for TIBCO products is available on the TIBCO Product Documentation website, mainly in HTML and PDF formats. The TIBCO Product Documentation website is updated frequently and is more current than any other documentation included with the product. To access the latest documentation, visit https:// docs.tibco.com.

Product-Specific Documentation

Documentation for TIBCO products is not bundled with the software. Instead, it is available on the TIBCO Documentation site. To directly access documentation for this product, double-click the following file:

TIBCO_HOME/release_notes/TIB_rv_8.4.6_docinfo.html TIBCO_HOME is the top-level directory in which TIBCO products are installed.

● On Windows platforms, the default TIBCO_HOME is :\tibco.

● On UNIX platforms, the default TIBCO_HOME is /opt/tibco. The following documents for this product can be found on the TIBCO Documentation site:

● TIBCO Rendezvous Concepts

● TIBCO Rendezvous Administration

● TIBCO Rendezvous Installation

● TIBCO Rendezvous C Reference

● TIBCO Rendezvous COBOL Reference

● TIBCO Rendezvous COM Reference

● TIBCO Rendezvous C++ Reference

● TIBCO Rendezvous .NET Reference

● TIBCO Rendezvous Java Reference

● TIBCO Rendezvous C configuration Tools

● TIBCO Rendezvous z/OS Installation and Configuration

How to Contact TIBCO Support

You can contact TIBCO Support in the following ways:

● For an overview of TIBCO Support, visit http://www.tibco.com/services/support.

● For accessing the Support Knowledge Base and getting personalized content about products you are interested in, visit the TIBCO Support portal at https://support.tibco.com.

● For creating a Support case, you must have a valid maintenance or support contract with TIBCO. You also need a user name and password to log in to https://support.tibco.com. If you do not have a user name, you can request one by clicking Register on the website.

How to Join TIBCO Community

TIBCO Community is the official channel for TIBCO customers, partners, and employee subject matter experts to share and access their collective experience. TIBCO Community offers access to Q&A forums,

TIBCO Rendezvous® Release Notes 6 product wikis, and best practices. It also offers access to extensions, adapters, solution accelerators, and tools that extend and enable customers to gain full value from TIBCO products. In addition, users can submit and vote on feature requests from within the TIBCO Ideas Portal. For a free registration, go to https://community.tibco.com.

TIBCO Rendezvous® Release Notes 7

New Features

The following new features have been added in Release 8.4.6 of TIBCO Rendezvous software. Adapter: TIBCO Rendezvous and TIBCO FTL® An adapter daemon combines the functionality of a Rendezvous daemon and an adapter. Using the adapter, TIBCO Rendezvous applications can communicate with TIBCO FTL applications. You must explicitly configure this functionality. This feature is available only on Linux platforms on x86 64-bit hardware.

TIBCO Rendezvous® Release Notes 8

Changes in Functionality

There are no changes in functionality in Release 8.4.6 of TIBCO Rendezvous software

TIBCO Rendezvous® Release Notes 9

Deprecated and Removed Features

The following tables list any features that have been deprecated or removed as of Release 8.4.6 of TIBCO Rendezvous software.

Deprecated Features

Affected Deprecated Removed Component Description Release Release

32-bit Daemons 32-bit executable files for Rendezvous 8.4.5 daemons are deprecated on all platforms. They will be removed in a future release. Use 64-bit daemons instead.

32-bit Java For 32-bit Java clients on Windows 8.4.5 Secure Clients platforms, the secure client library on Windows archives, tibrvnativesd.jar and tibrvjsd.jar, are deprecated. (64-bit clients are not affected.)

32-bit Support All 32-bit components (libraries and 8.4.5 on Mac OS X executable programs) are deprecated on Mac OS X platforms. 32-bit SSL libraries are already removed. See the following table.

Perl The language interface is 8.4.5 deprecated. It will be removed in a future release.

PGM The PGM variant is deprecated. It will 8.4.4 be removed in a future release.

TIBCO Rendezvous® Release Notes 10

Removed Features

Affected Deprecated Removed Component Description Release Release

32-bit SSL 64-bit SSL libraries replace their 32-bit 8.4.5 Libraries on counterparts on Mac OS X platforms. Mac OS X As a result, the following components run only as 64-bit: rvrd, rvsd, rvsrd, and secure client libraries. If you must run these components as 32-bit, you can do so by replacing the 64-bit SSL libraries with your own 32- bit libraries. However, this action precludes running 64-bit versions on the same host computer. All 32-bit components are deprecated. See the preceding table.

Browsers The HTTPS web interface no longer 8.4.3 supports SSLv3 connections. The new minimum for secure connections is TLSv1 or greater. Browsers that support only SSLv3 or earlier are now obsolete, that is, the daemon does not support them: for example, Internet Explorer 6.

COM The COM API library (on Windows 8.2.0 8.4.3 platforms) is obsolete.

VC8 and VC9 Windows API libraries no longer 8.4.0 8.4.3 support VC8 and VC9 runtime environments. Migrate to VC10.

Java Web API The Java Web API archive file, 8.4.2 8.4.3 tibrvweb.jar, is obsolete.

rva rva and rva transports are also obsolete 8.4.2 8.4.3 (as they require the Java Web API archive file).

Removed Platforms

Affected Deprecated Removed Platform Description Release Release

Red Hat TIBCO no longer supports this 8.4.5 Enterprise platform. Linux 5 Migrate to Red Hat 6 or 7.

TIBCO Rendezvous® Release Notes 11

Affected Deprecated Removed Platform Description Release Release

Red Hat TIBCO no longer supports this 8.4.3 Enterprise platform. Linux 4 Migrate to Red Hat 6 or 7.

AIX 5.3 TIBCO no longer supports this 8.4.0 8.4.3 platform. Migrate to AIX 6.1 or later.

HPUX on HP- TIBCO no longer supports this platform 8.4.2 8.4.3 PA RISC hardware

Mac OS X 10.8 TIBCO no longer supports this 8.4.3 and earlier platform. Migrate to the latest release of OS X.

Solaris 8 and 9 TIBCO no longer supports this 8.4.2 8.4.3 on SPARC platform. hardware Migrate to Solaris 10 on SPARC hardware.

Windows XP TIBCO no longer supports this 8.4.2 8.4.3 platform. Migrate to Windows 7 or 8.

Windows TIBCO no longer supports this 8.4.3 Server 2003 platform. Migrate to Windows Server 2008 or 2012.

Windows Vista TIBCO no longer supports this 8.4.3 Business platform. Edition Migrate to Windows 7 or 8.

TIBCO Rendezvous® Release Notes 12

Migration and Compatibility

The following notes apply when migrating from a previous release to Release 8.4.6 of TIBCO Rendezvous software.

Update .NET Framework

The TIBCO Rendezvous installer no longer includes the .NET framework. If your clients use the Rendezvous .NET client API, follow Microsoft's instructions to keep the .NET framework current.

Rebuild .NET Applications

.NET applications built with VC8, or built against earlier releases of TIBCO Rendezvous software cannot operate with the .NET framework of release 8.4.3 or later. To migrate .NET applications, rebuild them using VC10 and the latest TIBCO Rendezvous release.

TIBCO Rendezvous® Release Notes 13

Known Issues

The table lists known issues in Release 8.4.6 of TIBCO Rendezvous software.

Known Issues as of Release 8.4.x

Key Summary

RV-3540 Summary: VMware Tools Windows on VMware products only. VMware Tools prevents the installer from registering the TIBCO Rendezvous .NET assembly in the Windows GAC. Workaround: Uninstall VMware Tools. Install TIBCO Rendezvous. Reinstall VMware Tools.

RV-3521 Summary: OpenSSL FIPS Object Module is Incompatible with Windows 32-bit JVM TIBCO Rendevous installations include the OpenSSL FIPS Object Module as a validated implementation of OpenSSL. However, this module is incompatible with Windows 32-bit Java virtual machine (JVM). Workaround: The primary workaround is to run secure Java clients on Windows platforms only using a 64-bit JVM. A secondary and temporary workaround is to supply your own implementation of 32-bit OpenSSL that is compatible with Windows 32-bit JVM. Note that this release of TIBCO Rendezvous deprecates the 32-bit Java secure client libraries on Windows platforms. Subsequent releases will not support this secondary workaround.

RV-3431 Summary: PGM on Mac OS X On Mac OS X platforms, the PGM variant cannot load SSL libraries. Workaround: Contact TIBCO Support.

RV-3275 Summary: Building Samples On Mac OS X, the supplied makefiles for Perl, C and C++ samples do not work. Workaround: Edit the makefiles.

RV-3274 Summary: Uninstallation On some platforms uninstalling the product does not remove the SSL libraries installed under TIBCO_HOME. Workaround: You may remove these files manually.

RV-3163 Summary: Uninstallation When several releases of TIBCO Rendezvous software are installed in the same TIBCO_HOME directory, uninstalling one of them could delete files from the other installed versions. Affects Release 8.0 and later. Workaround Uninstall the damaged release, and reinstall it.

TIBCO Rendezvous® Release Notes 14

Known Issues as of Release 8.3.x

Key Summary

RV-2730 Summary: Linux Delivers Multicast Data to All UDP Ports (previously Consider two receivers, R1 and R2, which run on the same Linux host computer. R1 RV-2884) binds UDP service U1, and joins multicast listen group M1. Similarly, R2 binds UDP service U2, and joins multicast listen group M2. A sending program, S, runs on any other host computer across a network. S sends messages over UDP service U1 to multicast send address M2. Receiver R2 receives these messages, even though one would expect its service (U2) to preclude this behavior. The behavior is specific to Linux, and not specific to Rendezvous software. Simple multicast socket programs produce the same behavior on Linux. For more information, see https://bugzilla.redhat.com/show_bug.cgi?id=231899. Workaround: RV-3102 fixes this issue for Linux kernels 2.6.31 and higher (for example, RHEL6). For earlier Linux kernels, use this workaround: Use distinct multicast addresses to separate message streams (do not rely on UDP services to separate message streams). Do not reuse a same multicast group address on different UDP services.

RV-2131 Summary: rvtrace Support

rvtrace requires a library that does not support the Windows 64-bit platform.

Workaround: To use rvtrace, install the Windows 32-bit package (which operates correctly on 64-bit platforms).

1-9XXRW9 Summary: Message Access after Java Dispose

After calling TibrvMsg.dispose to release a message, the Java methods TibrvMsg.getSendSubject() and TibrvMsg.getReplySubject() retrieve null rather than throwing an exception. Workaround: None.

1-AADQH3 Summary: AIX rvd Does Not Receive Broadcast Data This symptom results from an operating system defect in AIX. Disabling the socket option IP_MULTICAST_LOOP disables receipt of broadcast data. Workaround: Use multicast instead of broadcast.

1-AWENF7 Summary: AIX Setting LIBPATH is Incompatible with JVM

Workaround: Set the environment variable LD_LIBRARY_PATH instead. Do not set LIBPATH at all - not even to a null value.

TIBCO Rendezvous® Release Notes 15

Known Issues as of Release 8.2 and Earlier

Key Summary

1-A3OWRP Summary: Secure Java Clients on HP-UX Itanium On HP-UX IA64 platforms, Java secure clients can abruptly exit when attempting to connect to a secure daemon. Workaround: None.

1-8KAG2Z Summary: 64-bit Secure Java Clients on HP-UX Itanium 1-8KW0FV Release 8.0 does not support 64-bit secure JNI clients on HP-UX Itanium platforms. (A secure Java client is a Rendezvous program that loads either of these two libraries tibrvnativesd.jar or libtibrvjsd.jar.) This issue does not affect other platforms, except as listed in this section. Workaround: Run secure clients on HP-UX using the 32-bit JVM.

Summary: 64-bit Secure Java Clients on AIX Releases 8.0 and 7.5 do not support 64-bit secure JNI clients on AIX platforms. (A secure Java client is a Rendezvous program that loads either of these two libraries tibrvnativesd.jar or libtibrvjsd.jar.) This issue does not affect other platforms, except as listed in this section. Workaround: Run secure clients on AIX using the 32-bit JVM.

1-8LNZHQ Summary: Host Status Messages From Managed RVDs For managed RVDs, host status messages do not show the service or network fields except for the control channel service. Workaround: None.

1-8LNZH7 Summary: RV Advisory Messages From Managed RVDs Using wildcard subject “>” does not capture RV advisory messages from managed RVDs. Workaround: Explicitly request the RV advisory messages with “_RV.>” or a subset of the subject name.

1-8KWJMP Summary: Compatibility with TIBCO BusinessWorks, TIBCO Designer, TIBCO Hawk 4.7 and TIBCO TRA 5.5.x When TIBCO Rendezvous 8.x, TIBCO Hawk® 4.7 (or older), TIBCO Designer™ and TIBCO BusinessWorks ™ coexist on the same host computer, an OpenSSL version mismatch prevents correct operation of TIBCO Rendezvous activities within TIBCO BusinessWorks processes running in the TIBCO Designer debugger. TIBCO Rendezvous 8.x transports require a newer version of OpenSSL, while TIBCO Hawk 4.7 supplies an older version. Installing TIBCO BusinessWorks modifies a directory path in designer.tra, causing TIBCO Rendezvous transports to use the wrong version of OpenSSL.

Workaround: In the file designer.tra, modify the value of tibco.env.CUSTOM_PATH. Add the directory rv_8x_home/bin to the value of this path variable, ensuring that it precedes the directory TIBCO_HOME/hawk/bin.

TIBCO Rendezvous® Release Notes 16

Key Summary

Summary: Multicast Issue in Linux Kernel on x86-64 Hardware This issue affects Linux kernels earlier than 2.4.26, running on x86-64 hardware. These kernels exhibit a defect calculating checksums, which prevents the TIBCO Rendezvous daemon from properly joining multicast groups. (Network broadcast is not affected.) Workaround: Request the appropriate defect correction from your Linux vendor.

TIBCO Rendezvous® Release Notes 17

Closed Issues

The table lists closed issues in Release 8.4.6 of TIBCO Rendezvous software.

Key Summary

RV-3591 Upgraded to Jetty 9.

RV-3566 Fixed a memory leak in the daemon's HTTP interface.

RV-3558 Fixed a defect in which routing daemons could abruptly exit upon encountering corrupted message data over a compressed neighbor link.

RV-3555 Daemons now generate self-signed certificates using SHA256.

RV-3547 Fixed a defect that could affect a distributed queue worker that received tasks through a wildcard subscription. The first symptom was memory growth, proportional to the number of tasks. The second symptom was that advisories erroneously indicated that tasks that the worker had completed and confirmed were instead rejected.

RV-3544 Fixed a defect in which daemons could override the operating system's default TCP send and receive window sizes.

RVI-34 Fixed a defect on IBM i platforms affecting routing daemon processes that started with a -listen parameter consisting of a port number without an explicit protocol prefix. This defect also affected the API transport create call. If the call supplied a daemon argument consisting of a port number without an explicit protocol prefix, the call would fail to connect to the daemon.

RVI-33 Fixed a Java defect in which tibrvj.jar calls to ILE native methods were incompatible with "IBM Technology for Java" JREs. Java native methods are now compiled for use only with "IBM Technology for Java" JREs. (Oracle JREs are no longer supported on IBM i platforms.)

RVZ-42 Enhanced information in error messages.

RVZ-41 Daemons on z/OS platforms now support the command line parameter -reuse- port. RVZ-29

TIBCO Rendezvous® Release Notes 18

Special Note for IBM i

TIBCO Rendezvous software does not support the following features on IBM i (formerly i5 and AS/400) platforms:

● PGM variants

● Secure daemons (rvsd and rvsrd)

● Secure daemon API calls

● RVDM

TIBCO Rendezvous® Release Notes