Release Notes

     Previous  Next    Open TOC in new window    View as PDF - New Window  Get Adobe Reader - New Window
Content starts here

Oracle TSAM Plus 12c Release 1 (12.1.1.1) Release Notes

Oracle TSAM Plus 12c Release 1 (12.1.1.1)
Date: August 2013

Table 1 Revision History
Revision Date
Summary of Change
August 2013
  • Support for Oracle Tuxedo 11.1.1.2.0 on the HP-UX Itanium 64-bit platform
  • Support for Oracle Tuxedo 9.1 (Linux 32-bit and HP-UX PA-RISC 32-bit only)
May 2013
Support for Oracle Tuxedo 10gR3 on the HP-UX Itanium 64-bit platform
April 2013
Support for Oracle Tuxedo 10gR3
February 2013
Release 12.1.1.1

This topic contains the following sections:

 


About Oracle TSAM Plus

Oracle Tuxedo System and Applications Monitor Plus 12c Release 1 (12.1.1.1) 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 major features are:

For more information, see the Oracle TSAM Plus Console Users Guide and Enterprise Manager for Oracle Tuxedo User Guide.

 


Oracle TSAM Plus Software Components

Oracle TSAM Plus software consists of the following components:

 


Function Matrix

The following function matrix tables show the supported functionalities of Oracle TSAM Plus and Enterprise Manager for Oracle Tuxedo when interoperating with different Oracle Tuxedo family products.

Table 2 Function Matrix - Monitoring
Monitored Product
Function
TSAM Plus Console (Tuxedo 10.3/11.1.1.2/11.1.1.3/12.1.1)
Enterprise Manager for Oracle Tuxedo (EM Console)
Tuxedo 9.1
Tuxedo 10.3
Tuxedo 11.1.1.2
Tuxedo 11.1.1.3
Tuxedo 12.1.1
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
Yes
Yes
Yes
Yes
Accounting and Chargeback
Yes
         
XA Transaction (real time)
Yes
         
Tuxedo Core
XA Transaction (aggregated per collection interval)
Yes
Can be implemented by metrics query
Yes
Yes
Yes
Yes
Yes
Bridge
Yes
Only the availability metrics are supported
Only the availability metrics are supported
Only the availability metrics are supported
Only the availability metrics are supported
Yes
/T Domain Gateway
Yes
Yes
Yes
Yes
Yes
Yes
TMQUEUE
 
Yes
Yes
Yes
Yes
Yes
JSL/WSL/TMS
 
Yes
Yes
Yes
Yes
Yes
Tuxedo User/System Event
 
Yes
Users must set the environment variable of SNMP_USER_EVENT to "Y".
Yes
Users must set the environment variable of SNMP_USER_EVENT to "Y".
Yes
Users must set the environment variable of SNMP_USER_EVENT to "Y".
Yes
Users must set the environment variable of SNMP_USER_EVENT to "Y".
Yes
Microsecond Level Metrics
Yes
         
TMA
TMA SNA Domain Gateway
         
Yes
TMA SNA CRM
         
Yes
TMA TCP Domain Gateway
         
Yes
SALT
GWWS
Yes
Yes
Need to install Oracle SALT 2.0 RP011 first
Yes
Need to install Oracle SALT 10gR3 (10.3) RP019 first
Yes
Need to install Oracle SALT 11gR1 (11.1.1.2) RP011 first
Yes
Need to install Oracle SALT 11gR1 (11.1.1.2) RP011 first
Yes
OTMQ
   
N/A
N/A
N/A
N/A
Yes
ART CICS (From Tuxedo 11.1.1.1)
ART CICS Transaction (real time)
Yes
N/A
N/A
     
ART CICS Transaction (aggregated per collection interval)
Yes
Can be implemented by metrics query
N/A
N/A
   
Yes
ART CICS Terminals
Yes
N/A
N/A
     
ART CICS TSQ/TDQ
 
N/A
N/A
   
Yes
Call path extended API for ART CICS
Supported in 12.1.1 only
N/A
N/A
     
