14-MIBS

5/20/2018 14-MIBS

1/38

2006 BEA Systems, Inc.

Accessing the Tuxedo ManagementInformation Bases (MIBS)At the end of this module, you will be able to:

Understand the BEA Tuxedo MIBs and the BEA

SNMP agent

Perform advanced monitoring tasks usingtuxconfigand ud32scripts

Use the AdminAPI to implement dynamicconfiguration updates to a Tuxedo application

Module 14

Accessing the Tuxedo Management Information Bases-1

5/20/2018 14-MIBS

2/38

2006 BEA Systems, Inc. 418

Road Map

1. SNMP and MIBs

The Simple Network Management Protocol (SNMP)

The BEA SNMP Agent

Understanding Management Information Bases (MIBs)

The BEA Tuxedo MIB

Overview of the Tuxedo TM_MIB

2. Using the Tuxedo AdminAPI


5/20/2018 14-MIBS

3/38


What Is SNMP?

SNMP (Simple Network Management Protocol) is amechanism originally devised to monitor and managenetworked devices:

Mostly hardware devices like printers, routers, bridges, etc.

SNMP has since been adapted to also manage systemsand software applications:

Tuxedo, CICS, Oracle, WebLogic, MQseries, and so on.

SNMP defines three basic commands

SET: sets an attribute to a value

GET: retrieves the value of an attribute

GETNEXT: same as GET but with cursors


5/20/2018 14-MIBS

4/38


Tuxedo & Enterprise Management

TLOG ULOGBulletin

Board

EVENTS

MIB APICommand-Line

Utilities

Administration

Console EventBroker

Enterprise Management

Console

SNMP

Browser

MIB

Most major Enterprise Management products supportTuxedo administration.


5/20/2018 14-MIBS

5/38


SNMP Management Consoles

SNMP management consoles provide a GUI thatprovides a visualization of the parameters of a system.

Commercial SNMP consoles include:

HP OpenView

Tivoli

BMC Patrol

BEA SNMP Agent provides:

MIB management through a command line interface.

Mapping between SNMP consoles and Tuxedo.


5/20/2018 14-MIBS

6/38 2006 BEA Systems, Inc. 422

The BEA SNMP Agent

The BEA SNMP Agent provides access to TuxedoMIBs from SNMP management consoles.

SNMPManagement

Console(OpenView, Tivoli, )

Tuxedo Domain

BBL

TuxedoMIB

/WS MIB

ACL MIB /Event MIB

/DomainMIB

/Q MIB

BEASNMP Agent

SNMP asn.1notation

Tuxedo FML32buffers


5/20/2018 14-MIBS


What Is a MIB?

A MIB (Management

Information Base) is acollection of attributes andvalue pairs associated with aclass or object.

A MIB classis used in abroad sense, as being anentity that has attributes.

In Tuxedo, internal MIBclasses are accessed andmodified using the TuxedoAdminAPI.

MyMIB

MyClass

Value4Attribute4 Value3Attribute3

Value2Attribute2Value1Attribute1ValuesAttributes


5/20/2018 14-MIBS


BEA Tuxedo MIBs

A collection of MIBs provide access to Tuxedo system

parameters.

Each system component has its own MIB.

Tuxedo provides these six MIBs:

Security Access Control ListACLs (ACL)

Workstation Clients

Machines, Groups, Servers, Services, MsgQueuesTuxedo (TM)

/WS (WS)

Event Broker SubsystemEvents(EVENT)

Domain GatewaysDomain (DM)/Q Subsystem/Q (APPQ)

ProvidesManagement of:Available MIBs


5/20/2018 14-MIBS


TM_MIB Classes

TM_MIBis the primary MIBfor the core Tuxedo system.

TM_MIBclasses defineproperties accessible by anattribute name, for example:

T_GROUP>TA_GRPNO

We will cover only a few ofthese classes and properties

in this module. Refer to the TM_MIB

documentation (section 5) formore details

TM_MIB

...

T_GROUP Class

SITE1TA_LMID1TA_GRPNO

APPGRP1TA_SRVGRPValuesAttributes

T_SERVER Class

ACTIVETA_STATE

117TA_SRVIDAPPGRP1TA_SRVGRP

ValuesAttributes


5/20/2018 14-MIBS


TM_MIBDocumentation

We will focus on the TM_MIBclasses since they

contain the most commonly accessed attributes.

The next few slides provide an example of MIB classtable information, however we encourage you to:

Follow along with the actual documentation.

Navigate to Reference>Section 5>TM_MIB(5)


