Administration Console Online Help

    Previous Next  Open TOC in new window 
Content starts here

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.

Related Tasks


  Back to Top