ART Batch
(From Tuxedo 11.1.1.1)
Job Information
Yes
N/A
N/A
   
Yes
All
Alert
Yes
Basic
Yes
Based on EM event/incident system. More sophisticated and flexible
Yes
Based on EM event/incident system. More sophisticated and flexible
Yes
Based on EM event/incident system. More sophisticated and flexible
Yes
Based on EM event/incident system. More sophisticated and flexible
Yes
Based on EM event/incident system. More sophisticated and flexible
All
Monitoring Policy
Yes
Users must define their policies first.
Out of box
Out of box
Out of box
Out of box
Out of box

Table 3 Function Matrix - Management
Monitored Product
Function
TSAM Plus Console (Tuxedo 10.3/11.1.1.2/11.1.1.3/12.1.1)
Enterprise Manager for Oracle Tuxedo (EM Console)
Tuxedo 9.1
Tuxedo 10.3
Tuxedo 11.1.1.2
Tuxedo 11.1.1.3
Tuxedo 12.1.1
Tuxedo Core
Management functionalities migrated from Tuxedo administration console
 
Yes
Yes
Yes
Yes
Yes
Dynamic request broker
         
Yes
ART CICS (From Tuxedo 11.1.1.1)
 
N/A
N/A
   
Yes
ART Batch (From Tuxedo 11.1.1.1)
Basic JES Job Operations
Yes
N/A
N/A
   
Yes
GDG Management
 
N/A
N/A
   
Yes

Table 4 Function Matrix - Other
Function
TSAM Plus Console (Tuxedo 10.3/11.1.1.2/11.1.1.3/12.1.1)
Enterprise Manager for Oracle Tuxedo (EM Console)
Tuxedo 9.1
Tuxedo 10.3
Tuxedo 11.1.1.2
Tuxedo 11.1.1.3
Tuxedo 12.1.1
Application Package Management/Resource Broker/Dynamic Resource Broker for Tuxedo
 
Yes
Yes
Yes
Yes
Yes
Application Package Management/Resource Broker/Dynamic Resource Broker for ART CICS/ART Batch
 
N/A
N/A
   
Yes
Reporting
 
Yes
Yes
Yes
Yes
Yes
SLA
 
Yes
Yes
Yes
Yes
Yes
Customizable Job
 
Yes
Yes
Yes
Yes
Yes
One console to monitor Tuxedo, Weblogic Server, and Oracle Database
 
Yes
Yes
Yes
Yes
Yes
Integration with Tuxedo OVAB Plug-in
 
N/A
N/A
Yes
Yes
Yes

Note: TSAM Plus Console 12.1.1 doesn’t support Tuxedo 9.1.

 


Installation Notes

Oracle TSAM Plus 12c Release 1 (12.1.1.1) is supported in the following Oracle Tuxedo releases:

For more information about platforms supported on specific Oracle Tuxedo rolling patch levels, see Oracle TSAM Plus Supported Platforms, Web Containers, and DBMS.

Notes:
Note: You need to apply a one-off patch before you can use Enterprise Manager for Oracle Tuxedo to monitor and manager Oracle Tuxedo 10.3. The one-off patch p16532565_121020_Generic.zip is available under $TSAMDIR/em after you install the TSAM Plus manager. Extract files and follow the readme.txt to apply the patch.

For more information, see Oracle TSAM Plus Installation Guide.

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 Enterprise Manager for Oracle Tuxedo Deployment Guide.

 


Migration Considerations

You can migrate from Oracle Tuxedo System and Application Monitor releases to Oracle Tuxedo System and Applications Monitor Plus 12c. The following are supported:

 


Interoperability

Please note the following:

 


Version Supported by Enterprise Manager for Oracle Tuxedo

Enterprise Manager for Oracle Tuxedo supports the following versions of products:

 


Known Issues