5/20/2018 14-MIBS


T_MACHINEClass Definition

The T_MACHINEclass represents applicationattributes pertaining to a particular server machine:

TLOG

Default

Complete network address used by the tlisten process

Complete network address used by the Bridge process

Name of the transaction log for this machine

Device or system file holding transaction log

Environment file for clients and servers

Absolute path to location of application files

Absolute path to location of Tuxedo home directory

Absolute path totuxconfigfile

Logical machine identifier

Description

string[256]

string[256]

string[30]

string[256]

string[256]

GET :"ACT|INA|MIG|CLE|RES|SUS|PAR|DEA"SET:"NEW|INV|ACT|INA|DEA"

string[256]

string[256]

string[256]

string[30]

Values

TA_NLSADDR

TA_NADDR

TA_TLOGNAME

TA_TLOGDEVICE

TA_ENVFILE

TA_LMID

TA_TUXCONFIG

TA_STATE

TA_APPDIR

TA_TUXDIR

Attribute


5/20/2018 14-MIBS


T_GROUPClass Definition

Primary andsecondary machines

Current LMIDon where group is running

Default

3

TMS executable associated with this group

Numberof transaction manager servers

Information for initiating access to RM

Informationfor terminating access to RM

Environmentfile for servers in group

Uniquegroup number

Logicalname of the server group

Description

string[256]

long: 2..10

string[256]

string[256]

string[256]

string[30]

GET:"ACT|INA|MIG"SET:"NEW|INV|ACT|RAC|INA|MIG"

LMID1[,LMID2]

long: 1..30,000

string[30]

Values

TA_TMSNAME

TA_TMSCOUNT

TA_OPENINFO

TA_CLOSEINFO

TA_ENVFILE

TA_SRVGRP

TA_GRPNO

TA_CURLIMD

TA_STATE

TA_LMID

Attribute

The T_GROUPclass represents application attributespertaining to a particular server group:


5/20/2018 14-MIBS


T_SERVERClass Definition

Default

N

1

86,400

-A

Allow for automatic restart by BBL

Min and maxnumber of server processes

Number of seconds used for MAXGENperiod

Environment file used by this server

Command line options and parameters

Group numberof this servers group

Executablename of this server

Unique server ID

Group name of this servers group

Description

{Y|N}

0..1000

0..

string[78]

string[256]

GET :"ACT|INA|MIG|CLE|RES|SUS|PAR|DEA"SET :"NEW|INV|ACT|INA|DEA"

1..30,000

string[78]

1..30,001

string[30]

Values

TA_RESTART

TA_MIN, TA_MAX

TA_GRACE

TA_ENVFILE

TA_CLOPT

TA_SRVGRP

TA_SRVID

TA_STATE

TA_GRPNO

TA_SERVERNAME

Attribute

The T_SERVERclass represents configuration andrun-time attributes of servers in the domain:


5/20/2018 14-MIBS


T_SERVICEClass Definition

30

0

50

Name of service as advertisedstring[15]TA_SERVICENAME

DDR-basedrouting criteria in ROUTING

Secondsuntil transaction timeout

string[15]TA_ROUTINGNAME

Load factorimposed by this service

50

Default

Secondsallowed to process requests

Dequeuingpriority for this service

Should transactionsbe started automatically

Overridesdomain BLOCKTIMEif set

Description

0..long

0..long

1..100

1..32,767

{Y|N}

GET: ACT|INA

SET: NEW|INV

1..32,767

Values

TA_TRANTIME

TA_SVCTIMEOUT

TA_PRIO

TA_BLOCKTIME

TA_LOAD

TA_AUTOTRAN

TA_STATE

Attribute

The T_SERVICEclass represents configurationattributes of services within the domain:


5/20/2018 14-MIBS


T_MSGClass Definition

Logical machine identifierstring[30]TA_LMID

Time since the last write to this queue

PID of the last process to write to this queue

PID of the last process to read from this queue

Time since the last read from this queue

The number of bytes currently on the queue

The number of messages currently on the queue

Description

long: 1..num Maximum number of bytes allowed on the queue

long: 1..num

long: 1..num

long: 1..num

long: 1..num

long: 1..num

long: 1..num

Values

TA_MSG_QNUM

TA_MSG_LSPID

TA_MSG_LRPID

TA_MSG_QNUM

TA_MSG_STIME

TA_MSG_RTIME

TA_MSG_CBYTES

Attribute

The T_MSGclass represents run-time attributes of theIPC message queues currently active:


5/20/2018 14-MIBS


Section Review

