Product Name: FioranoMQ
Version: 9.0.1
Date: March 05, 2009
Fiorano Software is releasing version 9.0.1 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.
This section describes the new features introduced in the FioranoMQ 9.0.1 release.
1. DataBase upgradation
utility
A script based utility has been added to automate upgrade of older versions
of FioranoMQ databases to FioranoMQ 9. This enables user to use their
old databases with latest FioranoMQ version, thus ensuring that
any data available in the old database is compatible with the latest FioranoMQ
version. The script while accepting minimal inputs provides all relevant
migration changes seamlessly. More detailed instructions on running this
script and the various input parameters required are explained in the
README file at
{FIORANO_HOME}/fmq/bin/Linux_DBMigration/Readme.txt or
{FIORANO_HOME}\fmq\bin\Windows_DBMigration\Readme.txt in the latest version.
This section describes known issues and work around for the 9.0.1 release.
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.
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.
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.
This section describes the new features introduced in the FioranoMQ 9.0.0 release.
1. Enhanced Property file based HA profile configuration
All the important parameters like backup HA IP address, port, gateway IP address etc, which are used in HA configuration files are grouped at the start of the HA configuration files. This enables users to edit the configuration files easily to set up replication HA and shared HA profiles.
2. Client Side logging support in C/C++ runtimes
Support has been added for Client Side logging to record information relating to the flow of client applications, error statements and information relating to the memory being freed up as applications execute and close. This helps in getting more debug information in case of production issues. For more information on how to set different log levels, to enable or disable logging, and to set log names please refer to FioranoMQ CRTL Guide and FioranoMQ C++ RTL Native Guide for C and C++ runtimes respectively.
3. Enhanced Client Side Persistence (CSP) in C/C++ runtimes
New APIs have been added in order to browse the CSP messages, such as getting the number of messages in CSP Queue or Topic, retrieving queues, topics on a connection etc. Please refer to the FioranoMQ CRTL Guide and FioranoMQ C++ RTL Native Guide for C and C++ runtimes respectively for a detailed description of each API.
4. Enhanced FioranoMQ web console
The following new tabs have been added for configuration or monitoring:
A dispatcher tab which enables operations such as adding and removing servers to the Dispatcher-enabled MQ Server.
A Sockets view tab to monitor all the open Sockets on the FMQ Server.
A System properties tab which lists all the java system properties that are set in the JVM in which the FMQ Server is running.
An Enhanced Connections tab which lists all the JMX connections made to the FMQ Server.
5. Bug fixes (including bugs reported through the Fiorano Support Portal).
For more details, see Resolved Issues section.
This section describes issues resolved in 9.0.0 release.
|
1 |
Crash in C runtime with multiple disconnects with server while using CSP |
| 2 | In HA after multiple failovers messages are not received consistently |
| 3 | In case of persistent messages, the messages does not get persisted into the message store when the message index in the message store reaches to the maximum integer value that is Integer.MAX_INT. |
| 4 | In the web management tool, the image files created for generating the graphs does not get deleted. |
| 5 | Delay in message delivery in case of onMessage exception |
| 6 | ListTopics is not displaying all topics information properly |
| 7 | Invoking MBean operations such as showLinkTopicConfiguration and showReplyTopicConfiguration in Repeater leads to improper results. |
| 8 | The subscriber throws socket timeout exception when the server takes long time to come back due to power failure. |
| 9 | The log files does not get created in the path specified by the dbPath argument. |
| 10 | Exception while adding file appender to Logger through JMX |
| 11 | In Solaris machine StandAloneRepeater Profile gets corrupted after saving its configuration. |
| 12 | Show Alerts in WMT related to memory status |
| 13 | New Hierarchal Topics samples in C/C++ clients |
| 14 | Web Management tool should show the server’s starting time |
| 15 | Exception on restarting the dispatcher after adding servers to cluster and saving configuration. |
This section describes known issues and work around for the 9.0.0 release.
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.
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.
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.
This section summarizes the minimum system requirements for FioranoMQ. The actual product documentation includes the same in detail:
|
Platform |
Requirements |
Comments |
|
Windows |
Microsoft® NT Server 2003, XP Professional Java 5 or above Min Physical RAM : 256 MB Min Disk Space : 500 MB |
Fiorano Studio requires Java 5 or above |
| Linux |
Red Hat, Suse, Debian Java 5 or above Min Physical RAM : 256 MB Min Disk Space : 500 MB |
Fiorano Studio requires Java 5 or above |
|
HP-UX |
11i Java 5 or above Min Physical RAM : 256 MB Min Disk Space : 500 MB |
Fiorano Studio requires Java 5 or above |
| IBM AIX |
5x Java 5 and above Min Physical RAM : 256 MB Min Disk Space : 500 MB |
Fiorano Studio requires Java 5 or above |
| Solaris |
9x Java 5 and above Min Physical RAM : 256 MB Min Disk Space : 500 MB |
Fiorano Studio requires Java 5 or above |
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 Reference Guide |
Contains detailed description and examples for all the parameters used in FioranoMQ server and other components of FioranoMQ. |
|
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. |
Submit and track your support issues at http://support.fiorano.com
This requires a valid login; please contact your sales representative for the Fiorano Support Portal Login.
If you have any questions and/or comments on FioranoMQ, please feel free to contact us at:
Fiorano Software Technologies Pvt. Ltd.
Our Website - http://www.fiorano.com
Evaluation Support – presales@fiorano.com
Check out our Developer Zone at Uwww.fiorano.com/devzone/dev_zone.php
United States:
1-800-663-3621 (Toll-Free within the USA) or +1-650-326-1136 (9 AM to 5 PM Pacific Time)
Asia Pacific:
+91 80 40170000 (9 AM to 5 PM India Standard Time)
Japan:
+81 3 5464 3874 (9 AM to 5 PM Japan Standard Time)
Europe and Middle East:
+44 (0) 1932 895005 (9 AM to 5 PM London Standard Time)
Copyright © 1999-2008, Fiorano Software Technologies Pvt Ltd. All rights reserved.
Copyright © 2008-2009, Fiorano Software Pty Ltd. All rights reserved.
This software is the confidential and proprietary information of Fiorano Software ("Confidential Information"). You shall not disclose such Confidential Information and shall use it only in accordance with the terms of the license agreement enclosed with this product or entered into with Fiorano.