TIBCO Service Performance Manager Release Notes

TIBCO Service Performance Manager Release Notes Software Release 2.1.0 November 2013 Two-Second Advantage

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 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. 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, TIBCO Hawk, TIBCO Rendezvous, TIBCO Enterprise Message Service, TIBCO ActiveMatrix, TIBCO ActiveMatrix BusinessWorks, TIBCO StreamBase, TIBCO StreamBase LiveView, and TIBCO StreamBase LiveView Desktop 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 2008-2013 TIBCO Software Inc. ALL RIGHTS RESERVED. TIBCO Software Inc. Confidential Information

iii Contents Preface........................................................................ v Related Documentation..................................................................... vi TIBCO Service Performance Manager Documentation......................................... vi Other TIBCO Product Documentation...................................................... vi Typographical Conventions.................................................................. vii Connecting with TIBCO Resources............................................................ ix How to Join TIBCOmmunity.............................................................. ix How to Access TIBCO Documentation...................................................... ix How to Contact TIBCO Support........................................................... ix Release Notes.................................................................. 1 New Features............................................................................. 2 Release 2.1.0......................................................................... 2 Release 2.0.1......................................................................... 3 Changes in Functionality.................................................................... 5 Release 2.1.0......................................................................... 5 Release 2.0.1......................................................................... 5 Deprecated and Removed Features........................................................... 7 Release 2.1.0......................................................................... 7 Release 2.0.1......................................................................... 7 Migration and Compatibility.................................................................. 8 Release 2.1.0......................................................................... 8 Release 2.0.1......................................................................... 8 Closed Issues............................................................................ 9 Known Issues............................................................................ 10

iv Contents

v Preface 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. Please see the readme file for the availability of this software version on a specific operating system platform. TIBCO Service Performance Manager is an enterprise software platform that monitors and proactively manages the health and performance of both Information Technology (IT) and Business services based on Service Level Agreements (SLAs). This preface lists some important requirements and conventions. Topics Related Documentation, page vi Typographical Conventions, page vii Connecting with TIBCO Resources, page ix

vi Related Documentation Related Documentation This section lists the documentation resources you may find useful. TIBCO Service Performance Manager Documentation The following documents form the TIBCO Service Performance Manager documentation set: TIBCO Service Performance Manager Installation, Configuration, and Administration: Read this manual to understand the step-by-step instructions for installing the TIBCO Service Performance Manager software and post-installation steps. The manual also provides configuration details for the client, server, and WebConsole. TIBCO Service Performance Manager API Reference: Read this manual for developing a service probe that can send facts to TIBCO Service Performance Manager. The manual discusses the commonly used classes and interfaces of the API for developing a probe. TIBCO Service Performance Manager User s Guide: Read this manual to understand the basic concepts and use cases. The guide also describes the TIBCO Service Performance Manager dashboard. : Read this document for a summary of new features and a description of any issues that may affect installing or using the product. Other TIBCO Product Documentation You may find it useful to read the documentation for the following TIBCO product: TIBCO Enterprise Message Service TIBCO ActiveMatrix TIBCO ActiveMatrix BusinessWorks TIBCO Hawk TIBCO StreamBase TIBCO StreamBase LiveView

Preface vii Typographical Conventions The following typographical conventions are used in this manual. Table 1 General Typographical Conventions Convention ENV_NAME TIBCO_HOME SPM_HOME Use TIBCO products are installed into an installation environment. A product installed into an installation environment does not access components in other installation environments. Incompatible products and multiple instances of the same product must be installed into different installation environments. An installation environment consists of the following properties: Name Identifies the installation environment. This name is referenced in documentation as ENV_NAME. On Microsoft Windows, the name is appended to the name of Windows services created by the installer and is a component of the path to the product shortcut in the Windows Start > All Programs menu. Path The folder into which the product is installed. This folder is referenced in documentation as TIBCO_HOME. TIBCO Service Performance Manager installs into a directory within TIBCO_HOME. This directory is referenced in documentation as SPM_HOME. The default value of SPM_HOME depends on the operating system. For example on Windows systems, the default value is C:\tibco\spm\2.1. code font Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window. For example: Use MyCommand to start the foo process. bold code font Bold code font is used in the following ways: In procedures, to indicate what a user types. For example: Type admin. In large code samples, to indicate the parts of the sample that are of particular interest. In command syntax, to indicate the default parameter for a command. For example, if no parameter is specified, MyCommand is enabled: MyCommand [enable disable]

