SNMP Overview
Configuration Options Related Tasks
This page displays all the SNMP agents that have been configured in the domain. There is one domain wide SNMP agent which is hosted on the admin server. This agent applies to all the servers within the domain. The server agents apply only to those servers that they have been targeted to. They can be created and deleted as needed.
Configuration Options
Name Description Name MBean Attribute:
SNMPAgentMBean.Name
Changes take effect after you redeploy the module or restart the server.
Enabled Specifies whether the Administration Server in the current WebLogic Server domain uses the SNMP service.
MBean Attribute:
SNMPAgentMBean.Enabled
Changes take effect after you redeploy the module or restart the server.
Trap Version The SNMP trap version that this WebLogic Server domain generates.
Valid values are:
1
Generates SNMPv1 traps.
2
Generates SNMPv2 traps.
Choose the protocol that your SNMP managers support.
MBean Attribute:
SNMPAgentMBean.SNMPTrapVersion
Changes take effect after you redeploy the module or restart the server.
Send Automatic Traps Enabled Specifies whether the WebLogic SNMP agent sends automatically generated traps to SNMP managers.
The WebLogic SNMP agent generates automatic traps when any of the following events occur:
The Administration Server starts.
An SNMP manager sends an incorrect community string.
A Managed Server starts.
A Managed Server shuts down.
MBean Attribute:
SNMPAgentMBean.SendAutomaticTrapsEnabled
Changes take effect after you redeploy the module or restart the server.
Port The port number on which you want the WebLogic SNMP agent to listen for incoming requests from SNMP managers.
SNMP managers can this port to ping the WebLogic Server SNMP agent and request the status of specific attributes.
MBean Attribute:
SNMPAgentMBean.SNMPPort
Minimum value:
1
Maximum value:
65535
Changes take effect after you redeploy the module or restart the server.
Server Status Check Interval Factor The multiplier used to calculate the interval at which the WebLogic SNMP agent checks for newly started or shut down Managed Servers.
The SNMP agent can automatically generate traps when Managed Servers start or shut down.
This status check value is multiplied by the MIB Data Refresh Interval to determine the interval:
interval = n * MibDataRefreshInterval
For the most frequent interval, specify
1
as the multiplier value.MBean Attribute:
SNMPAgentMBean.ServerStatusCheckIntervalFactor
Minimum value:
1
Maximum value:
65535
Changes take effect after you redeploy the module or restart the server.
Community Prefix The password (community name) that you want the WebLogic SNMP agent to use to secure communication with SNMP managers.
Note that there are two community names that are needed when the WebLogic SNMP agent and SNMP managers interact:
The name that you specify in this community prefix. All SNMP managers must send this name when connecting to the WebLogic SNMP agent.
The community name that the SNMP manager defines. The WebLogic SNMP agent must send this name when connecting to the manager. (You supply this community name when you configure a trap destination.)
In addition to using the community prefix as a password, the WebLogic SNMP agent uses the prefix to qualify requests from SNMP managers. Because a WebLogic Server domain can have multiple server instances concurrently active, a request that specifies only an attribute name is potentially ambiguous. For example, the attribute
serverUptime
exists for each WebLogic Server instance in a domain. To clarify requests, use the community prefix as follows:
To request the value of an attribute on a specific Managed Server, when you send a request from an SNMP manager, append the name of the server instance to the community prefix:
community_prefix@server_name
.To request the value of an attribute on the Administration Server, send a community name with the following form:
community_prefix
To request the value of an attribute for all server instances in a domain, send a community name with the following form:
community_prefix@domain_name
To secure access to the values of the WebLogic attributes, it is recommended that you set community prefix to a value other than
public
.MBean Attribute:
SNMPAgentMBean.CommunityPrefix
Secure value:
not public
Changes take effect after you redeploy the module or restart the server.
Debug Level The minimum severity of debug messages that the SNMP agent generates.
The SNMP agent writes all debug messages to standard out; they are not written to the WebLogic Server log files. Debug messages provide a detailed description of the SNMP agent's actions. For example, the agent outputs a noncritical message each time it generates a trap.
Valid values are:
0
No debug messages.
1
Fatal messages only.
2
Critical and fatal messages.
3
Non-critical, critical, and, fatal messages.
MBean Attribute:
SNMPAgentMBean.DebugLevel
Secure value:
0
Changes take effect after you redeploy the module or restart the server.
Community Based Access Enabled Enables or disables the SNMP v1 and v2 support in the Agent. When disabled only SNMPv3 format packets are processed. SNMP v1 and v2 messages are discarded and an error code is returned to the Manager.
MBean Attribute:
SNMPAgentMBean.CommunityBasedAccessEnabled
Changes take effect after you redeploy the module or restart the server.
Engine ID The unique identifier for an SNMP Agent in the WLS administrative domain. Defaults to the server name in case of a Managed Server's SNMP Agent or to the domain name for the Domain's SNMP Agent.
MBean Attribute:
SNMPAgentMBean.SNMPEngineId
Changes take effect after you redeploy the module or restart the server.
Authentication Protocol The default authentication protocol for all users.
MBean Attribute:
SNMPAgentMBean.AuthenticationProtocol
Changes take effect after you redeploy the module or restart the server.
Privacy Protocol The default privacy protocol for all users
MBean Attribute:
SNMPAgentMBean.PrivacyProtocol
Changes take effect after you redeploy the module or restart the server.
Inform Retry Interval Configures the interval in milliseconds that the SNMP Agent waits for a response for an INFORM PDU.
MBean Attribute:
SNMPAgentMBean.InformRetryInterval
Minimum value:
3000
Maximum value:
30000
Changes take effect after you redeploy the module or restart the server.
Localized Key Cache Invalidation Interval Configures the interval after which the localized key cache will be invalidated.
MBean Attribute:
SNMPAgentMBean.LocalizedKeyCacheInvalidationInterval
Maximum value:
86400000
Changes take effect after you redeploy the module or restart the server.
Maximum Infrom Retry Count Configures the maximum number of times the Agent will retry till it gets a response for an INFORM PDU.
MBean Attribute:
SNMPAgentMBean.MaxInformRetryCount
Minimum value:
1
Maximum value:
3
Changes take effect after you redeploy the module or restart the server.