Oracle TSAM Plus 12c Release 2 (12.2.2) Release Notes

Oracle TSAM Plus 12c Release 2 (12.2.2)
Date: January 2017

 

Table 1 Revision History

Revision Date	Summary of Change
January 2017	12c Release 2 (12.2.2) Rolling Patch 002
April 2016	12c Release 2 (12.2.2) GA

•	About Oracle TSAM Plus

•	Oracle TSAM Plus Software Components

•	Function Matrix

•	Installation Notes

•	Interoperability

•	Version Supported by Enterprise Manager for Oracle Tuxedo

•	PeopleSoft Support

•	Known Issues

About Oracle TSAM Plus

Oracle Tuxedo System and Applications Monitor Plus 12c Release 2 (12.2.2) provides comprehensive monitoring and reporting for the Oracle Tuxedo system and applications. It includes three components: Oracle TSAM Plus Agent, Oracle TSAM Plus Manager, and Enterprise Manager for Oracle Tuxedo.

Oracle TSAM Plus 12.2.2 new features are:

•

Tuxedo-as-a-Service for private clouds: Based on Oracle Enterprise Manager, this feature allows one to create templates for Tuxedo system and applications. The service template then can be instantiated on one or more nodes from a pool of resources. This solution enables customers to have a unified private middleware Platform-as-a-Service (PaaS) solution across many different Oracle products, such as WebLogic Server, Database, SOA Suite, etc. This feature includes the following main functions:

•	The cloud administration functions like resource provider management, quota management, and service template definition. These functions allow a self-service application administrator (SSA admin) to manage Tuxedo cloud and Tuxedo cloud services consumed by end users.

•

The end user operations like service instance creation, application management, deployment, and automatic scaling based on scheduled plan or metrics. The self service application users (SSA user) can instantiate a particular Tuxedo service, which could consist of Tuxedo system or a complete application.

For more information, see Setting Up Oracle Tuxedo as a Cloud Service.

•

Application Introspection: Provides both command line and console modes to introspect the existing applications domain(s) and package those for deployment in another environment including private or public clouds. This feature makes it extremely easy to move Tuxedo applications from one environment to another. For more information, see Introspecting an Existing Domain.

•

Application payload collection from Tuxedo transactions and service executions: With this feature, one can define payload collection and filtering policies, store the collected payload in one of the several ways (Oracle Database, Hadoop file system, or local files), and export the payload in plain text or XML format using a series of APIs and tools for further aggregation and analysis. For more information, see User Payload Collection.

•

Test Load Generator: A Tuxedo applications load test tool that facilitates effective and efficient load testing. This feature works in conjunction with the payload collection feature to capture the call path and payload metrics coming from a domain gateway, Web service client or application server. One can create replay definition from call paths and execute the replay based on policies for standard and stress test modes. For more information, see Using Test Load Generator.

•	TSAM Plus Manager enhancements for monitoring Oracle ART IMS

•	ART IMS system and region summary pages for an overview of the ART IMS system.

•	ART IMS resource file editor for easy view and editing of configurations.

•	Enterprise Manager for Oracle Tuxedo enhancements for monitoring ART Batch

•	JES Job data synchronization with JESROOT.

•	Schedulable JES job purging.

•	Using Tuxedo Scripting Tool (TXST), one can now dynamically administer Domains component of Tuxedo applications. This is enabled by addition of Domains MIB to TXST.

•	TSAM Plus call path monitoring now supports use of custom call IDs in addition to ECID and correlation IDs.

•	Diagnostic enhancement for better logging and tracing.

•	Out-of-the-box monitoring policies for monitoring Oracle Tuxedo in PeopleSoft applications.

In addition, rolling patch 002 includes following new features and enhancements:

•	Powerful, flexible dashboard providing visibility into multiple domains, with ability to dig down to individual domains.

•	Availability status, key service metrics, and alerts in the default dashboard.

•	Customizable dashboard - see metrics that you would like to see

•	Adaptive alerts: alerts are configured automatically based on learnt application behavior - no need to setup policies.

•	Very low performance impact to application when TSAM Plus running in default operation mode

•	Significantly reduced volume of data collected on the Manager side

•	Ability to define conditional call path filters to narrow down the call path metrics collected and sent to TSAM Plus manager. This feature allows call path information to be collected only in exceptional cases and thus saving network and database resources.

•	A new management tool tsamadmin is provided to:

•	Add the LMS configurations in the UBBCONFIG file automatically

•	Run a sanity check to examine if the configurations are properly made and TSAM Plus Agent can communicate with the Manager