viii Typographical Conventions Table 1 General Typographical Conventions (Cont d) Convention italic font Key combinations Use Italic font is used in the following ways: To indicate a document title. For example: See TIBCO ActiveMatrix BusinessWorks Concepts. To introduce new terms. For example: A portal page may contain several portlets. Portlets are mini-applications that run in a portal. To indicate a variable in a command or code syntax that you must replace. For example: MyCommand PathName Key name separated by a plus sign indicate keys pressed simultaneously. For example: Ctrl+C. Key names separated by a comma and space indicate keys pressed one after the other. For example: Esc, Ctrl+Q. The note icon indicates information that is of special interest or importance, for example, an additional action required only in certain circumstances. The tip icon indicates an idea that could be useful, for example, a way to apply the information provided in the current section to achieve a specific result. The warning icon indicates the potential for a damaging situation, for example, data loss or corruption if certain steps are taken or not taken.

Preface ix Connecting with TIBCO Resources How to Join TIBCOmmunity TIBCOmmunity is an online destination for TIBCO customers, partners, and resident experts. It is a place to share and access the collective experience of the TIBCO community. TIBCOmmunity offers forums, blogs, and access to a variety of resources. To register, go to http://www.tibcommunity.com. How to Access TIBCO Documentation You can access the TIBCO documentation here: http://docs.tibco.com How to Contact TIBCO Support For comments or problems with this manual or the software it addresses, contact TIBCO Support as follows: For an overview of TIBCO Support, and information about getting started with TIBCO Support, visit this site: http://www.tibco.com/services/support If you already have a valid maintenance or support contract, visit this site: https://support.tibco.com Entry to this site requires a user name and password. If you do not have a user name, you can request for one.

x Connecting with TIBCO Resources

1 Release Notes Check the TIBCO Product Support web site at https://support.tibco.com for the product information that was not available at release time. Entry to this site requires a username and password. If you do not have a username, you can request for one. You must have a valid maintenance or support contract to use this site. Topics New Features, page 2 Changes in Functionality, page 5 Deprecated and Removed Features, page 7 Migration and Compatibility, page 8 Closed Issues, page 9 Known Issues, page 10

2 Release Notes New Features This section lists the features added since the last major release of this product. Release 2.1.0 The product name is changed from TIBCO ActiveMatrix Service Performance Manager to TIBCO Service Performance Manager from this release. This release supports an external Java installation in addition to bundled TIBCO JRE. This release supports a new optional add-on for integration of TIBCO Service Performance Manager with TIBCO StreamBase LiveView. This component enables viewing of computed aggregated metric results from the SPM server using customizable dashboards in TIBCO StreamBase LiveView Desktop. The new add-on provides a new utility LiveView Project Generator. You can use this utility to generate all the necessary artifacts required for Liveview projects, for any of the custom SPM schema defined for KPI computation and aggregation. Such a generated project can be imported and customized using LiveView Desktop. In addition to the generator utility, three out-of-the-box examples of LiveView projects (for TIBCO ActiveMatrix 3.3.0, TIBCO Hawk 5.0, and TIBCO ActiveMatrix BusinessWorks 5.11) are provided. This release bundles samples on how to design a probe in SPM_HOME\examples\probes folder. You can use this sample source code as a starting point to create your custom probes. With this release, TIBCO Service Performance Manager supports Microsoft SQL Server. For a complete list of supported platforms, databases, and third-party software, refer to the product readme.

New Features 3 Release 2.0.1 This release uses a completely new architecture, design and codebase, designed for flexibility and performance: Performance: The metrics computation is based on a real-time Online Analytical Processing (OLAP) design that is optimized for high performance. Flexibility: New schemas for different hierarchies of information can be used to affect the roll-up and aggregations of information. To this, newcalculation functions can be added to provide different or additional computations and metrics. calculation functions can be added to provide different or additional computations and metrics. Heterogeneous: A new Client API enables both, new producers and consumers of information. Independence: The server component is no longer hosted under ActiveMatrix Service Grid. Visualization: A new web-based user interface enables viewing of metrics and results outside of ActiveMatrix Administrator. Installation and Configuration Simplicity: The lack of dependencies on a host ActiveMatrix server platform for deployment has considerably simplified installation and configuration. Platform Support: Added support for the following platforms: Apple Mac OS X Sun Solaris 10 Microsoft Windows Server 2008 SP1 Microsoft Windows Server 2012 Microsoft Windows 8 IBM AIX 7.1 Database Support: Added support for PostgreSQL 9.2..x New visual client, called ActiveMatrix Service Performance Manager WebConsole Internet Explorer 9.0 and Firefox 20.0 Web Browsers This release uses a new user interface architecture and supports Internet Explorer 9.0, Firefox 20.0m and Chrome 28 with a recommended resolution of minimum 1280x1024.