Understand the use of the BEA SNMP Agent

Identify the six Tuxedo MIBs

Examine the TM_MIB documentation

Review example TM_MIB class attributes

In this section, we learned how to:


5/20/2018 14-MIBS


Road Map

1. SNMP and MIBs2. Using the Tuxedo AdminAPI

Setting Up and Executing the tmconfigUtility

Understanding Common MIB Error Messages

Setting Up and Executing the ud32Utility

Example Dynamic Configuration Changes


5/20/2018 14-MIBS


Using the AdminAPI

FML32 dataATMI

tpcall(".TMIB", InBuf, , OutBuf, );

BBL

BB

Admin

Client

tuxconfig

name/valuepairs

.TMIB

Admin Clients:

tmadmindmadmintmconfig

ud32AdminConsolecustom apps


5/20/2018 14-MIBS


Using AdminAPI Utility Clients

Two common utilities are available to administrators

for dynamic configuration and advanced monitoringtasks: tmconfig- Command-line interactive native client

ud32Native client accepting a text file for input

All dynamic updates directly modify tuxconfig: To include the tuxconfigbinary files on all nodes in the

application that are currently booted.

As new machines are booted, the new tuxconfigfile isautomatically propagated.

Both utilities follow a similar usage pattern based onthe Tuxedo TM_MIBclasses. There is also a similar configsubcommand within thedmadminutility used to access the DM_MIBclasses.


5/20/2018 14-MIBS


Setting Up tmconfig

Updates need Tuxedo administrator privileges.

Non-administrators have read-only access.

Setup environment variables: TUXCONFIG: pointing to the name and location of the

binary version of the configuration file. TUXDIR: pointing to installation directory of Tuxedo.

EDITOR(optional): points to your favorite text editor.Well use our SciTE Editor!

There is also a workstation client version oftmconfigavailable calledwtmconfig. Requires setting up a WSL.


5/20/2018 14-MIBS


Running tmconfig

Thetmconfigutility can be executed:

Separately from the command line. From within tmadmin.

The main menu offers options to chose the tmconfigsection you want to monitor or modify.

The sections correspond to sections of a UBBCONFIGfile.

Example of invoking tmconfig:

C:\> tmconfigSection: 1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS5)SERVICES 6) NETWORK 7) ROUTING q) QUIT 9) WSL

10) NETGROUPS 11) NETMAPS 12) INTERFACES [1]:

Example use of configsub-command of tmadmin:

> configSection: 1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS5)SERVICES 6) NETWORK 7) ROUTING q) QUIT 9) WSL10) NETGROUPS 11) NETMAPS 12) INTERFACES [1]:


5/20/2018 14-MIBS


tmconfigOperations

Example of Choosing an Operation of a Configuration Section:Operation: 1) FIRST 2) NEXT 3) RETRIEVE 4) ADD 5) UPDATE

6) CLEAR BUFFER 7) QUIT [1]:

Clears the input buffer (all fields are deleted).CLEARBUFFER

Retrieves the first record from specified sectionFIRST

Retrievesthe next record based on the current key fieldNEXT

ExitstmconfiggracefullyQUIT

Dynamicallyupdates the record specified in the inputbuffer in the selected section.

UPDATEDynamicallyadds a new class entity to this section.ADD

Retrievesthe record by a key fieldRETRIEVE

DescriptionOperation

For any section chosen, a menu of operations are

provided:


5/20/2018 14-MIBS

23/38


Example of displaying parameters for theMACHINESsection:

C:\> tmconfig

Displaying Machine Parameters

Section: 1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS

5)SERVICES 6) NETWORK 7) ROUTING q) QUIT 9) WSL

10) NETGROUPS 11) NETMAPS 12) INTERFACES [1]: 2

Operation: 1) FIRST 2) NEXT 3) RETRIEVE 4) ADD 5) UPDATE

6) CLEAR BUFFER 7) QUIT [1]: 1

Enter editor to add/modify fields [n]?

Perform operation [y]?Return value TAOK

Buffer contents:

TA_OPERATION 4

TA_SECTION 1

...

TA_TLOGOFFSET 0

TA_TUXOFFSET 0

TA_STATUS LIBTUX_CAT:1137: Operation completed successfullyTA_PMID student14

TA_LMID SITE1

TA_TUXCONFIG /home/apps/bank/tuxconfig

TA_TUXDIR /home/tuxroot

TA_APPDIR /home/apps/bank

...

Choose MACHINES section

Choose first entryof MACHINES section

These are theparameters for thefirst machine.

If this is the first

call, there are no

