The Agent Connection facilitates TUXEDO and M3 system management from any SNMP-compliant management platform. Integrating the Agent Connection into your management system requires set-up tasks on both the managed node and on the management system. This chapter describes the procedure for setting up the Agent Connection on the managed node. Integration into the management system is described in Chapter 3, "Integrating Agent Connection with a Management System."
Preparing the Agent Connection for TUXEDO or M3 system management requires the following steps on Windows NT systems:
Setting Up the Agent Connection
Agent Connection can be installed on a managed node from the BEA Manager CD. The BEA Manager CD contains an installation script for installing the agents on UNIX systems and an installation program for installing the agents on Windows NT machines. For detailed information about how to install the Agent Connection, refer to the BEA Manager Installation Guide.
Some attributes of TUXEDO resources are accessible globally (that is, no matter which TUXEDO node they are on) while others are accessible only by an SNMP agent local to the same machine. If you want to access managed objects that are only accessible locally, you must install TUXEDO SNMP agents on each machine where these resources reside. See "Local and Global TUXEDO Information" for more information.
Both the M3 version of the agent (m3_snmpd) and the TUXEDO version (tux_snmpd) are installed when you install Agent Connection.
If the Agent Connection was not installed in the same directory as the TUXEDO or M3 application, you need to make sure that the bin directory of the appropriate TUXEDO or M3 installation is prior to any other TUXEDO or M3 installations in the PATH system environment variable. This is to ensure that the Agent Connection has access to the correct TUXEDO or M3 DLLs.
LD_LIBRARY_PATH (SHLIB_PATH on HP-UX or LIBPATH on AIX)
$TUXDIR/lib.
Copy the BEA Manager configuration file (beamgr.conf):
md c:\etc
copy installation-directory\etc\beamgr.conf c:\etc
Log in as root and copy the BEA Manager configuration file beamgr.conf from installation_directory/etc to the /etc directory.
%su
Password:
# cp installation_directory/etc/beamgr.conf /etc
All users of the installed BEA Manager products will need to update their PATH environment variable to include the location of the BEA Manager executable files. The following is an example in C shell:
% set path = ( $PATH
installation_directory/bin )
If you are using TUXEDO 6.3 or later, or M3, you need to configure the timeout of your SMUX master, if any (e.g., snmp_integrator), and of your SNMP manager, to at least 30 seconds. For snmp_integrator, this can be done by adding a INTEGRATOR_TIMEOUT entry to the BEA Manager configuration file (beamgr.conf) as follows:
INTEGRATOR_TIMEOUT 30
When Agent Connection is installed on a Windows NT system, make sure that the host name specified in the TCP/IP Properties window, under DNS (Control Panel'Network'Protocols'TCP/IP'Properties'DNS) is the same as specified in the Computer Name field on the Network window, under Identification (Control Panel'Network'Identification). The name should be in all uppercase in both places.
The default destination for SNMP trap notifications is Typically the destination will be the host machine where the SNMP management system is located. Some management systems use distributed trap daemons that "collect" SNMP trap notifications for forwarding to management stations. In that case, the machine with the trap daemon would be the destination.
For more information refer to the "Configuration Files" chapter in the Agent Integrator Reference Manual.
localhost. If you want traps to be sent to some other destination, use your favorite text editor to modify the BEA Manager configuration file (beamgr.conf) TRAP_HOST entry to specify the host name of the target destination machine for SNMP trap notifications, and the port number and community name to use in sending traps.
For more information refer to the "Configuration Files" chapter in the Agent Integrator Reference Manual.
TMAGENT
logical_agent_name tuxdir tuxconfig_path
The TUXEDO Agent Connection will not receive TUXEDO event notifications unless the TUXEDO Event Broker servers (TMSYSEVT and TMUSREVT) are running. To enable forwarding of TUXEDO events as SNMP traps, ensure that the TUXEDO Event Broker servers are running. Information on the TUXEDO Event Broker can be found in the "Programmed Administration" chapter of the BEA TUXEDO Administrator's Guide and in Section 5 of the BEA TUXEDO Reference Manual.
The steps for integrating Agent Connection into your management system are described in the next chapter, Chapter 3, "Integrating Agent Connection with a Management System."
Now you can start the SNMP agents on the managed nodes where your TUXEDO or M3 resources are present. Refer to "Starting and Stopping the SNMP Agents."
There are additional steps that you may want to take to customize Agent Connection to your needs, such as monitoring multiple TUXEDO domains concurrently or using nondefault ports for communication with the system manager. The following lists a number of optional configuration steps:
To monitor multiple TUXEDO domains at the same time, add a TMAGENT entry to the BEA Manager configuration file for each agent. The TMAGENT entry is of the following form:
Monitoring of multiple domains is done by running a separate TUXEDO or M3 agent for each domain being monitored. These agents must be run as subagents under the Agent Integrator.
When multiple agents are running on the same node, then SNMP manager SET or GET requests to an agent must be addressed using a community of the form:
If only one agent is running on a node, TMAGENT
logical_agent_name tuxdir tuxconfig_pathcommunity@logical_agent_name
logical_agent_name identifies the agent to which the SNMP request is forwarded. For example:
public@simpapp_agent
logical_agent_name is optional in specifying the community in GET or SET requests.
TUXEDO event filters can define a subset of TUXEDO events to be received by the agent for each domain being monitored. You can use TMEVENT_FILTER entries in the BEA Manager configuration file to define a subset of TUXEDO event notifications that are to be forwarded as SNMP trap notifications. For more information refer to the "Configuration Files" chapter in the Agent Integrator Reference Manual. MIB objects corresponding to TUXEDO event filters are described in Chapter 4, "TUXEDO Core MIB."
beamgr_snmpd.conf) to c:\etc. For
example, on Windows NT issue the following command:
copy installation-directory\etc\beamgr_snmpd.conf c:\etc
DISABLE_SET YES
If there is no DISABLE_SET entry in the passwords file, the agent has both SET and GET capability.
For more information refer to the "Configuration Files" chapter in the Agent Integrator Reference Manual.
The environment variable BEA_SMUX_PASSWD specifies the password that the SNMP agents (tux_snmpd or m3_snmpd) use when registering with a SMUX master agent (such as Agent Integrator). This environment variable is required only if the SMUX master agent expects a password. If this environment variable is not set, no password is specified by tux_snmpd or m3_snmpd when registering.
By default, BEA Manager agents assume the following port numbers as specified by SNMP and SMUX standards:
The default port assignments may be sufficient for your needs. If necessary, you can define these services on other ports, or use the appropriate command-line options when starting BEA Manager agents to assign them to nondefault ports.
snmp 161/udp
snmp-trap 162/udp
smux 199/tcp
To modify or define the services, add the appropriate lines in the NT-root-directory\system32\drivers\etc\services file. You may wish to consult your system administrator.
To modify or define the services, do the following:
ypwhich command to
determine if an NIS server or map master is available. For example:
% ypwhich
zort.kremvax.comypcat command to determine
if the services are available.
% ypcat services | grep snmp
snmp-trap 162/udp snmptrap
snmp 161/udp/etc/services file instead.
% cat /etc/services | grep snmp
snmp-trap 162/udp snmptrap
snmp 161/udp
Refer to your UNIX system documentation, or consult your UNIX system administrator, for instructions specific to your UNIX platform to establish the SNMP services if necessary.
To enable management access to the TUXEDO or M3 resources represented in the BEA MIBs, you need to start the TUXEDO or M3 SNMP agents.
To monitor multiple TUXEDO or M3 domains, you can run multiple SNMP agents on the same node. Each agent can monitor only one domain. To monitor multiple domains, you must have the BEA Manager Agent Integrator running and the agents must be started as subagents.
On startup, a TUXEDO or M3 SNMP agent checks for a TMAGENT entry in the BEA Manager configuration file that matches its logical agent name. A TMAGENT entry provides a path to the TUXEDO or M3 domain to be monitored. If no matching TMAGENT entry is found, the agent connects to the TUXEDO domain specified in the TUXCONFIG and TUXDIR environment variables. The agent exits if the TUXCONFIG or TUXDIR environment variable is not defined and no appropriate TMAGENT entry is found in the BEA Manager configuration file. For more information refer to the "Configuration Files" chapter in the Agent Integrator Reference Manual.
To start the SNMP agents on a UNIX system, type the TUXEDO or M3 SNMP startup command at the command-line prompt.
For the TUXEDO SNMP agent, the syntax of the startup command is:
tux_snmpd [-llogical_agent_name][-d] [-n] [-s] [-psnmp_port]
[-rsmux_port] [-mhostname] [-h]
For the M3 SNMP agent, the syntax of the startup command is:
m3_snmpd [-llogical_agent_name][-d] [-n] [-s] [-psnmp_port]
[-rsmux_port] [-mhostname] [-h]
The command options have the following interpretation:
-l logical_agent_name
-l option is not specified, the name of the executable is used as the logical agent name.
logical_agent_name is a string that associates an agent with a TUXEDO domain as defined by a TMAGENT entry in the BEA Manager configuration file (beamgr.conf). The logical agent name can be a maximum of 32 characters in length. The format of the TMAGENT entry is as follows:
TMAGENT logical_agent_name tuxdir tuxconfig
logical_agent_name to the indicated TUXEDO domain. Refer to the "Configuration Files" chapter in the Agent Integrator Reference Manual.
-d
-n
tux_snmpd (or m3snmpd) is to be started by init using the inittab table with the respawn option.
-s
tux_snmpd or m3_snmpd to run as an SNMP agent. If this option is not specified, tux_snmpd or m3_snmpd runs as a SMUX subagent.
-p snmp_port
snmp_port designates the UDP port on which tux_snmpd or m3_snmpd listens for incoming SNMP packets. This option allows running the tux_snmpd or m3_snmpd on a port other than the standard SNMP port 161. This option is meaningful only when tux_snmpd or m3_snmpd is running as an SNMP agent.
-r smux_port
tux_snmpd or m3_snmpd is running as a SMUX subagent.
-m hostname
hostname is the name of the machine where the SMUX master agent (such as the Agent Integrator) is running. This option is used only when you want tux_snmpd or m3_snmpd to register with a SMUX master agent on a remote machine.
-h
tux_snmpd command.
The tux_snmpd binary is the TUXEDO SNMP agent which supports the TUXEDO MIB. For a description of the supported MIB groups and objects, please refer to chapters 4 through 11 in this manual.
The m3_snmpd binary is the M3 SNMP agent which supports the TUXEDO MIB with M3 extensions. For a description of the supported M3-specific MIB groups and objects, refer to Chapter 6, "M3 MIB Groups."
This agent is capable of running as an SNMP agent or as an SMUX subagent.
When the tux_snmpd or m3_snmpd starts up as an SNMP agent, it generates a coldStart trap. The destination host, port, and community used when sending traps are as specified in the TRAP_HOST entry in the BEA Manager configuration file (beamgr.conf).
SNMP read-write and read-only communities supported by the tux_snmpd or m3_snmpd can be specified in the BEA Manager passwords file (beamgr_snmpd.conf). By default, the read-only community is public and the read-write community is iview. Community is meaningful only when the agent is running as an SNMP agent.
When running as an SMUX subagent, tux_snmpd or m3_snmpd specifies a password to the SMUX master agent at the time of registration if the environment variable BEA_SMUX_PASSWD has been defined. In that case, the value of BEA_SMUX_PASSWD is used as the password by tux_snmpd or m3_snmpd. If BEA_SMUX_PASSWD has not been defined, tux_snmpd or m3_snmpd does not specify a password to the master agent when registering.
tux_snmpd and m3_snmpd support the MIB-II snmp group when running as an SNMP agent.
Like other TUXEDO clients, tux_snmpd needs access to the TUXEDO shared libraries. For M3 environments, m3_snmpd needs access to the M3 shared libraries. For UNIX platforms, the user should make sure that the environment variable LD_LIBRARY_PATH is defined appropriately. (For HP-UX users, the variable name is SHLIB_PATH. For AIX users, the variable name is LIBPATH.)
To start SNMP agents on a Windows NT system, do the following:
The installation program for Windows NT installs the SNMP agent as a single Windows NT service. If you want to run multiple instances of the agent to monitor multiple M3 or TUXEDO domains, you will need to install additional Windows NT services for the additional agents. Run the following commands for each additional TUXEDO SNMP agent:
Alternatively, run the following commands for each additional M3 SNMP agent:
Separate logical agent names must be assigned if you want to run multiple instances of the agent on the same node. To use multiple agents to monitor multiple TUXEDO or M3 domains, This entry assigns the agent started with instsrv
logical_agent_name\bin\tux_snmpd.exe
install_directoryinstsrv
logical_agent_name\bin\m3_snmpd.exe
install_directorylogical_agent_name is a string that associates an agent with a TUXEDO domain as defined by a TMAGENT entry in the BEA Manager configuration file (beamgr.conf). The format of the TMAGENT entry is as follows:
TMAGENT logical_agent_name tuxdir tuxconfiglogical_agent_name to the indicated TUXEDO or M3 domain. Refer to the "Configuration Files" chapter in the Agent Integrator Reference Manual.
On the Windows taskbar, choose Start'Settings'Control Panel. In the Control Panel window, double-click on the Services applet (as shown in Figure 2-1).
In the list of Services, locate and select the installed service (
Figure 2-1 Selecting Services from the Control Panel
tux_snmpd or m3_snmpd) and click Start to start it (as shown in Figure 2-2. There may be a short delay as the service is initiated.
Figure 2-2 Starting a Service from the Services Applet
-d
-s
tux_snmpd or m3_snmpd to run as an SNMP agent. If this option is not specified, tux_snmpd or m3_snmpd runs as a SMUX subagent. If a SMUX master agent (e.g., snmp_integrator) is not running, the user must provide -s as a start-up parameter before selecting the Start button.
-p snmp_port
snmp_port designates the UDP port on which tux_snmpd or m3_snmpd listens for incoming SNMP packets. This option allows running the tux_snmpd or m3_snmpd on a port other than the standard SNMP port 161. This option is meaningful only when tux_snmpd or m3_snmpd is running as an SNMP agent.
-r smux_port
tux_snmpd or m3_snmpd is running as a SMUX subagent.
-m hostname
hostname is the name of the machine where the SMUX master agent (such as the Agent Integrator) is running. This option is used only when you want tux_snmpd or m3_snmpd to register with a SMUX master agent on a remote machine.
The following command is used to stop one or more BEA Manager agents:
stop_agentlogical_agent_name|all[logical_agent_name]
For example,
stop_agent tux_snmpd
If you specify all, all BEA Manager agents (including any agents built using the BEA Manager Agent Development Kit) will be stopped. The name of the executable is the default logical agent name.
The TUXEDO SNMP agent may be installed on both TUXEDO master and non-master nodes. If the TUXEDO application is down on the non-master node, SNMP GET requests addressed to the SNMP agent on the non-master node may not have the latest information. This would be the case, for example, if the requested information has been updated on a master node after the application on the non-master node went down.
Also, SET requests to a non-master node are not allowed if the TUXEDO application is down on the local node.
Some MIB groups in the TUXEDO MIB return values for all TUXEDO nodes whereas other MIB groups return data only for the local node. Thus, if you want to manage objects whose values are local to a particular machine, you must install a copy of the TUXEDO SNMP agent on that machine.
The following MIB groups or tables return only values local to the managed node:
tuxTwshTbl - This table represents runtime attributes of workstation handler (WSH) client processes.
tuxTqueueTable - This table represents runtime attributes of queues in an application.
tuxTAppQTbl - This table represents attributes of application queues.
tuxTAppQmsgTbl - This table represents attributes of messages stored in application queues.
tuxTQspaceTbl - This table represents attributes of application queue spaces.
tuxTclientTbl - This table represents runtime attributes of active clients within an application.
tuxTsvcGrp - This group represents configuration attributes of services within an application.
tuxTranTbl - This table represents runtime attributes of active transactions within the application.
Some objects in the BEA SNMP MIB for TUXEDO systems can be set (updated) only under certain states of the TUXEDO system. If you get an error while trying to set read-write objects in this MIB, please refer to the Access of a TUXEDO or M3 SNMP agent to managed resources can be made read-only, regardless of the community (password) used in SNMP requests, by disabling SET access. To do so, add the following line to the BEA Manager passwords file ( DISABLE_SET YES
The default is for SET access to be enabled. This will take effect only if the change is made prior to starting the agent, or prior to re-initializing the agent using the Updating MIB Objects
ULOG file. For details refer to TM_MIB(5) in the TUXEDO Reference Manual.
Disabling SET Access
beamgr_snmpd.conf):
reinit_agent command.