4 Release Notes Client API This release provides a Java Client API that lets you model aggregation rules, and save the model to a schema file. This schema is made available to the TIBCO ActiveMatrix Service Performance Manager server. By using the client API, applications connect to the server and submit the data identified as facts. The server uses the facts as the input to compute the aggregations as defined in the schema. Also included is a query API that you can use to query the computations. Documentation A new documentation set is provided for this release that includes: TIBCO Service Performance Manager Installation, Configuration, and Administration TIBCO Service Performance Manager User s Guide TIBCO Service Performance Manager API Reference

Changes in Functionality 5 Changes in Functionality This section lists the changes in functionality since the last major release of this product. Release 2.1.0 This release supports: A new server property rta.snapshot.query.timeout. It specifies timeout for the expiration of snapshot query in milliseconds. SPM WebConsole as a Windows service. Email validation. For the invalid email, the text box border turns red. Release 2.0.1 The architecture of TIBCO ActiveMatrix Service Performance Manager 2.0.1 has undergone significant changes since the 1.3.3 release. The new release includes the following major components: TIBCO ActiveMatrix Service Performance Manager Server TIBCO ActiveMatrix Service Performance Manager Client TIBCO ActiveMatrix Service Performance Manager WebConsole TIBCO ActiveMatrix Service Performance Manager WebServer TIBCO Service Performance Manager 2.0.1 is a stand-alone product that enables applications to monitor their services by designing a probe. Application-specific probe can be designed using the TIBCO Service Performance Manager 2.0.1 APIs. TIBCO ActiveMatrix 3.x.x nodes use the client API to send data to the TIBCO ActiveMatrix Service Performance Manager 2.0.1 server for aggregations. For more information, refer to TIBCO ActiveMatrix Service Grid Installation Addendum. TIBCO Service Performance Manager WebConsole is currently customized only for the schema and probe used with TIBCO ActiveMatrix Service Grid. Other schemas and client data sources must use the client API to extract information as required.

6 Release Notes This product version supports the following software and platforms: JRE 1.7 or higher TIBCO Enterprise Message Service 6.3 or higher Databases: Oracle 11g Release 2 (11.2), PostgreSQL 9.2.x Platforms: Red Hat Enterprise Linux Server release 5.7-64 bit or higher, Microsoft Windows Server 2008-64 bit, and Windows 7-32 bit or 64 bit (for non-production purposes)

Deprecated and Removed Features 7 Deprecated and Removed Features This section describes the deprecated features (if any), and lists the features, if relevant, that may be useful alternatives to the deprecated features. Any use of a deprecated feature must be discontinued as it may be removed in a future release. Do not depend on deprecated features and use the suggested alternative features. This section also lists features that are removed (if any). Release 2.1.0 There are no deprecated or removed features in this release. Release 2.0.1 There are no deprecated or removed features in this release.

8 Release Notes Migration and Compatibility This section explains how to migrate from a previous release to this release. Release 2.1.0 There are no migration instructions. Release 2.0.1 This release is not backward compatible with TIBCO ActiveMatrix Service Performance Manager 1.3.3.

Closed Issues 9 Closed Issues This table lists the closed issues in this release. Key SPM-5139 SPM-5075 SPM-4665 SPM-4662 Summary/Workaround Running SpmApiDemo.java from the command prompt without specifying the property file, threw null pointer exception. Refreshing the WebConsole UI on Internet Explorer 9.0 made the UI appear small and unclear. While creating a rule, the application was unable to retrieve the operation. The WebConsole grids and charts were data-driven and not time-driven. So, when the time window changed to the next hour but there were no hits in that hour, the WebConsole grids and charts showed the old average hits, successes, response times, and so on.

10 Release Notes Known Issues The table in this section lists the known issues in this release. Key SPM-5314 SPM-5312 Summary/Workaround Summary When installing different features separately under the same TIBCO_HOME, sometimes a postinstallation error occurs. Workaround Create a new TIBCO_HOME, and install all the required features. Summary Sometimes on Windows Server platform, a TRA based executable, such as tibspm.exe, does not start, and gives an error message similar to the following: Lib name C:/tibco/spm/tibcojre64/1.7.0/bin/server/jvm.dll Failed to load shared library, library name : C:/tibco/spm/tibcojre64/1.7.0/bin/server/jvm.dll Workaround Manually edit the corresponding TRA file, and add %PSP%%TIB_JAVA_HOME%/bin to the Path variable as shown below: tibco.env.path %SPM_HOME%/hotfix/bin;%SPM_HOME%/bin;%EMS_HOME%/bin;%JVM_LIB_ SERVER_DIR%%PSP%%TIB_JAVA_HOME%/bin;%PATH% SPM-5222 Summary Running the tibspmddlgenerator utility for creating the database scripts for SQL server displays the following warning: Warning! The maximum key length is 900 bytes. The index 'metric_assets_pk' has maximum length of 1000 bytes. For some combination of large values, the insert/update operation will fail. Workaround On the SQL Server, ensure that various string values of fact attributes are small, such that the metric key so formed fits within the limit of 900 bytes. SPM-5205 Summary Running the Hawk Microagent (HMA) and the LiveView server on the same physical machine causes the HMA to crash. Workaround Do not run the HMA and LiveView server on the same physical machine.