For more information, see the Oracle TSAM Plus Users Guide.

Oracle TSAM Plus Software Components

Oracle TSAM Plus 12.2.2 software consists of the following components:

•	Oracle TSAM Plus Agent 12.2.2

Oracle TSAM Plus agent enables collection of various performance metrics for applications. It includes the following sub-components:

•	Oracle TSAM Plus Plug-in Framework

•	Oracle TSAM Plus Default Plug-in

•	Local Monitor Server (LMS)

•	accrpt, an utility to analyze accounting and chargeback information generated by -a option in servopts(5)

•	Oracle Tuxedo JMX Agent

•	Oracle Tuxedo Scripting Tool

•	Oracle Business Transaction Management (BTM) Tuxedo Observer

•	Oracle TSAM Plus Manager 12.2.2

Oracle TSAM Plus Manager correlates and aggregates performance metrics collected from one or more Oracle Tuxedo domains and displays those in real time. It includes the following sub-components:

•	Oracle TSAM Plus Console

•	Oracle TSAM Plus Data Server

•	Enterprise Manager for Oracle Tuxedo 13.1.2.0.0

Enterprise Manager for Oracle Tuxedo is an Oracle Enterprise Manager plug-in, which enables you to monitor and manage Oracle Tuxedo product family from a centralized console along with other products such as Oracle WebLogic Server and Oracle Database.

Note:

The Oracle TSAM Plus Agent 12.2.2 is shipped in Oracle Tuxedo 12.2.2 installers. Enterprise Manager for Oracle Tuxedo 13.1.2.0.0 is shipped in Oracle TSAM Plus Manager 12.2.2 installers.

Function Matrix

The following function matrix tables show the supported functionalities of Oracle TSAM Plus for different Oracle Tuxedo family products.

 

Table 2 Function Matrix - Monitoring

Monitored Product	Function	TSAM Plus Console (Tuxedo 12.2.2)	Enterprise Manager for Oracle Tuxedo (EM Console) (Tuxedo 12.2.2)
Oracle Tuxedo Core	Call Path	Yes
	Call Pattern	Yes
	Service (real time)	Yes
	Service (aggregated per collection interval)	Yes Can be implemented by metrics query	Yes
	Accounting and Chargeback	Yes
	XA Transaction (real time)	Yes
Oracle Tuxedo Core	XA Transaction (aggregated per collection interval)	Yes Can be implemented by metrics query	Yes
	Bridge	Yes	Yes
	/T Domain Gateway	Yes	Yes
	TMQUEUE		Yes
	JSL/WSL/TMS		Yes
	Tuxedo User/System Event		Yes
	Microsecond Level Metrics	Yes
SALT	GWWS	Yes	Yes
ART CICS	ART CICS Transaction (real time)	Yes
	ART CICS Transaction (aggregated per collection interval)	Yes Can be implemented by metrics query	Yes
	ART CICS Terminals	Yes
	ART CICS TSQ/TDQ		Yes
	Call path extended API for ART CICS	Yes
ART Batch	Job Information	Yes	Yes
ART IMS	IMS Monitoring	Yes
	Call path extended API for DLI	Yes
All	Alert	Yes Basic	Yes Based on EM event/incident system. More sophisticated and flexible
All	Monitoring Policy	Yes Users must define their policies first.	Out of box

 

Table 3 Function Matrix - Management

Monitored Product	Function	TSAM Plus Console (Tuxedo 12.2.2)	Enterprise Manager for Oracle Tuxedo (EM Console) (Tuxedo 12.2.2)
Oracle Tuxedo Core	Management functionalities migrated from Tuxedo administration console		Yes
	Dynamic request broker		Yes
ART CICS			Yes
ART Batch	Basic JES Job Operations	Yes	Yes
	GDG Management		Yes

 

Table 4 Function Matrix - Other

Function	TSAM Plus Console (Tuxedo 12.2.2)	Enterprise Manager for Oracle Tuxedo (EM Console) (Tuxedo 12.2.2)
Application Package Management/Resource Broker/Dynamic Resource Broker for Oracle Tuxedo		Yes
Application Package Management/Resource Broker/Dynamic Resource Broker for ART CICS/ART Batch		Yes
Reporting		Yes
SLA		Yes
Customizable Job		Yes
One console to monitor Oracle Tuxedo, WebLogic Server, and Oracle Database		Yes
Integration with Tuxedo OVAB Plug-in		Yes

Installation Notes

Oracle TSAM Plus 12c Release 2 (12.2.2) is supported for Oracle Tuxedo 12c Release 2 (12.2.2).