fields in the editor.

Just display the contents


5/20/2018 14-MIBS

24/38


Messages and Status

After an operation is executed, a message is printed and

the TA_STATUSfield is updated.

Problems withpermissions orconfiguration parameters

Operation successful andupdate performed

Operation successful butno update performed

Meaning

Operation completedsuccessfully.

Return valueTAOK

Update completedsuccessfully.

Return valueTAUPDATED

See next slideError message(see next slide)

TA_STATUSMessage


5/20/2018 14-MIBS

25/38


Error Messages

The error status and error message is displayed to the

screen.

No more spacein tuxconfig and/or bulletin boardTAENOSPACE

Update not allowedTAEUPDATE

Field value fora string is too longTAESIZE

A field value is requiredbut is not presentTAEREQUIREDRecord specified was not foundTAENOTFOUND

Attempted to add a duplicate recordTAEDUPLICATE

A field value is inconsistently specifiedTAEINCONSIS

UPDATE or ADD used by non administratorTAEPERM

A system error occurred and logged in userlogTAESYSTEM

Error while reading TUXCONFIGTAECONFIG

A field value is either out of range or invalidTAERANGEA blocking timeout occurredTAETIME

An OS error occurred an logged in userlogTAEOS

DescriptionOperation


5/20/2018 14-MIBS

26/38


Example of Adding a new Machine:

C:\> tmconfig

Adding a New Machine

Section: 1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS




6) CLEAR BUFFER 7) QUIT [1]: 4

Enter editor to add/modify fields [n]? y

TA_LMID SITE3

TA_TUXDIR SPARC

TA_PMID student12

q

Perform operation [y]?

Return value TAUPDATEDBuffer contents:

...

TA_STATUS LIBTUX_CAT:1136: Update completed successfully

ChooseMACHINES section

Choose toADDan entry

Enter the editor

We need to define these classattributes and values

Perform the operation

tmconfigdisplaysparameters for themachine we just added


5/20/2018 14-MIBS

27/38


Adding a New Group

Example of adding a new group:C:\> tmconfig

Section: 1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS5)SERVICES 6) NETWORK 7) ROUTING q) QUIT 9) WSL



6) CLEAR BUFFER 7) QUIT [1]: 4Enter editor to add/modify fields [n]? y

TA_LMID SITE3

TA_SRVGRP GROUP3TA_GRPNO 3

q


Return value TAUPDATED

Buffer contents:

...

TA_GRPNO 3

TA_TMSCOUNT 0


TA_LMID SITE3

TA_SRVGRP GROUP3

TA_TMSNAME

TA_OPENINFO

TA_CLOSEINFO

Choose GROUPS section


tmconfigdisplaysparameters for thegroup we just added


Enter the editor



5/20/2018 14-MIBS

28/38


Adding a New Server

Example of adding a new server:

C:\> tmconfigSection: 1) RESOURCES, 2) MACHINES, 3) GROUPS 4) SERVERS




6) CLEAR BUFFER 7) QUIT [1]: 4Enter editor to add/modify fields [n]? y

TA_SERVERNAME XFERTA_SRVGRP BANKB1

TA_SRVID 5

q


Return value TAUPDATED

Buffer contents:

...

TA_SRVID 5...


...

TA_SRVGRP BANKB1

TA_SERVERNAME XFER

...

Choose SERVERS section


tmconfigdisplaysparameters for theserver we just added



Enter the editor


5/20/2018 14-MIBS

29/38


The Complete MIB Request

An FML32buffer is the data structure used to set and

retrieve MIB class information.

FML32buffer fields allow SNMP-style SET, GET, andGETNEXTcommands. Using the ud32utility will require these additional attributes.

FML32 fields to GET information for class T_SERVER:TA_OPERATION GETTA_CLASS T_SERVERTA_SRVID 12

R

R

SET

R

R

GET

R

R

GETNEXT

string

stringTA_OPERATION

TA_CLASS

TypeField

(other fields dependent on theMIB class)


5/20/2018 14-MIBS

30/38


The ud32Utility

The ud32utility allows administrators to create scripts

that can be used to execute MIB commands.

ud32reads its input from a text file, creates an FML32buffer and sends it to the BBL.

The response is displayed to the screen, or can be redirectedto another file.

Example content of input_file.txt:SRVCNM .TMIBTA_CLASS T_GROUP

TA_OPERATION GETTA_STATE ACTIVETA_SRVGRP GROUP1

Executing ud32from the command line:c:\> ud32 < input_file.txt > output_file.txt

There is also the

Workstation client

