FioranoMQ® 2008 SP2 Release Notes

Product Name: FioranoMQ

Version: 2008 SP2 Build #: 4565

Release Date: September 6, 2008

Fiorano Software is releasing version 2008 SP2 of FioranoMQ. This release notes provides information about the enhancements and the resolved issues in this release.

Note: Visit the Fiorano Support Portal http://support.fiorano.com for details about any subsequent patches for this release. We recommend you to check for Patches prior to the installation.

What's New

Resolved Issues

Known Issues and Limitations

What’s New

This section describes the new features introduced in the FioranoMQ 2008 SP2 release.

1. Property file based profile configuration

The server profiles can be now edited through a property file Configs.cfg present in the %PROFILE%/conf directory. This file contains the default list of name-value pairs for setting the configuration of the server. For more information on using Configs.cfg file, please refer to Getting Started

2. Performance improvement for Durable Subscriber

Durable Subscriber performance has been substantially improved as compared to the earlier releases of FioranoMQ. New Algorithms for minimizing consumer starvation has been introduced in this release.

3. Enhanced FioranoMQ web console

New tabs has been added to configure and monitor

Bridge

Repeater

4. Many bug fixes, including the bugs reported through Fiorano Support Portal

For more details, see Resolved Issues section.

This section describes the new features introduced in the FioranoMQ 2008 SP1 release.

1. Enhanced FioranoMQ Web Console

● Server connection status and the version is displayed on the top right-hand side corner.

● Connections, Queues, and Topics pages show snapshot at the page top.

● Graphs render more intervals to display more data history.

● Added license information tab.

● ConnectionInfo displays the number of producers and consumers per connection.

2. SSL support in the Bridge and the Repeater modules

The FioranoMQ Bridge or Repeater can now connect to FioranoMQ server through SUN_SSL and PHAOS_SSL protocols.

3. Revamped error handling in the C++ RTL

Reorganized the error handling mechanism in C and C++ runtimes and fixed all the unhandled exceptions reported by various customers.

4. Enhanced flow control algorithm

The flow control algorithm is optimized to not drop messages for slow subscribers. Also introduced more parameters to configure the algorithm for variety of flow control requirements.

5. Many bug fixes, including the bugs reported through the Fiorano Support Portal.

For more details, see Resolved Issues section.

TOP

Resolved Issues

This section describes issues resolved in 2008 SP2 release.

2795	HA rpl doesn’t clean Durable Subscriber properly in case of cable pull out
2464	Dispatcher is not listing active backupurl server as active server in case of HA.
2835	Misleading configurations of DMQ need to be removed from FioranoMQHandBook
NA	Receiver crash on revalidating
2711	Increasing Heap space in fmq.conf

This section describes issues resolved in 2008 SP1 release.

