Table of Contents Previous Next PDF


Configuring Oracle TSAM Plus Agent

Configuring Oracle TSAM Plus Agent
This chapter contains the following topic:
Oracle TSAM Plus Agent Overview
The Oracle TSAM Plus Agent handles all Tuxedo-side back-end logic. It includes the following sub-components:
Standalone TSAM Plus Agent components working in conjunction with the Oracle TSAM Plus Manager:
Oracle TSAM Plus Framework: The framework is the data collection engine. It is an independent layer working between Tuxedo infrastructure and other TSAM Plus components. This module is responsible for run time metrics collection, alert evaluation and monitoring policy enforcement.
Oracle TSAM Plus Plug-in: An extensible mechanism invoked by the Oracle TSAM Plus Framework. The Oracle TSAM Plus Agent provides default plug-ins to send data to the LMS (Local Monitor Server), and then to the Oracle TSAM Plus Manager. The plug-in allows custom plug-in to be hooked to intercept the metrics. The default plug-in communicates with LMS with share memory. Application will not be blocked at metrics collection point.
You can develop your own plug-ins for additional data processing. A customized plug-in can be linked to an existing plug-in chain, or replace the default plug-in.
accrpt: An utility to analyze accounting and chargeback information generated by -a option in servopts(5).
JMX agent, which works in conjunction with the Enterprise Manager for Oracle Tuxedo to enable you to monitor and manage Oracle Tuxedo applications through the JMX interface and furthermore, through the Oracle Enterprise Manger cloud control 12c.
Configuring Standalone TSAM Plus Agent
Prerequisites
To effectively and correctly use the Oracle TSAM Plus Agent, note the following prerequisites:
Adding LMS to UBBCONFIG
Local Monitor Server (LMS) performs the following tasks:
For more information, see LMS in the Oracle TSAM Plus Reference Guide.
To properly deploy the Oracle TSAM Plus Agent, you must add the LMS to each Oracle Tuxedo machine section in the UBBCONFIG file. Listing 1‑1 shows an example.
Listing 1‑1 LMS Added to UBBCONFIG File
...
*MACHINES
MACHINEA
...
*GROUPS
...
LMSGRP LMID=MACHINEA
...
*SERVERS
LMS SRVGRP=LMSGRP SRVID=1 CLOPT=”-A -- -l tsamweb.abc.com:8080/tsam”
...
 
The “-l” option specifies the Oracle TSAM Plus Data Server address which is configured in the Oracle TSAM Plus Manager. For more information, see the Oracle TSAM Plus Reference Guide. The Oracle TSAM Plus Data Server uses the same port number as the Oracle TSAM Plus Manager Console.
Note:
Turning Oracle TSAM Plus On and Off
You can use a tmadmin command to turn on or turn off Oracle TSAM Plus. The command format is:
changemonitor (chmo) [-m machine] on|off
The -m parameter specifies the logic machine name where the Oracle TSAM Plus collection is disabled. Without this option, monitoring on all machines is disabled. By default, monitoring is turned on. If monitoring is turned off, all data collection is stopped even if there is a monitoring policy defined.
Configurations for Oracle Tuxedo ART for CICS and Batch Monitoring
To monitor Oracle Tuxedo Application Runtime for CICS, an additional configuration file (Region-Group.mapping)is required. You need to put the file in the directory specified by the KIXCONFIG environment variable. For more information, see Oracle Tuxedo Application Runtime for CICS Users Guide.
Note:
The KIXCONFIG environment variable is required for all ART applications.
Listing 1‑2 shows a Region-Group.mapping file format example.
Listing 1‑2 Region-Group.mapping File Format Example
[region]
name= REG1
tuxgroups=APPGRP1,APPGRP2
resources_group=resgroup1,resgroup2

[region]
name= REG2
tuxgroups=APPGRP3,APPGRP4
resources_group=resgroup3,resgroup4
 
