TIBCO · v Changes from the ... code font Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window

Two-Second Adv

TIBCO ActiveMatrix®

Service Performance Manager

Release NotesSoftware Release 2.0.1September 2013

antage®

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 Adapter, TIBCO Hawk, TIBCO Designer, TIBCO Rendezvous, TIBCO Administrator, TIBCO ActiveEnterprise and TIBCO Repository 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

Changes from the Previous Release of this Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vi

Related Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiTIBCO ActiveMatrix Service Performance Manager Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viiOther TIBCO Product Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . vii

Typographical Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . viii

Connecting with TIBCO Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xHow to Join TIBCOmmunity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xHow to Access TIBCO Documentation. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xHow to Contact TIBCO Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . x

Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

New Features. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2Release 2.0.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Changes in Functionality . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4Release 2.0.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Deprecated and Removed Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Release 2.0.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Migration and Compatibility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6Release 2.0.1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Closed Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Known Issues. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

TIBCO ActiveMatrix Service Performance Manager Release Notes

iv | Contents


| v

Preface

TIBCO ActiveMatrix® 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

• Changes from the Previous Release of this Guide, page vi

• Related Documentation, page vii

• Typographical Conventions, page viii

• Connecting with TIBCO Resources, page x

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.


vi | Changes from the Previous Release of this Guide

Changes from the Previous Release of this Guide

This is a new guide for this release.


Preface | vii

Related Documentation

This section lists the documentation resources you may find useful.

TIBCO ActiveMatrix Service Performance Manager DocumentationThe following documents form the TIBCO ActiveMatrix Service Performance Manager documentation set:• TIBCO ActiveMatrix Service Performance Manager Installation, Configuration, and

Administration: Read this manual to understand the step-by-step instructions for installing the TIBCO ActiveMatrix Service Performance Manager software and post-installation steps. The manual also provides configuration details for the client, server, and WebConsole.

• TIBCO ActiveMatrix Service Performance Manager API Reference: Read this manual for developing a service probe that can send facts to TIBCO ActiveMatrix Service Performance Manager. The manual discusses the commonly used classes and interfaces of the API for developing a probe.

• TIBCO ActiveMatrix Service Performance Manager User’s Guide: Read this manual to understand the basic concepts and use cases. The guide also describes the ActiveMatrix Service Performance Manager dashboard.

• TIBCO ActiveMatrix Service Performance Manager Release Notes: 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 DocumentationYou may find it useful to read the documentation for the following TIBCO product:

• TIBCO Enterprise Message Service™


viii | Typographical Conventions

Typographical Conventions

The following typographical conventions are used in this manual.

Table 1 General Typographical Conventions

Convention Use

ENV_NAME

TIBCO_HOME

SPM_HOME

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 ActiveMatrix 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.0.

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]


Preface | ix

italic font 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 combinations

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.

Table 1 General Typographical Conventions (Cont’d)

Convention Use


x | Connecting with TIBCO Resources

Connecting with TIBCO Resources

How to Join TIBCOmmunityTIBCOmmunity 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 DocumentationYou can access the TIBCO documentation here:

http://docs.tibco.com

How to Contact TIBCO SupportFor 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.


http://www.tibco.com/services/support


http://docs.tibco.com

http://www.tibcommunity.com

| 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 4

• Deprecated and Removed Features, page 5

• Migration and Compatibility, page 6

• Closed Issues, page 7

• Known Issues, page 8



2 | Release Notes

New Features

This version, 2.0.1, of the product has undergone significant architectural changes and should be considered as a new product.

This section lists the features added since the last major release of this product.

Release 2.0.1This 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, new 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 10.8.x 64-bit on x86-64

Microsoft Windows Server 2012 64-bit on x86-64

IBM AIX 7.1 64-bit on pSeries

— Database Support: Added support for PostgreSQL 9.2.4.

Internet Explorer 9.0, Firefox 20.0, and Chrome 28 Web Browsers