version:wud32


5/20/2018 14-MIBS

31/38


ud32as an Administration Client

The ud32utility needs access to the FML32field table

definitions in the $TUXDIR/udataobjdirectory. These can be set using the machines ENVFILE.

The ud32client executes as a general-purposeapplication; therefore, SET-ting TM_MIBfieldsrequires tpsysadmprivileges.

100101

1110

FML32settings for the ud32client in a Windows ENVFILE:

FIELDTBLS32=Usysfl32,tpadm

FLDTBLDIR32=C:\bea\tuxedo9.0\udataobj

Example of executing ud32with tpsysadmprivileges:

C:\> ud32 C tpsysadm < setAttributes.txtSENT pkt(1) is:SRVCNM .TMIBTA_CLASS T_SERVER. . .


5/20/2018 14-MIBS

32/38


Example of Adding a Machine

Current configuration:

*RESOURCES...MODEL MPOPTIONS LAN...

*MACHINESMACHINE1...

MACHINE2...

We can add a new machine as follows:

SRVCNM .TMIBTA_OPERATION SETTA_CLASS T_MACHINETA_PMID MACHINE3TA_LMID SITE3

TA_TUXDIR C:\bea\tuxedo9.0TA_APPDIR C:\myappdirTA_TUXCONFIG C:\myappdir\tuxconfigTA_NADDR //mach3:9001TA_NLSADDR //mach3:3050TA_STATE NEW

We call the .TMIBservice with ud32as follows:

c:\> ud32 C tpsysadm < addMachine3.ud

UBBCONFIG addMachine3.ud

exactly 1 tab

exactly 1 blank line


5/20/2018 14-MIBS

33/38


Example of Adding a Group

Current configuration:

*MACHINES...

MACHINE3LMID=SITE3...

*GROUPSGroup1GRPNO=1LMID=SITE1

...

We can add a new group as follows:

SRVCNM .TMIBTA_OPERATION SETTA_CLASS T_GROUPTA_SRVGRP Group3

TA_GRPNO 3TA_LMID SITE3TA_STATE NEW


c:\> ud32 C tpsysadm < addNewGroup.ud

addNewGroup.udUBBCONFIG


exactly 1 tab


5/20/2018 14-MIBS

34/38


Example of Adding a Server Process

Current configuration:...*GROUPS...Group3GRPNO=3LMID=SITE3

...*SERVERS...MyServer1 ...MyServer2 ......

We can add a new server as follows:

SRVCNM .TMIBTA_OPERATION SETTA_CLASS T_SERVERTA_SERVERNAME MyServer3TA_SRVGRP Group3TA_SRVID 50TA_MIN 3TA_STATE NEW


c:\> ud32 C tpsysadm < addNewServer.ud

UBBCONFIG addNewServer.ud

exactly 1 tab



5/20/2018 14-MIBS

35/38


Example of Changing Routing Criteria

The current routing info:*SERVICESDEPOSIT"ROUTING=BranchID

*ROUTINGBranchIDBUFFTYPE=FML32FIELD=BranchRANGES=1-6:Group1;7-12:Group2

We can change routing criteriaas follows:

SRVCNM .TMIBTA_OPERATION SETTA_CLASS T_ROUTING

TA_ROUTINGNAME BranchIDTA_RANGES 1-4:Group1;5-8:Group2;9-12:Group3


c:\> ud32 C tpsysadm < changeRoutingCriteria.ud

UBBCONFIG changeRoutingCriteria.ud

exactly 1 tab



5/20/2018 14-MIBS

36/38


Section Review

Set up and execute the tmconfigutility.

Set up and execute the ud32utility.

Use the AdminAPI for advanced monitoring tasks anddynamic configuration modifications.

In this section, we learned how to:


5/20/2018 14-MIBS

37/38


Lab Exercise

For details on the exercise, refer to the Lab Guide.

If questions arise, ask the instructor. The instructor will determine the stop time.

Lab 15 MIBS: Access the Tuxedo MIBSUsing the tmconfigand ud32Utilities


5/20/2018 14-MIBS

38/38

Module Review

Leverage the Tuxedo MIB classes for advancedmonitoring tasks and dynamic configuration changes

Manage Tuxedo applications with external SNMP

consoles

Review MIB documentation for more detailedTuxedo internal functionality

In this module, we learned how to:

14-MIBS

Documents

bea systems

tuxedo applicationmodule

tuxedo adminapiaccessing

tuxedo systemparameters

bea tuxedo mib overview

commercial snmp consoles

mib classis

mib managementinformation