Oracle Tuxedo 12c Release 2 (12.2.2) RP014 or later is required for Oracle TSAM Plus 12c Release 2 (12.2.2) Agent RP002 or later.

For more information about supported platforms, see Oracle TSAM Plus Supported Platforms, Web Containers, and DBMS.

Enterprise Manager for Oracle Tuxedo is an Oracle Enterprise Manager plug-in. You need to deploy it to Oracle Enterprise Manager. For more information, see Deploying Enterprise Manager for Oracle Tuxedo in Oracle TSAM Plus Deployment Guide.

Oracle TSAM Plus 12c Release 2 (12.2.2) bundles Oracle WebLogic Server 12.2.1 which is out-of-date. Please download and use the latest version of Oracle WebLogic Server 12.2.x instead of using the bundled version.

Interoperability

For standalone TSAM Plus manager:

•	Oracle TSAM Plus 12c Release 2 (12.2.2) manager maintains full interoperability with Oracle TSAM agent 12.1.3, 12.1.1.1, 11.1.1.2, and 11.1.1.1.0.

•	Oracle TSAM Plus 12c Release 2 (12.2.2) manager can monitor Oracle TSAM 1.1/10gR3 agent.

•	Oracle TSAM Plus 12c Release 2 (12.2.2) manager can report performance, and alerts collected by Oracle TSAM 1.1/10gR3 agent.

•	Oracle TSAM Plus 12c Release 2 (12.2.2) manager cannot monitor Oracle Tuxedo node status (domain, machine, group, server and service) collected by Oracle TSAM 1.1/10gR3 agent.

•	Policies and alert definitions defined using Oracle TSAM Plus 12c Release 2 (12.2.2) console cannot work on an Oracle TSAM 1.1/10gR3 agent node. Oracle TSAM Plus 12c Release 2 (12.2.2) agent can work with Oracle TSAM 1.1/10gR3 agent in MP and Domain modes.

•	You cannot define policies for Oracle TSAM 1.1/10gR3 agent in the Oracle TSAM Plus 12.2.2 console. You must use the TMMONITOR environment variable or the tmadmin chmo command to define Oracle TSAM 1.1/10gR3 agent compliant policies.

For Enterprise Manager for Oracle Tuxedo:

•	It can work with TSAM Plus 12.2.2 and 12.1.3 agent. For TSAM Plus 12.1.3 agent, Rolling Patch 008 or later for Enterprise Manager for Oracle Tuxedo is required.

Version Supported by Enterprise Manager for Oracle Tuxedo

Enterprise Manager for Oracle Tuxedo 13.1.2.0.0 supports monitoring the following product versions:

•	Oracle Tuxedo 12c Release 2 (12.2.2)

•	Oracle SALT 12c Release 2 (12.2.2)

•	Oracle Tuxedo Application Runtimes 12c Release 2 (12.2.2)

PeopleSoft Support

Oracle TSAM Plus supports the out-of-box monitoring for Oracle Tuxedo within PeopleSoft applications.

The following PeopleSoft product versions are supported:

•	PeopleSoft PeopleTools 8.54

•	PeopleSoft Applications running on PeopleTools 8.54

At TSAM Plus agent side, Oracle TSAM Plus 12.1.1.1 for Oracle Tuxedo 12.1.1 Rolling Patch 024 or later is required. At TSAM Plus manager side, TSAM Plus 12.2.2 manager is required.

 

Known Issues

The following section describes known problems in Oracle TSAM Plus 12c Release 2 (12.2.2). Entries include a description of the problem, and a workaround or solution where appropriate.

Each problem is listed by the Bug ID number. The Bug ID number is provided to facilitate the tracking of these problems.

 

BugID	Description and Workaround or Solution
1. 23094158	Problem: Tuxedo cloud service instance status is in error and the tlisten process is not started after the service instance restarts.
	Platforms: All
	Workaround: Start the Tuxedo cloud service instance from the service instance home page.
2. 23088596	Problem: The domain status is not correct after scaling up/down a Tuxedo cloud service instance multiple times.
	Platforms: All
	Workaround: Restart Enterprise Manager agent and clear the state.
3. 22993628	Problem: Sometimes you failed to install the Tuxedo patch when creating a Tuxedo cloud service instance on IBM AIX.
	Platforms: IBM AIX
	Workaround: Manually install Tuxedo patch on the IBM AIX platform.

See Also

•	Oracle TSAM Plus Product Overview

•	Oracle TSAM Plus Installation Guide

•	Oracle TSAM Plus Deployment Guide

•	Oracle TSAM Plus Configuration Guide

•	Oracle TSAM Plus User Guide