The following section describes known problems in Oracle TSAM Plus 12c Release 1 (12.1.1.1). 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. 16475008
Problem: While browsing TSAM Console pages, you may get an error message “An unknown error occurred during data streaming. Ask your System Administrator to inspect the server-side logs”, and find an exception "java.lang.NoClassDefFoundError: sun/awt/X11GraphicsEnvironment" or "java.lang.InternalError: Can't connect to X11 window server using 'hostname:1.0' as the value of the $DISPLAY variable." in the server-side log.
Platform: Unix/Linux
Workaround: This problem may be caused by an invalid $DISPLAY environment variable value setting. Do one of the following:
  • Append -Djava.awt.headless=true to JAVA_OPTS for Tomcat or JAVA_OPTIONS for Weblogic, or
  • Run xclock to see if $DISPLAY is running. If xclock runs successfully, the $DISPLAY environment variable value setting is correct; otherwise, set a valid $DISPLAY environment variable value.
  1. 16470085
Problem: Starting up the target of Tuxedo system or user server which requires additional environment variables from Enterprise Manager target homepage fails.
Platform: Generic
Workaround: Define the additional environment variables in the ENVFILE file of the server in UBBCONFIG file.
  1. 16096011
Problem: On some particular machines, if your $HOME directory does not exist or is not mounted correctly, uninstallation of Oracle TSAM Plus using GUI mode may not succeed.
Platform: Generic
Workaround: Make sure your $HOME directory has been mounted correctly before uninstalling the Oracle TSAM Plus
  1. 16075493
Problem: If Gnome or Twm desktop environment is used, the JVM used by TSAM Plus installer crashes.
Platform: Solaris SPARC
Workaround: Use CDE desktop environment instead.
  1. 15946355
Problem: Sometimes after uninstalling TSAM Plus agent, you cannot install TSAM Plus again.
Platform: Generic
Workaround: Remove the TSAM Plus directory manually if some files cannot be cleaned up after uninstallation.
  1. 15932182
Problem: When TSAM application is running under Tomcat and Windows 2008 Server, if you use IE 8.0 to browse TSAM application, the web page may be truncated when you click Detach to highlight a table and then click Detach again or press Esc to restore the table.
Platform: Windows 2008
Workaround: You can click the Browser Refresh button, or use IE 9.0 (or above) or Firefox instead.
  1. 14485664
Problem: You cannot monitor any ART JES metrics if the timezone of machines on which OMS and Oracle Database are running is different.
Platform: Generic
Workaround: Use the same timezone and synchronize the clock of machines on which OMS and database are running.
  1. 19147906
Problem: The Tomcat version embedded in TSAM Plus 12.1.1 installer has the following security vulnerabilities:
CVE-2013-4286
CVE-2013-4322
CVE-2013-4590
CVE-2014-0033
CVE-2014-0075
CVE-2014-0095
CVE-2014-0096
CVE-2014-0099
Platform: Generic
Workaround: After installing TSAM Plus 12.1.1, upgrade Tomcat version from 7.0.25 to 7.0.54 or later. For more information, see the Apache Tomcat official web site.
  1. 16801496
Problem: After Oracle TSAM plus RP010 is installed, policy and alert definitions can be set longer than 4KB from the Oracle TSAM plus console. However, if the Policy definition is longer than 8KB, Oracle Tuxedo servers can potentially core dump on HP-UX and IBM AIX platforms (due to an issue in API FML function Fboolco()/Fboolco32()).
Platform(s): IBM AIX and HP-UX
Workaround: When defining an Oracle TSAM plus policy and alert definition, avoid selecting excessive groups and servers that may lead to a policy length longer than 8KB. It is recommended that you do the following:
  • Try not to select "All", as the effect is nearly the same as selecting nothing at the machine/group/server level. Selecting "All" will likely cause a long policy length.
  • Split one policy into several policies when applying to a large number of groups and servers.

 


Oracle TSAM Plus Platform Support

Oracle TSAM Plus 12c Release 1 (12.1.1.1) supported platforms are listed in Appendix A: Oracle TSAM Plus 12c Release 1 (12.1.1.1) Supported Platforms in the Oracle TSAM Plus Installation Guide.

 


See Also


  Back to Top       Previous  Next