This release uses a new user interface architecture and supports Microsoft Internet Explorer 9.0, Mozilla Firefox 20.0, and Google Chrome 28 with a recommended resolution of minimum 1280x1024.


New Features | 3

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. The client API lets 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 lets you query the computations.

Documentation

A new documentation set is provided for this release that includes:

• TIBCO ActiveMatrix Service Performance Manager Installation, Configuration, and Administration

• TIBCO ActiveMatrix Service Performance Manager User’s Guide

• TIBCO ActiveMatrix Service Performance Manager API Reference


4 | Release Notes

Changes in Functionality

This section lists the changes in functionality since the last major release of this product.

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 Web Server

• TIBCO ActiveMatrix 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 ActiveMatrix 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 ActiveMatrix 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 should use the client API to extract information as required.

• 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)


Deprecated and Removed Features | 5

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 should 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.0.1There are no deprecated or removed features in this release.


6 | Release Notes

Migration and Compatibility

This section explains how to migrate from a previous release to this release.

Release 2.0.1This release of TIBCO ActiveMatrix Service Performance Manager is not backward compatible with TIBCO ActiveMatrix Service Performance Manager 1.3.3.


Closed Issues | 7

Closed Issues

This version 2.0.1 of the product has undergone significant architectural changes and should be considered as a new product. Since this is a re-engineered product, there are no closed issues in this release.


8 | Release Notes

Known Issues

The table in this section lists the known issues in this release.

Key Summary/Workaround

SPM-5140 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.

SPM-5139 Summary A NullPointerException is thrown when you run the SpmApiDemo.java from the command prompt, without specifying the property file.

Workaround At the command prompt, when you run the java command, add the following: -propFile "%SPM_HOME%/config/Demo_config.properties.

For example, java com.tibco.rta.examples.SpmApiDemo -propFile "C:/tibco/spm/2.0/config/Demo_config.properties


Known Issues | 9

SPM-5131 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:

6. Stop the Server.

7. 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 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.

8. Restart the Server.

If you encounter a similar issue with any string based column of any ActiveMatrix 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

SPM-5111 Summary When you select a row on the Alerts dashboard, it is highlighted but the highlight disappears after you update the data.

Workaround None

SPM-5096 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.



10 | Release Notes

SPM-5075 Summary Refreshing the WebConsole UI on Internet Explorer 9.0 makes the UI appear small and unclear.

Workaround Do not refresh the WebConsole UI manually on IE 9.0. If you need to refresh the WebConsole UI, navigate to the home page, refresh it manually, and then navigate to the required dashboard.

SPM-5074 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.

SPM-4880 Summary The Node Summary dashboard incorrectly displays the status of System node as “Up” even after the System node is shutdown.

Workaround None

SPM-4879 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

SPM-4804 Summary When TIBCO Host goes down, the Availability of assets displayed on the Health Monitoring Summary screen is incorrect.

Workaround None

SPM-4717 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

SPM-4663 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

SPM-4662 Summary The WebConsole grids and charts are data-driven and not time-driven. So, when the time window changes to the next hour but there are no hits in that hour, the WebConsole grids and charts show the old average hits, successes, response times, and so on.

Workaround None



Known Issues | 11

SPM-4662 Summary In the Application details and Service details dashboards, incorrect charts are displayed for the time windows: "This Week" and "Today."

Workaround None

SPM-4654 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.

SPM-4642 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.

SPM-4639 Summary TIBCO Enterprise Message Service with SSL transport is not supported.

Workaround None

SPM-4638 Summary While working on the WebConsole, the sorted columns reset every few seconds.

Workaround None

SPM-4504 Summary When you open the WebConsole in Internet Explorer 9.0 and expand the column, the column size is not fixed.

Workaround None

SPM-4485 Summary Starting or stopping an asset such as an ActiveMatrix node does not reset its computed metrics.

Workaround None



12 | Release Notes


Documents

TIBCO · v Changes from the ... code font Code font identifies commands, code examples, filenames, pathnames, and output displayed in a command window