Known Issues 11 Key SPM-5140 SPM-5131 Summary/Workaround Summary Unable to start the ActiveMatrix Service Performance Manager server as a Windows NT service when the Enterprise Message Service server is installed remotely or in a different TIBCO_HOME. Workaround Perform the following manual steps: 1. Go to SPM_HOME/bin. 2. Use tibspm.exe --uninstall. 3. Update EMS_HOME in SPM_HOME/bin/tibspm.tra appropriately. 4. Use tibspm.exe --install. 5. Start the Windows NT service. Summary At times, when the input data size of the fact attributes is greater than 255 characters, the server throws an exception. Workaround To overcome the issue: 2. Stop the server. 3. Execute the following command on the database: alter table <table_name> modify <column_name> varchar2(<new size>) (for Oracle) or alter table <table_name> modify <column_name> varchar (<new size>) (for PostgreSQL) where: <table_name> is the name of the fact table (fact_*) <column_name> is the column causing the error <new_size> is the new size of the column name that fully accommodates the incoming data size. This is available in the corresponding SPM error log. 4. Restart the server. If you encounter a similar issue with any string-based column of any TIBCO Service Performance Manager table, for example, the "key" column of the metric_* tables, follow a similar procedure and increase the column width. SPM-5116 Summary Creating a rule from any dashboard opens the Rule Wizard dialog. However, closing the Rule Wizard dialog opens the Rules Summary page instead of the dashboard. Workaround None

12 Release Notes Key SPM-5111 SPM-5096 SPM-5074 SPM-4943 SPM-4880 SPM-4879 SPM-4804 SPM-4717 Summary/Workaround Summary When you select a row on the Alerts dashboard, it is highlighted but the highlight disappears after you update the data. Workaround None Summary If an environment is created, and there is no node associated with it, the environment appears on the WebConsole only for the hour in which it was created. That is, if the environment is created at 10 or 10.30 A.M., it appears only until 11.00 A.M. Workaround Ensure that at least one node is created for the environment. Summary In the Create New Rule dialog, the operation name dimension values show up in the list only if there are service hits for the selected service. Workaround To define a rule on an operation, make sure the service (to which the operation belongs) is hit at least once. Summary If TIBCO Service Performance Manager is installed in a directory with a space in the name, a fatal error occurs. Workaround Use a directory name that does not have a space in it. Summary The Node Summary dashboard incorrectly displays the status of the System node as "Up" even after the System node is shut down. Workaround None Summary After shutting down TIBCO Host, the status of a deployed application appears to be "Running" on ActiveMatrix Administrator whereas it appears to be "Down" on the TIBCO ActiveMatrix Service Performance Manager WebConsole. Workaround None Summary When TIBCO Host goes down, the Availability of assets displayed on the Health Monitoring Summary screen is incorrect. Workaround None Summary When TIBCO Host is shut down, the status of Application and Environment changes to "Down", but the status of the node continues to appear as "Up". Workaround None

Known Issues 13 Key SPM-4663 SPM-4654 SPM-4642 SPM-4639 SPM-4638 SPM-4504 SPM-4485 Summary/Workaround Summary While working on the WebConsole, the Environment, Nodes, and Services summary appears blank for 30-40 seconds when the hour boundary crosses. Workaround None Summary Number of alerts displayed on the Alerts dashboard cannot be limited by setting the rta.max.timeresultset.fetch.count property. Workaround For the property to take effect on the Alerts dashboard, relogin to the WebConsole. Summary If two users use the same credentials to login, only one session can get the alerts. Workaround Do not use the same credentials, or avoid reuse of the same username and password combination. Summary TIBCO Enterprise Message Service with SSL transport is not supported. Workaround None Summary While working on the WebConsole, the sorted columns reset every few seconds. Workaround None Summary When you open the WebConsole in Internet Explorer 9.0 and expand the column, the column size is not fixed. Workaround None Summary Starting or stopping an asset such as an ActiveMatrix node does not reset its computed metrics. Workaround None

14 Release Notes