9.3 TL1 Adaptor

9.3.3 Features Supported by the JMX TL1 Agent

9.3.1 TL1 Adaptor: An Overview

The com.adventnet.adaptors.tl1.TL1Adaptor class from WebNMS acts as an adaptor for TL1 protocol to make the agent accessible from the management applications (e.g., WebNMS TL1 Browser) outside the agent's JVM.

This class itself acts as an MBean for exposing the TL1 adaptor configuration parameters, which can be viewed and changed through some other protocol adaptors/connectors (say HTML or IIOP).

This class extends the com.adventnet.adaptors.common.AbstractAdaptor class. This class abstracts the common behavior of all Adaptors. All Protocol Adaptors must extend this class. This class also implements the javax.management.MBeanRegistration interface. Thus, the method preRegister(..) in this MBeanRegistration interface allows this adaptor to perform any operation it needs before being registered with the MBeanServer.

The TL1 agent gets actually started only inside the preRegister(..) method at the specified port, mentioned in the key "port" of the ObjectName (the name with which this adaptor gets registered with the MBeanServer). If the key "port" is absent, then the TL1 Agent (NE) gets started at the default port 9099. If the port is already occupied, then the agent starting fails.

9.3.2 Registering TL1 Adaptor

To create a Multi-Protocol agent with TL1 Adaptor support, the adaptor must be registered with the MBean server of the Multi-Protocol agent. This can be done either from the JMX Compiler or using API calls.

Using JMX Compiler UI

Select Project -> Settings option; the Settings dialog appears
Select Adaptors -> TL1 -> General option from the Settings tree in the dialog.
Configure the following options in the General panel that appears on the right side:

Enable TL1 Adaptor option.

Enter the Port Number (port at which TL1 Adaptor must be started).

On code generation, code is generated to register the TL1 adaptor with the MBean server.

Using API

To register TL1 Adaptor using API, add the following code to the registerAdventNetAdaptors() method of the agent's main file.

tl1adaptor= new TL1Adaptor();
tl1adaptor.setDebugLevel(debugLevel);
tl1adaptor.setStandAlone(false);
name = "Adaptors:type=TL1Adaptor";
tl1adaptor.setPort(tl1Port);
server.registerMBean(tl1adaptor, new ObjectName(name));

9.3.3 Features Supported by the JMX TL1 Agent

The various features supported by the JMX TL1 agent through Agent Toolkit's TL1 Adaptor are as follows: