Getting Started with Oracle TSAM Plus Manager

This chapter contains the following topics:

•	Installing Oracle TSAM Plus

•	Deploying Oracle TSAM Plus Agent

•	Deploying Oracle TSAM Plus Manager

•	Viewing Your Oracle Tuxedo Configuration

•	Configuring Monitoring Policy

•	Starting to Monitor Oracle Tuxedo

Installing Oracle TSAM Plus

Install the Oracle TSAM Plus Agent and the Oracle TSAM Plus Manager. For more information, see Oracle TSAM Plus Installation Guide.

Deploying Oracle TSAM Plus Agent

To properly deploy the Oracle TSAM Plus Agent, you must add the LMS to each Oracle Tuxedo machine section of the UBBCONFIG file. Listing 1 shows an example of how to add the LMS to the UBBCONFIG file.

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

LMS can also be added to a running Oracle Tuxedo application using TMIB.

Deploying Oracle TSAM Plus Manager

The Oracle TSAM Plus Manager functions as a Web application in a Servlet/JSP container. It uses the DBMS (Database Management System) to store persistent Oracle Tuxedo performance and monitoring data. Before using Oracle TSAM Plus Manager, it must be deployed to a database server and a Web application container.

If you input the LDAP configuration file during installation, the LDAP deployment is done automatically; otherwise, you must do the LDAP deployment using the "LDAP Deployment Utility" if you want to enable the LDAP authentication.

If you select "Bundled Derby database", "An existing Derby database" or "An existing Oracle database" during installation, Oracle TSAM Plus Manager is deployed on the specified database server automatically; otherwise, you must deploy Oracle TSAM Plus Manager to a database server using the "Database Deployment Utility".

If you select "Bundled Tomcat server", "An existing Tomcat server" or "An existing WebLogic server" during installation, Oracle TSAM Plus Manager is deployed on the specified application server automatically; otherwise you must deploy Oracle TSAM Plus Manager to an application server using the "Application Server Deployment Utility" or manually.

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

Viewing Your Oracle Tuxedo Configuration

Login to the Oracle TSAM Plus Manager Console (for example: http://localhost:8080/tsam/faces).

Your Oracle Tuxedo configuration can be found in the Oracle Tuxedo component tree panel. For more information, see the Oracle TSAM Plus User Guide.

Configuring Monitoring Policy

Monitoring policy defines what and how you want to monitor. TSAM Plus Manager does not collect any metrics if no monitoring policy is defined.

•	Typical Monitoring Policy

Go to Policy > Monitoring Policy page, click Add to enter the Create Policy page. Input tsampolicy in the Name: input field.

•	Monitor call path initiated from a particular client

a.	In the left panel Tuxedo Component, select Domain in the drop down lists

b.	In the right panel Call Path tab, select Enable

c.	Select the Filter check box with Workstation Client

d.	Input a client name in the Client Name input box

e.	Click Add & Enable

•	Monitor services of a particular server

Similar steps as call path monitoring policy, except you must select options at the "Service" tab. In the "Filter", you can select service from a list or input it manually.

Other monitoring policy sets have similar steps. You can group several monitoring categories in one policy.

For more information, see Policy Management in Oracle TSAM Plus User Guide.

Starting to Monitor Oracle Tuxedo

Login to TSAM Plus Console, and start to monitor Tuxedo system and application.

For example:

Go to Metrics > Call Path to monitor call path.

Go to Metrics > Service to monitor service.

Go to Metrics > Domain Gateway to monitor GWTDOMAIN.

For more information, see Oracle TSAM Plus User Guide.