1	[SI#1718] CFs not configurable in Repeater
2	[SI# 2517] SSL support for Bridges/Repeaters
3	[SI#2563 ] runtime files being created in wrong place when MQ runs as windows service
4	[SI#2516] Receive with timeout & ReceiveNoWait should return null unless the connection reconnection is over and there are no messages on the server
5	[SI:2619] Application crashes when Server goes down while sending messages from CSP [PTP]
6	[Schlum Presales issue] new TC_close API for blocking reconnect after close – C++ runtime
7	[SI: Datec] undocumented APIs for MQ7.5 C RTL
8	[presales George Weiss] C runtime: Client hangs on setClientID when restarted after revalidation
9	[In memory Launch] JMS header property Reply To not working when it is referring to topic
10	JMXClient notifications inconsistent
11	Unable to send messages between FioranoMQ and Sonic clients though the two servers are connected through bridge
12	Connections table in Web console shows only one connection if two or more connections are created with same clientID
13	FioranoMQ WMT: Enhancements in ConnectionFactory
14	Handling of flag EnableMessageID must be similar in PTP & PubSub domain
15	Messages are not completely received in case of ApplicationServer (PubSub)
16	FioranoMQ WMT: Import and export view need to be created for ConnectionFactory
17	Lot of warnings fill up the server logs with default log settings while sending PTP messages
18	FioranoMQ WMT: Handle creation/deletion/editing of XA Enabled Connection Factories
19	Show all the JMS admin objects in a selection connection
20	clearDB.sh is not running when run from other directories
21	Import & Export JMS objects changes the properties to set to default
22	Lookup Failed case: Exception stack trace can be improved
23	UI changes required for tabular view in WMT
24	FioranoMQ WMT: Connection view needs to contain more relevant parameters.
25	WMT requirement: API to list destinations used in a Queue/Topic connection is needed
26	NPE while sending encrypted bytes message
27	Events need to fired when XAEnabled Topic and Common Connection Factories are created/deleted
28	New method listAllSessions is required in JMSConnectionIdEvent and JMSTopicConnectionEvent.
29	Publisher is sending messages even though the topic is deleted
30	NullpointerException is thrown if server is closed while sending messages in LPC
31	PubSub HT tests failed in deleting hierarchical topic
32	Repeated disconnects happens in the client when the server is running
33	[Connection Consumer] Messages lost while using PubSub Application server sample
34	clearDB script not working when DBDir argument is passed
35	C/C++ runtimes: BytesMessage and StreamMessages give NULL values when sent from CSP after revalidation
36	C/C++ runtimes: Unhandled Exception occurs while reading from corrupted CSP
37	Application crashes when Connection object is deleted while revalidating - C++ runtime
38	JMSMessageID is not set on received message
39	C/C++ runtimes: unhandled Exception in revalidateTCF when connection Objects are deleted by separate Thread
40	Session objects/references should be properly handled to prevent unhandled exceptions – C++ runtimes
41	Expose subscriber Session Buffer threshold values and give an option to configure it through client

Known Issues and Limitations

This section describes known issues and work around for the 2008 SP2 release.

The third party libwww libraries that are used for http support in C/C++ are not compatible in Solaris (x86) as they are compiled on Linux. Since the third party libraries are not compatible, http samples will not run on Solaris (x86).

Work around:

In order to run http samples compile open source libwww on Solaris and replace the built libraries (libhttp.so, libmd5.so, and so on) in fmq\clients\c\native\lib folder.

By default, the MessageID will not be populated in the Message with the Default MQ profile. This is generally not an issue and FMQ has been configured this way by default for performance reasons. However, it is easy to change the configuration.

Work Around 1:

Navigate to %PROFILE_NAME%->Fiorano->etc->FMQConfigLoader in Studio, and set the value of “IncludeMessageID” property as TRUE.

Work Around 2:

Add this following line in your client code before sending the message.

producer.setDisableMessageID(false);

Producer is equivalent to the MessageProducer in the client code. Putting this line will enable MessageID for this particular client.

For Non-Persistent Messages, the InvalidDestinationException will not be thrown while sending the Message for a non-existing destination, but rather FioranoException(extension of JMSException) will be raised at the ExceptionListener. This is generally not an issue and FMQ has been configured this way by default for performance reasons. However, it is easy to change the configuration.

Work Around 1:

For NP messages, batching is by default enabled which leads to the above explained behavior. To get the InvalidDestinationException at the send API, set the BatchingEnabled parameter in the ConnectionFactory as FALSE.

Work Around 2:

Add this following line in your client code environment while performing the lookup,

env.put("BatchingEnabled", "false")

Where env is the environment passed while performing a JNDI lookup. This will disable batching for this particular client.

TOP

System Requirements

This section summarizes the minimum system requirements for FioranoMQ 2008. The actual product documentation includes the same in detail:

Platform	Requirements	Comments
Windows	Microsoft® NT Server 2003, XP Professional Java 1.5 or above Min Physical RAM : 256 MB Min Disk Space : 500 MB	Fiorano Studio requires Java 1.5 or above
Linux	Microsoft® NT Server 2003, XP Professional Java 1.5 or above Min Physical RAM : 256 MB Min Disk Space : 500 MB	Fiorano Studio requires Java 1.5 or above
HP-UX	Red Hat, Suse, Debian Java 1.5 or above Min Physical RAM : 256 MB Min Disk Space : 500 MB	Fiorano Studio requires Java 1.5 or above
IBM AIX	5x Java 1.5 and above Min Physical RAM : 256 MB Min Disk Space : 500 MB	Fiorano Studio requires Java 1.5 or above
Solaris	9x Java 1.5 and above Min Physical RAM : 256 MB Min Disk Space : 500 MB	Fiorano Studio requires Java 1.5 or above

TOP

Product Documents

The entire FioranoMQ documents are available online. The FioranoMQ documentation includes:

Document Name	Description
FioranoMQ Concepts Guide	Contains description on concepts and features of FioranoMQ.
FioranoMQ Handbook	Contains detailed description on how to use FioranoMQ and its features.
FioranoMQ Best Practices Guide	Contains the information about the performance tuning and deployment parameters.
FioranoMQ High Availability Guide	Contains the salient features of FioranoMQ's HA solution. It explains the working and the underlying architecture of the entire solution. It also provides step by step instructions on enabling HA in FioranoMQ.
FioranoMQ Getting Started	Contains the information on startup to assist users of FioranoMQ. This document introduces users to the components of FioranoMQ and briefly explains the working of these components.
FioranoMQ JMX API Guide	FioranoMQ exposes a lot of JMX API’s which the user can invoke at runtime to change the configuration and behaviour of the MQ server in online mode. This document lists the set of MBeans exposed through JMX, and the attributes and operations within the MBean which the user may want to invoke.
FioranoMQ C-RTL Guide	This guide provides an introduction to FioranoMQ C RunTime library. It also provides a summary of the various functions based on their usage and a detailed description of the APIs included in this library. Additionally, the guide also details out the steps involved in compiling and running CRTL sample applications.
FioranoMQ Cpp(Native) RTL Sample Application Guide	This guide describes usage of C++ Runtime for connecting to FioranoMQ server. The various sample programs illustrates the use of simple Publish-Subscribe and Point-To-Point operations
FioranoMQ C++ RTL(Native )Guide	This guide contains an overview of the C++RTL specific Data types and Constants, Error handling, Dot Net, API References, Sample Programs, and FAQ’s.
FioranoMQ C++ RTL(JNI) Guide	This guide explains the FioranoMQ server implementation of C++ runtime library, allowing C++ programs to use the JMS messaging facilities through a thin set of wrapper classes. By using the C++ API for JMS, C++ and Java programs can exchange data seamlessly.
FioranoMQ C RTL(Cross compiled) Guide	This Guide contains an introduction to FioranoMQ JNI/Cross-compiled CRuntime library, detailed description on how to use the APIs, and details on compiling and running C RTL sample applications.
FioranoMQ C JNI RTL Sample Application Guide	This guide contains the sample programs illustrating the use of CRTL for PubSub and PTP, and XA operations.
FioranoMQ Native Csharp RTL Sample Application Guide	This guide contains the sample programs illustrating the use of Native CSharp-RTL for PubSub and PTP operations.
FioranoMQ CSharp RTL Sample Application Guide	This guise describes usage of CSharp Runtime for connecting to FioranoMQ server. The various sample programs illustrates the use of simple Publish-Subscribe and Point-To-Point operations. The samples are available in %FMQ_DIR%\clients\csharp\samples directory.
FioranoMQ CSharp RTL Guide	This guide is designed to assist developers working on the .Net technology to understand and use FioranoMQ C#RTL library. The developer must have a fair knowledge of the C# programming language.
FioranoMQ Cpp JNI RTL Sample Application Guide	This guide contains the sample programs illustrating the use of C++ RTL for PubSub and PTP operations.
FioranoMQ C Native RTL Sample Application Guide	This guide contains the sample programs illustrating the use of C-RTL for PubSub and PTP operations.
FioranoMQ API Documentation	This guide describes of all the classes used in C# RTL.
FioranoMQ FAQ’s	This Online Help contains compilations of information about FioranoMQ, which are usually the result of certain questions constantly being asked. If you do not see your question here, feel free to post it to techsupport@fiorano.com