The SNMP Agent Configuration Manager allows you to configure the MIB tables
associated with the SNMP agent. For more information about MIB tables,
see Management Information Base (MIB). These tables include the Community table, the Trap
Forwarding table, and the Server Access table.
This tool is required when a third-party SNMP manager is not able to create
a new MIB table entry for the SNMP agent. Most SNMP managers already
have this functionality built in, but some do not. If you use an SNMP
manager that does not allow you to configure MIB tables, you must use the SNMP
Agent Configuration Manager to configure the MIB table associated with the
SNMP agent. Even if your SNMP manager does have MIB table configuration
capabilities, this tool is recommended for configuring the WebSphere
InterChange Server SNMP agent.
- Note:
- The WebSphere InterChange Server SNMP solution is metadata driven;
therefore, you need define only the servers to monitor, not the specific
connectors or collaborations.
This section covers the following topics:
Installing the SNMP Agent Configuration Manager
Steps for starting the SNMP Agent Configuration Manager
Steps for connecting to the SNMP agent
Steps for configuring community names
Steps for configuring trap forwarding entries
Steps for configuring server access entries
Steps for configuring RBAC security
When you install the SNMP agent, the installer automatically installs the
SNMP Agent Configuration Manager. For instructions on installing the
SNMP agent, refer to the System Installation Guide for
UNIX or for Windows.
Perform the following steps to start the SNMP Agent Configuration Manager,
depending on your operating system:
UNIX |
---|
Run the start_snmpconfig.bat script located in the
ProductDir/bin directory. |
The SNMP Agent Configuration Manager appears.
Before you can begin editing the MIB table, you must connect to the SNMP
agent. See Steps for connecting to the SNMP agent for instructions.
- Note:
- The SNMP Agent Configuration Manager must be run on the same machine as the
SNMP agent.
Perform the following steps to connect the SNMP Agent Configuration Manager
to a running SNMP agent:
- Start the SNMP Agent Configuration Manager. For instructions, see Steps for starting the SNMP Agent Configuration Manager.
- Enter information in the following fields of the SNMP Agent Configuration
Manager window:
- Agent Host: Enter the host name or IP address of the
machine where the SNMP agent is running.
- Port: Enter the port number that the SNMP agent will use
to listen for SNMP commands. If you do not know your SNMP agent port
number, you can find it in the wbi_snmpagent.cfg, located in
the <WebSphere Business Integration Install
Dir>\snmp\config directory, where <WebSphere
Business Integration Install Dir> is the directory where you
installed the WebSphere InterChange Server product. The default port
number is 1161 for UNIX and 161 for Windows.
- Community: Enter the read-write community name of the
SNMP agent. By default, the read-write community name is
"administrator" and the read-only community name is "public." The
difference between the two types of community names is as follows:
- Read-write: Read-write access permits the user to edit
MIB table components, query values, start and stop components, and register
for traps.
- Read-only: Read-only access permits the user to perform
"Get" operations only. This user can view but not edit the MIB table
components and cannot change the status of any component.
- Click Connect. When the SNMP Agent Configuration Manager connects
to the SNMP agent, the Agent Host, Port, and Community fields become disabled,
and the Connect button changes to a Disconnect button.
The Community tab lists the communities that exist for the connected SNMP
agent. The table has three entries:
- Community Name: The name of the community
- Access: The access right of the community (read-write or
read-only)
- Row Status: The status of the community (active or not in
service)
You add community names to the MIB table when you want to give new users
permission to manage system components.
Perform the following steps to add a community name:
- From the Community tab, click Add. The Community Table Item dialog
box appears.
- Type a community name in the Community Name field.
- Note:
- Each community name must be unique in the network.
- Select the type of access for the new community from the Access drop-down
menu. The choices are "read-write" or "read-only."
- The Row Status drop-down menu is not configurable when adding a community
name. The default setting is "create & go."
- Click OK. The new community name appears in the Community table
with the Row Status set to Active.
You edit community names when you want to change the type of access or row
status of a registered community name.
Perform the following steps to edit a community name:
- From the Community tab, select the community name from the Community Name
column, then click Edit. The Community Table Item dialog box
appears.
- Note:
- You cannot edit the community name.
- Change the type of access from the Access drop-down menu. The
choices are "read-write" or "read-only."
- Change the status by selecting one of the following options from the Row
Status drop-down menu:
- active: This activates the community name, allowing it to
be used to access the SNMP agent.
- not in service: This deactivates the community name, but
it stores the community name information in the table. Choose this
option if you know you want to reactivate this community name at some point in
the future.
- destroy: This removes the community name entry from the
MIB table.
- Click OK. Any changes you made appear in the Community
table.
You remove community names when you want to completely delete them from the
MIB table.
Perform the following steps to remove a community name:
- From the Community tab, select the community name from the Community Name
column.
- Click Remove. The community name is removed from the table.
A trap is an asynchronous notification sent by the SNMP agent to the SNMP
manager whenever the status of a component in the managed device has changed
and the SNMP manager has expressed interest in such status changes.
When a trap is sent, the SNMP Agent notifies the designated host:port
specified in the Trap Forwarding Table and logs the trap name, for example,
collabTrapEventsLongTime, as well as the connector application name, connector
server name and connector application statur. A monitoring network
manager receives the trap, which triggers a response, for example, sending
email to the System Administrator.
The Trap Forwarding table has four entries:
- Trap ID: The unique ID given to a trap subscription
request
- Manager Host: The host name of the SNMP manager where the
notifications of a trap will be sent
- Trap Port: The port on which the SNMP manager listens to
the trap
- Row Status: The status of the trap (active or not in
service)
Table 7 list the SNMP Traps that exist in InterChange Server.
Table 7. SNMP Traps
Trap Type
| Variables
| Desription
| Trap ID
|
serverTrapStatus
| serverName,
serverStatus
| Generated when a server starts or stops
| 1
|
collabTrapStatus
| collabName, collabServerName, collabStatus
| Generated when a collaboration starts or stops
| 2
|
collabTrapEventsFailed
| collabName, collabServerName, collabEventsTrgdFlwFailed
| Generated when event fails on collaboration
| 3
|
collabTrapEventsLongTime
| collabName, collabServerName
| Generated when an event takes longer than a specified time on
collaboration
| 4
|
connTrapAgentStatus
| connName,
connServerName, connAgentStatus
| Generated when a connector agent's status is changed
| 5
|
connTrapStatus
| connName,
connServerName,
connStatus
| Generated when a connector status is changed
| 6
|
connTrapAppStatus
| connName,
connServerName, connAppStatus
| Generated when a connector application's status is changed
| 7
|
You add trap forwarding entries to the MIB table when you want to register
a server as the recipient of information gathered by the SNMP agent.
Perform the following steps to add a trap forwarding entry to the MIB
table:
- From the Trap Forwarding tab, click Add. The Trap Forwarding Table
Item dialog box appears.
- In the Trap ID field, type an integer.
- Note:
- Each Trap ID must be unique in the network.
- In the Manager Host field, type the host name or IP address of the machine
where the SNMP manager runs.
- Note:
- For UNIX users who use the host name, be sure to use the correct case.
- In the Trap Port field, type the port number that the SNMP manager uses to
listen to traps.
- The Row Status drop-down menu is not configurable when adding a trap
forwarding entry. The default setting is "create & go."
- Click OK. The new trap forwarding entry appears in the Trap
Forwarding table with the Row Status set to Active.
You edit trap forwarding entries when you want to change the Manager Host,
Trap Port, or Row Status information of registered trap forwarding
entries.
Perform the following steps to edit an existing trap forwarding
entry:
- In the Trap Forwarding tab, select a Trap ID, then click Edit. The
Trap Forwarding Table Item dialog box appears.
- Note:
- You cannot edit the Trap ID.
- Change the Manager Host by typing a different host name or IP address of
the machine where the SNMP manager runs.
- Note:
- For UNIX users who use the host name, be sure to use the correct case.
- Change the Trap Port by typing a different port number that the SNMP
manager uses to listen to traps.
- Change the Row Status of the trap forwarding entry by selecting one of the
following options from the Row Status drop-down menu:
- active: This activates the trap forwarding entry,
allowing it to be used to access the SNMP agent.
- not in service: This deactivates the trap forwarding
entry, but it stores the trap forwarding information in the table.
Choose this option if you know you want to reactivate this trap forwarding
entry at some point in the future.
- destroy: This removes the chosen community name entry
from the MIB table.
- Click OK. Any changes you made appear in the Trap Forwarding
table.
You remove trap forwarding entries when you want to completely remove them
from the MIB table.
Perform the following steps to remove a trap forwarding entry:
- From the Trap Forwarding tab, select the Trap ID you want to
remove.
- Click Remove. The trap forwarding entry is removed from the Trap
Forwarding table.
The server access entries allow you to link specific SNMP managers with
specific InterChange Servers to be managed. The table has three
entries:
- Manager Host: The host name of the SNMP manager
- WebSphere InterChange Server: The host name of the
machine where InterChange Server is installed
- Row Status: The link status (active or not in service)
Perform the following steps to create a new server access:
- From the Server Access tab, click Add. The Server Access Table Item
dialog box appears.
- In the Manager Host field, type the host name or IP address of the machine
where the SNMP manager runs.
- Note:
- For UNIX users who use the host name, be sure to use the correct case.
- In the WebSphere InterChange Server field, type the InterChange Server
name or IP address.
- Note:
- For UNIX users who use the host name, be sure to use the correct case.
- The Row Status drop-down menu is not configurable when adding a Server
Access entry. It is set to "create & go."
- Click OK. The new server access entry is added to the Server Access
table, with the Row Status set to "not in service."
You edit the server access entries of the MIB table when you want to change
the row status of the server access entries.
Perform the following steps to edit a server access entry, do the
following:
- From the Server Access tab, select a Manager Host, then click Edit.
- Change the status, select one of the following options from the Row Status
drop-down menu:
- active: This activates the chosen manager host, allowing
it to be used to used with the SNMP agent.
- Note:
- In order to change the status from "not in service" to "active," both the
SNMP manager and the InterChange Server being managed must be running.
- not in service: This deactivates the manager host, but it
stores the manager host information in the table. Choose this option if
you know you want to reactivate this manager host at some point in the
future.
- destroy: This removes the chosen manager host from the
MIB table.
- Click OK. Any changes you made appear in the Server Access
table.
You remove server access entries when you want to completely delete them
from the MIB table.
Perform the following steps to remove a server access entry:
- From the Server Access tab, select the server access entry you want to
remove.
- Click Remove. The Server Access entry is removed from the Server
Access table.
Role-based access control (RBAC) supports multiple users and enhanced
security features based on roles. A role is a collection of users who
share common functionality. Assigning functions into roles allows the
administrator to work more effectively by reducing the burden on the
administrator during the assignment of permissions.
Due to the addition of RBAC functionality, the SNMP agent now allows the
input of usernames and passwords to help administer these roles. If
RBAC security is enabled on InterChange Server, a user must specify a username
and password to connect to the InterChange Server.
The RBAC Security table has four entries:
- WebSphere ICS: The unique ID for the WebSphere
InterChange Server
- User Name: The username assigned to a specific individual
- Password: The password assigned to the username
- Row Status: The status of the trap (active or not in
service)
You add RBAC security entries to the MIB table to connect the SNMP agent to
the InterChange Server when RBAC security is enabled.
Perform the following steps to add an RBAC security entry to the MIB
table:
- From the RBAC Security tab, click Add. The RBAC Security Table Item
dialog box appears.
- In the WebSphere ICS field, type an integer.
- In the Username field, type the username assigned to the role.
- In the Password field, type the password assigned to the username.
- The Row Status drop-down menu is not configurable when adding an RBAC
security entry. It is set to "create & go."
- Click OK. The new RBAC security entry appears in the RBAC security
table with the Row Status set to Active.
You edit RBAC security entries when you want to change the Username,
Password or Row Status information of registered RBAC security entries.
Perform the following steps to edit an existing RBAC security entry:
- In the RBAC Security tab, select a Username, then click Edit. The
RBAC Security Table Item dialog box appears.
- Change the Username by typing a different username in the available
space.
- Change the Password by typing a different password in the available
space.
- Change the Row Status of the RBAC security entry by selecting one of the
following options from the Row Status drop-down menu:
- active: This activates the RBAC security entry, allowing
it to be used to access the SNMP agent.
- not in service: This deactivates the RBAC security entry,
but it stores the RBAC security information in the table. Choose this
option if you know you want to reactivate this RBAC security entry at some
point in the future.
- destroy: This removes the chosen RBAC security entry from
the MIB table.
- Click OK. Any changes you made appear in the RBAC Security
table.
You remove RBAC security entries when you want to completely remove them
from the MIB table.
Perform the following steps to remove a RBAC security entry:
- From the RBAC Security tab, select the Trap ID you want to remove.
- Click Remove. The RBAC security entry is removed from the RBAC
Security table.