Each region has a section in this file. The CICS region is called "name". The tuxgroups parameter is followed by the Oracle Tuxedo group name. The resources_group parameter is the CICS resource group in this region.
For more information, see Oracle Tuxedo Application Runtime for CICS Reference Guide.
Note:
If you need to monitor Oracle Tuxedo Application Runtime for Batch ARTJES component, set the JESMONITOR environment variable to yes before you start the LMS server.
Configurations for JES Security Mode
To integrate TSAM Plus with JES security mode, you need to configure the UBBCONFIG file and create TSAM configuration file for TuxJES (tsamconfig) and TSAM user mapping file.
Configuring UBBCONFIG
In the Tuxedo UBBCONFIG file, configure the following:
1.
2.
Add the option "-j <TSAM configuration file for TuxJES>" in LMS CLOPT.
Listing 1‑3 shows an example.
Listing 1‑3 UBBCONFIG File Example
ARTJESADM SRVGRP =ARTGRP SRVID = 1 MIN=1 MAX=1
CLOPT = "-A -- -i jesconfig"
ARTJESCONV SRVGRP =ARTGRP SRVID = 20 MIN=1 MAX=1
CLOPT = "-A --"
ARTJESINITIATOR SRVGRP =ARTGRP SRVID =30
CLOPT = "-A -- -n 20 -d"
ARTJESPURGE SRVGRP =ARTGRP SRVID = 100
CLOPT = "-A --"
AUTHSVR SRVGRP =ARTGRP SRVID = 200
CLOPT = "-A"
LMS SRVGRP=LMSGRP SRVID=101
CLOPT="-A -- -l bej301712.cn.oracle.com:8080/tsam -j tsamconfig"
 
TSAM Configuration File for TuxJES
Table 1‑1 lists the key words for the configuration file.
 
Listing 1‑4 shows an example of configuration file for TuxJES.
Listing 1‑4 Configuration File for TuxJES Example
JES_SYSLOG_SEND=1
TSAM_USER_MAPPING_FILE=/home/artbatch/simpjob/tsam_user_profile
 
TSAM User Mapping File
This file is used to map the TSAM Plus user to the Tuxedo user and corresponding JES profile.
The file format is:
<TSAM user> <Tuxedo user> <JES profile pathname>
Listing 1‑5 shows an example of TSAM user mapping file.
Listing 1‑5 TSAM User Mapping File Example
artbatch tpartbatch /home/artbatch/simpjob/tuxArtProfile
admin tproot /home/artbatch/simpjob/tuxRootProfile
 
Note:
Configuring JMX Agent
Starting the tlisten Process
Before you can use TSAM Plus to monitor the Tuxedo domain targets, you must start the tlisten process before starting the Tuxedo domain so that Tuxedo Domain MBeans can register with the JMX agent embedded in the tlisten process. For MP domains in particular, you should start tlisten for every machine.
Note:
It is also recommended you use the JRE shipped under TSAM Plus install directory.
Before starting tlisten, you must set the tlisten environment variable SHLIB_PATH/LIBPATH/LD_LIBRARY_PATH and include the libjvm library path. For windows platforms, you only need to set JAVA_HOME. For HP platforms, you need to set LD_PRELOAD to include the libjvm.so directory.
Listing 1‑6 shows examples of environment variable settings on different platforms:
Listing 1‑6 Environment Variable Setting on Different Platforms
For Linux 64-bit platforms:
LD_LIBRARY_PATH=$TUXDIR/lib:$JAVA_HOME/jre/lib/amd64/server:$LD_LIBRARY_PATH;
export LD_LIBRARY_PATH;
For AIX 64-bit platforms:
LIBPATH=$TUXDIR/lib:$JAVA_HOME/jre/lib/ppc64:${JAVA_HOME}/jre/lib/ppc64/default:$LIBPATH;
export LIBPATH;
For HP 64-bit platforms:
LD_LIBRARY_PATH=$TUXDIR/lib:$JAVA_HOME/jre/lib/IA64W/server:$LD_LIBRARY_PATH;
export LD_LIBRARY_PATH;
LD_PRELOAD=$JAVA_HOME/jre/lib/IA64W/server/libjvm.so;
export LD_PRELOAD;
 
Note:
LD_PRELOAD is only used for tlisten to start embedded JMX agent. It should not be set when building Tuxedo applications.
To start tlisten, use the following command:
tlisten -j rmi://<host>:<rmiport> -l //<host>:<tlistenport>
Note:
Make sure that the host and port specified by the -l option are the same as the NLSADDR value specified inthe UBBCONFIG file.
When the tlisten process is started correctly, you can view the message “RMI connector server successfully started and Started the embedded JMX agent successfully” in ULOG.
The following functions are added to the tlisten process:
tlisten acts as the Tuxedo-side monitoring and management agent . It receives monitoring and management requests from Enterprise Manager and dispatches these requests to corresponding Tuxedo services.
tlisten creates a Tuxedo context for each JMX connection. If a monitored Tuxedo domain enables authentication and authorization, tlisten provides the credentials attained from Enterprise Repository when it attaches a Tuxedo domain.
tlisten also forwards job requests from Enterprise Repository agent to MIB service. Enterprise Repository agent creates a new JMX connection for every job request, and releases the connection after the job finishes. Accordingly, tlisten creates a Tuxedo context for each job request.
For more information about additional tlisten options for JMX monitoring, see Oracle TSAM Plus Reference Guide.
Configuring the UBBCONFIG File
Adding the NETWORK Section
To monitor and manage the Tuxedo domain monitoring targets, you must register the targets in the tlisten process by adding the *NETWORK section and configuring the NLSADDR parameters inthe UBBCONFIG file for the Tuxedo domain in SHM mode.
Adding EXT_MON in the RESOUCES Section
Collection and calculation of certain metrics (such as Service Metrics and IPC Queue Metrics in MIB), consumes CPU time and potentially impacts Oracle Tuxedo performance. Oracle Tuxedo uses the EXT_MON OPTIONS parameter in the UBBCONFIG file *RESOURCES section to allow MIB performance sensitive metrics collection.
If the indicator is specified, all metrics listed in the Tuxedo Targets section are collected in MIB; otherwise, if the indicator is not specified, the following metrics are not collected by Oracle Tuxedo:
The metrics collection policy changes immediately once you modify this parameter setting.
Listing 1‑7 shows an SHM mode UBBCONFIG file example supporting Enterprise Manager monitoring.
Listing 1‑7 An SHM UBBCONFIG Sample Supporting Enterprise Manager Monitoring
*RESOURCES
IPCKEY 65831
DOMAINID shm
MASTER L1
MODEL SHM
MAXACCESSERS 100
MAXSERVERS 100
OPTIONS EXT_MON
*MACHINES
"<hostname>" LMID = L1
APPDIR = "/testarea/tux/test/jmx/servers"
TUXCONFIG = "/testarea/tux/test/jmx/servers/tuxconfig"
TUXDIR = "/testarea/tux/oracle/tuxedo12c"
*GROUPS
ATMIGRP1 LMID = L1
GRPNO = 10
*SERVERS
SvrUpdate SRVGRP = ATMIGRP1
SRVID = 100
*SERVICES
*NETWORK
"L1"
NLSADDR="<hostname>:16998"
 
Configuring BTM Observer
A new CLOPT option is introduced for GWTDOMAIN.
-m
The BTM monitor URL. The format is http://<HOST>:<PORT>/btmmonitor/agent/agent/.
Example:
GWTDOMAIN SRVGRP="gwgrp" SRVID=1003 CLOPT="-A -- -m http://bej301493.cn.oracle.com:9001/btmmonitor/agent/agent/"
When this option is specified, GWTDOMIAN starts an embedded JVM and runs a BTM delegate observer to monitor bidirectional calls between WTC and itself.

Copyright © 1994, 2017, Oracle and/or its affiliates. All rights reserved.