TIBCO BWPM Client Notes
Process Monitor Client for BW Notes Software 2.2.1 Published: December 2013
Important Information SOME TIBCO SOFTWARE EMBEDS OR BUNDLES OTHER TIBCO SOFTWARE. USE OF SUCH EMBEDDED OR BUNDLED TIBCO SOFTWARE IS SOLELY TO ENABLE THE FUNCTIONALITY (OR PROVIDE LIMITED ADDON 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 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. 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, The Power of Now, TIBCO ActiveMatrix BusinessWorks, TIBCO Rendezvous, TIBCO Administrator, TIBCO Enterprise Message Service, TIBCO InConcert, TIBCO Policy Manager, and TIBCO Hawk are either registered trademarks or trademarks of TIBCO Software Inc. in the United States and/or other countries. EJB, Java EE, J2EE, and all Javabased trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. 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 NONINFRINGEMENT. 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 20012013 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information
Contents Notes Installation... 5 2.2 2.1.x 2.0 New Features 5 2.2.1 2.2 2.1.2 2.1.1... 5... 5... 5... 6... 6... 6... 6... 6 Change in functionality... 7 2.2.1 2.2 2.1.2 2.1.1 2.0 Bug fixes... 7... 7... 7... 7... 7... 8 2.2.1 2.2 2.1.2 2.1.1... 8... 8... 8... 8 Deprecated Features... 10 2.2.1 2.2 2.1.2 2.1.1 2.0 Compatibility 2.2.1 2.2 2.1.2 2.1.1 2.0 Restrictions... 10... 10... 10... 10... 10... 11... 11... 11... 11... 11... 11... 12
Notes Installation 2.2 1. Extract the file TIB_BWPM_2.2.0_upgrade.zip to a temporary location. 2. Stop all TIBCO BusinessWorks engines that use TIBCO BWPM Client. 3. On all TIBCO BusinessWorks servers replace the file bwpm.jar (extracted in step 1) with the new version of this release. 4. Restart TIBCO BusinessWorks engines. 2.1.x 1. Extract the file TIB_BWPM_2.1.x_upgrade.zip to a temporary location. 2. Stop all TIBCO BusinessWorks engines that use TIBCO BWPM Client. 3. On all TIBCO BusinessWorks servers replace the file bwpm.jar (extracted in step 1) with the new version of this release. 4. Restart TIBCO BusinessWorks engines. 2.0 1. Stop all TIBCO BusinessWorks engines that use TIBCO BWPM Client. 2. On all TIBCO BusinessWorks servers replace the file bwpm.jar with the new version of this release. 3. Restart TIBCO BusinessWorks engines. 5
TIBCO BWPM Client Notes New Features 2.2.1 None. 2.2 Automated correlation: inject context information (CorrelationLogID, ParentLogID) to outbound event streams (JMS, HTTP, Service.agent over JMS) automatically with TIBCO BusinessWorks 5.11 Exclude individual processes from monitoring Tracing enhancements: "Deep trace": enable tracing for entire process chains with TIBCO BusinessWorks 5.11 Apply trace settings to multiple domain objects Apply trace points for multiple activities of one process at once Capture $_error object, if tracing is enabled Extracts enhancements: Conditional extracts: rule based event type definiton Apply extracts to many domain objects Additional fields added: Payload, Stacktrace, EventMsg, EventMsgCode Export/Import of extracts Optimization on client/server communication 2.1.2 The EMS ClientId can now be configured for each BW engine using this global variable: njams/dataprovider/jms/clientid 2.1.1 Added platform support for AIX 6.1 6
Change in functionality 2.2.1 The client now supports the custom TIBCO BusinessWorks Engine property "ShutdownOnStartupError". If that property is set to "true", the client will now initiate an engine shutdown, if the JMS connection cannot be established during the startup sequence. 2.2 None. 2.1.2 None. 2.1.1 TIBCO BWPM Client now uses a consolidated XML based configuration file. 2.0 None. 7
TIBCO BWPM Client Notes Bug fixes 2.2.1 Ticket Topic No #1031 a wrong subprocess was returned in some dynamic call scenarios #984 when configuring Extracts on both input and output data on a single activity, two log events were generated instead of one #678 the custom BW engine property "ShutdownOnStartupError" was not evaluated correctly 2.2 Ticket No Topic #865 Failure at process spawn #902 Timeout push does not push cyclic after timeout #944 Trace data not collected (out) for activities with nonalphanumerical names #945 Incorrect behaviour when EMS server does not accept message 2.1.2 Ticket Topic No #820 TIBCO BWPM Client would write many entries to the log file in case of a broken EMS connection 2.1.1 Ticket Topic No #687 the BWPM client would open too many (up to 20) JMS connections. This has been fixed, so that the BWPM client uses exactly one connection now #691 if regex rules were defined in the TRA file and would trigger on activities with no output data, a nullpointer exception was thrown 8
#692 #743 if an extract was configured for a start activity of a subprocess, the extract would only work, if tracing was enabled for this activity in "exclusive" log mode, when activities had extracts configured, the process would still not be monitored by the BWPM client when the TIBCO Designer tester took long to initialize a test session, the BWPM client would not register correctly when the BW engine would take very long to initialize, the BWPM client would not register correctly with the engine and not monitor processes if a client tried to respond on a non existing temporary queue, an error was thrown. The error message is now suppressed process design of design time libraries would not be sent to server when in tester mode BusinessStart and BusinessEnd could not be mapped when using the palette #775 Extracts do not work on input data for activities within groups #700 #701 #703 #712 #726 9
TIBCO BWPM Client Notes Deprecated Features This section lists deprecated features and specifies equivalent features that provide with the same result. Please avoid becoming dependent on deprecated features and become familiar with the quivilent feature. 2.2.1 None. 2.2 Java 5 Support has been deprecated with this release. The next version of this product will not run under Java 5. 2.1.2 none 2.1.1 Usage of regex rules in the TRA file is deprecated. 2.0 none 10
Compatibility 2.2.1 This release is compatible with all previous 2.x releases and hotfix levels. To enable all new 2.2 This release is compatible with all previous 2.x releases and hotfix levels. To enable all new 2.1.2 This release is compatible with all previous 2.x releases and hotfix levels. 2.1.1 This release is compatible with all previous 2.x releases and hotfix levels. 2.0 This release is compatible with all previous releases and hotfix levels. 11
TIBCO BWPM Client Notes Restrictions none 12