ConfigurationMBean
, DescriptorBean
, javax.management.DynamicMBean
, javax.management.MBeanRegistration
, javax.management.NotificationBroadcaster
, SettableBean
, WebLogicMBean
SNMPAgentDeploymentMBean
public interface SNMPAgentMBean extends ConfigurationMBean
This singleton MBean represents an SNMP agent that is scoped to a WebLogic Server domain.
This MBean is provided to support domains that were created with
WebLogic Server release 9.2 and earlier. For new domains, create an
instance of SNMPAgentDeploymentMBean
and target it to the domain's
Administration Server.
Modifier and Type | Field | Description |
---|---|---|
static java.lang.String |
AES_128 |
AES privacy protocol
|
static int |
DEBUG_CRITICAL |
|
static int |
DEBUG_FATAL |
|
static int |
DEBUG_NONCRITICAL |
|
static int |
DEBUG_NONE |
|
static java.lang.String |
DES |
DES privacy protocol
|
static java.lang.String |
MD5 |
MD5 authentication protocol
|
static java.lang.String |
NO_AUTH |
Constant for no authentication
|
static java.lang.String |
NO_PRIV |
Constant for no privacy
|
static java.lang.String |
SHA |
SHA authentication protocol
|
static int |
SNMPV1 |
SNMP Version 1
|
static int |
SNMPV2 |
SNMP Version 2
|
static int |
SNMPV3 |
SNMP Version 3
|
DEFAULT_EMPTY_BYTE_ARRAY
Modifier and Type | Method | Description |
---|---|---|
boolean |
addSNMPAttributeChange(SNMPAttributeChangeMBean attrchange) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
addSNMPCounterMonitor(SNMPCounterMonitorMBean countermonitor) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
addSNMPGaugeMonitor(SNMPGaugeMonitorMBean gaugemonitor) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
addSNMPLogFilter(SNMPLogFilterMBean logfilter) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
addSNMPProxy(SNMPProxyMBean snmpProxy) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
addSNMPStringMonitor(SNMPStringMonitorMBean stringmonitor) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
addSNMPTrapDestination(SNMPTrapDestinationMBean trapdestination) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
addTargetedTrapDestination(SNMPTrapDestinationMBean trapdestination) |
Deprecated.
9.0.0.0
|
SNMPAttributeChangeMBean |
createSNMPAttributeChange(java.lang.String name) |
Factory method to create SNMPAttributeChange objects
|
SNMPCounterMonitorMBean |
createSNMPCounterMonitor(java.lang.String name) |
Factory method to create SNMPCounterMonitor objects
|
SNMPGaugeMonitorMBean |
createSNMPGaugeMonitor(java.lang.String name) |
Factory method to create SNMPGaugeMonitor objects
|
SNMPLogFilterMBean |
createSNMPLogFilter(java.lang.String name) |
Factory method to create SNMPLogFilter objects
|
SNMPProxyMBean |
createSNMPProxy(java.lang.String name) |
Factory method to create SNMPProxy objects
|
SNMPStringMonitorMBean |
createSNMPStringMonitor(java.lang.String name) |
Factory method to create SNMPStringMonitor objects
|
SNMPTrapDestinationMBean |
createSNMPTrapDestination(java.lang.String name) |
Factory method to create SNMPTrapDestination objects
|
void |
destroySNMPAttributeChange(SNMPAttributeChangeMBean attrchange) |
Removes a SNMPAttributeChange from this domain
|
void |
destroySNMPCounterMonitor(SNMPCounterMonitorMBean countermonitor) |
Removes a SNMPCounterMonitor from this domain
|
void |
destroySNMPGaugeMonitor(SNMPGaugeMonitorMBean gaugemonitor) |
Removes a SNMPGaugeMonitor from this domain
|
void |
destroySNMPLogFilter(SNMPLogFilterMBean logfilter) |
Removes a SNMPLogFilter from this domain
|
void |
destroySNMPProxy(SNMPProxyMBean snmpProxy) |
Removes a SNMPProxy from this domain
|
void |
destroySNMPStringMonitor(SNMPStringMonitorMBean stringmonitor) |
Removes a SNMPStringMonitor from this domain
|
void |
destroySNMPTrapDestination(SNMPTrapDestinationMBean trapdestination) |
Removes a SNMPTrapDestination from this SNMPAgent
|
java.lang.String |
getAuthenticationProtocol() |
The protocol that this SNMP agent uses to ensure that only authorized
users can request or receive information about your WebLogic Server domain.
|
java.lang.String |
getCommunityPrefix() |
Deprecated.
12.2.1.4 There is no replacement for this attribute as SNMPv1 and v2 support will be removed.
|
int |
getDebugLevel() |
Deprecated.
10.0.0.0 Use the ServerDebugMBean.DebugSNMPToolkit attribute to configure the SNMP Toolkit debug
|
int |
getInformRetryInterval() |
The number of milliseconds that this SNMP agent will wait
for a response to an INFORM notification.
|
java.lang.String |
getListenAddress() |
The listen address on which you want this SNMP agent to
listen for incoming requests from SNMP managers that use
the UDP protocol.
|
long |
getLocalizedKeyCacheInvalidationInterval() |
The number of milliseconds after which WebLogic Server invalidates
its cache of SNMP security keys.
|
int |
getMasterAgentXPort() |
The port that this SNMP agent uses to communicate with
its subagents.
|
int |
getMaxInformRetryCount() |
The maximum number of times that this SNMP agent will
resend INFORM notifications for which it has not received a response.
|
int |
getMibDataRefreshInterval() |
Deprecated.
10.0.0.0 There is no replacement for this attribute.
|
java.lang.String |
getPrivacyProtocol() |
The protocol that this SNMP agent uses to encrypt and unencrypt messages.
|
int |
getServerStatusCheckIntervalFactor() |
Deprecated.
10.0.0.0 There is no replacement for this attribute.
|
SNMPAttributeChangeMBean[] |
getSNMPAttributeChanges() |
The
SNMPAttributeChangeMBeans which describe the
MBean type and Attribute name for which attribute change notification
should be sent when an attribute change is observed. |
SNMPCounterMonitorMBean[] |
getSNMPCounterMonitors() |
The
SNMPCounterMonitorMBeans which describe the
criteria for generating notifications based on JMX CounterMonitor. |
java.lang.String |
getSNMPEngineId() |
An identifier for this SNMP agent that is unique amongst all
other SNMP agents in the current WebLogic Server domain.
|
SNMPGaugeMonitorMBean[] |
getSNMPGaugeMonitors() |
The
SNMPGaugeMonitorMBeans which describe the
criteria for generating notifications based on JMX GaugeMonitor. |
SNMPLogFilterMBean[] |
getSNMPLogFilters() |
The
SNMPLogFilterMBeans which describe filters for
generating notifications based on server log messages. |
int |
getSNMPPort() |
The port on which you want this SNMP agent to
listen for incoming requests from SNMP managers that use
the UDP protocol.
|
SNMPProxyMBean[] |
getSNMPProxies() |
The SNMP agents for which this SNMP agent is a proxy.
|
SNMPStringMonitorMBean[] |
getSNMPStringMonitors() |
The
SNMPStringMonitorMBeans which describe the
criteria for generating notifications based on JMX StringMonitor. |
SNMPTrapDestinationMBean[] |
getSNMPTrapDestinations() |
WebLogic Server uses a trap destination to specify the SNMP
management station and the community name used by the SNMP agent to
send notifications.
|
int |
getSNMPTrapVersion() |
The SNMP notification version that this SNMP agent generates.
|
SNMPTrapDestinationMBean[] |
getTargetedTrapDestinations() |
Deprecated.
9.0.0.0 Use the getSNMPTrapDestinations() method instead.
|
boolean |
isCommunityBasedAccessEnabled() |
Deprecated.
12.2.1.4 There is no replacement for this attribute as SNMPv1 and v2 support will be removed.
|
boolean |
isEnabled() |
Specifies whether this SNMP agent is enabled.
|
boolean |
isInformEnabled() |
Configures this SNMP agent to send notifications as an
INFORM instead of a TRAP.
|
boolean |
isSendAutomaticTrapsEnabled() |
Specifies whether this SNMP agent sends automatically
generated notifications to SNMP managers.
|
boolean |
isSNMPAccessForUserMBeansEnabled() |
Configures this SNMP agent to provide read-only access to
MBean types that you have created and registered (custom MBeans).
|
SNMPAttributeChangeMBean |
lookupSNMPAttributeChange(java.lang.String name) |
|
SNMPCounterMonitorMBean |
lookupSNMPCounterMonitor(java.lang.String name) |
|
SNMPGaugeMonitorMBean |
lookupSNMPGaugeMonitor(java.lang.String name) |
|
SNMPLogFilterMBean |
lookupSNMPLogFilter(java.lang.String name) |
|
SNMPProxyMBean |
lookupSNMPProxy(java.lang.String name) |
|
SNMPStringMonitorMBean |
lookupSNMPStringMonitor(java.lang.String name) |
|
SNMPTrapDestinationMBean |
lookupSNMPTrapDestination(java.lang.String name) |
|
boolean |
removeSNMPAttributeChange(SNMPAttributeChangeMBean attrchange) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
removeSNMPCounterMonitor(SNMPCounterMonitorMBean countermonitor) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
removeSNMPGaugeMonitor(SNMPGaugeMonitorMBean gaugemonitor) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
removeSNMPLogFilter(SNMPLogFilterMBean logfilter) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
removeSNMPProxy(SNMPProxyMBean snmpProxy) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
removeSNMPStringMonitor(SNMPStringMonitorMBean stringmonitor) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
boolean |
removeTargetedTrapDestination(SNMPTrapDestinationMBean trapdestination) |
Deprecated.
9.0.0.0
|
void |
setAuthenticationProtocol(java.lang.String protocol) |
|
void |
setCommunityBasedAccessEnabled(boolean enabled) |
|
void |
setCommunityPrefix(java.lang.String prefix) |
Sets the value of the CommunityPrefix attribute.
|
void |
setDebugLevel(int debugLevel) |
Deprecated.
10.0.0.0 Use the ServerDebugMBean.DebugSNMPToolkit attribute to configure the SNMP Toolkit debug
|
void |
setEnabled(boolean flag) |
Sets the value of the Enabled attribute.
|
void |
setInformEnabled(boolean value) |
|
void |
setInformRetryInterval(int interval) |
|
void |
setListenAddress(java.lang.String listenAddress) |
Sets the value of the ListenAddress attribute.
|
void |
setLocalizedKeyCacheInvalidationInterval(long value) |
|
void |
setMasterAgentXPort(int value) |
|
void |
setMaxInformRetryCount(int retryCount) |
|
void |
setMibDataRefreshInterval(int interval) |
Sets the value of the MibDataRefreshInterval attribute.
|
void |
setPrivacyProtocol(java.lang.String protocol) |
|
void |
setSendAutomaticTrapsEnabled(boolean flag) |
Sets the value of the SendAutomaticTrapsEnabled attribute.
|
void |
setServerStatusCheckIntervalFactor(int factor) |
Sets the value of the ServerStatusCheckIntervalFactor
attribute.
|
void |
setSNMPAccessForUserMBeansEnabled(boolean v) |
|
void |
setSNMPAttributeChanges(SNMPAttributeChangeMBean[] snmpAttributeChanges) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
void |
setSNMPCounterMonitors(SNMPCounterMonitorMBean[] snmpCounterMonitors) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
void |
setSNMPEngineId(java.lang.String engineId) |
|
void |
setSNMPGaugeMonitors(SNMPGaugeMonitorMBean[] snmpGaugeMonitors) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
void |
setSNMPLogFilters(SNMPLogFilterMBean[] snmpLogFilters) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
void |
setSNMPPort(int port) |
Sets the value of the SNMPPort attribute.
|
void |
setSNMPProxies(SNMPProxyMBean[] snmpProxys) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
void |
setSNMPStringMonitors(SNMPStringMonitorMBean[] snmpStringMonitors) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
void |
setSNMPTrapVersion(int version) |
Sets the value of the SNMPTrapVersion attribute.
|
void |
setTargetedTrapDestinations(SNMPTrapDestinationMBean[] snmpTrapDestinations) |
Deprecated.
9.0.0.0 Instead, use standard JMX design patterns using
javax.management.MBeanServerConnection interface. |
freezeCurrentValue, getId, getInheritedProperties, getName, getNotes, isDynamicallyCreated, isInherited, isSet, restoreDefaultValue, setComments, setDefaultedMBean, setName, setNotes, setPersistenceEnabled, unSet
addPropertyChangeListener, createChildCopyIncludingObsolete, getParentBean, isEditable, removePropertyChangeListener
getAttribute, getAttributes, invoke, setAttribute, setAttributes
postDeregister, postRegister, preDeregister, preRegister
addNotificationListener, getNotificationInfo, removeNotificationListener
getMBeanInfo, getObjectName, getParent, getType, isCachingDisabled, isRegistered, setParent
static final int DEBUG_NONE
static final int DEBUG_FATAL
static final int DEBUG_CRITICAL
static final int DEBUG_NONCRITICAL
static final int SNMPV1
static final int SNMPV2
static final int SNMPV3
static final java.lang.String NO_AUTH
static final java.lang.String MD5
static final java.lang.String SHA
static final java.lang.String NO_PRIV
static final java.lang.String DES
static final java.lang.String AES_128
boolean isEnabled()
Specifies whether this SNMP agent is enabled.
void setEnabled(boolean flag)
Sets the value of the Enabled attribute.
flag
- The new enabled valueisEnabled()
boolean isSendAutomaticTrapsEnabled()
Specifies whether this SNMP agent sends automatically generated notifications to SNMP managers.
The SNMP agent generates automatic notifications when any of the following events occur:
The WebLogic Server instance that is hosting the SNMP agent starts.
This type of notification (coldStart) has no variable bindings.
A server instance starts or stops.
An SNMP agent on a Managed Server generates these notifications only when its host Managed Server starts or stops. An SNMP agent on an Administration Server generates these notifications when any server in the domain starts or stops.
These notification types (serverStart and serverShutdown) contain variable bindings to identify the server that started or stopped and the time at which the notification was generated.
getServerStatusCheckIntervalFactor()
void setSendAutomaticTrapsEnabled(boolean flag)
Sets the value of the SendAutomaticTrapsEnabled attribute.
flag
- The new sendAutomaticTrapsEnabled valueisSendAutomaticTrapsEnabled()
java.lang.String getListenAddress()
The listen address on which you want this SNMP agent to listen for incoming requests from SNMP managers that use the UDP protocol.
If not specified the Server's ListenAddress is used as the ListenAddress for the SNMPAgent.
void setListenAddress(java.lang.String listenAddress)
Sets the value of the ListenAddress attribute.
listenAddress
- int getSNMPPort()
The port on which you want this SNMP agent to listen for incoming requests from SNMP managers that use the UDP protocol.
SNMP managers can use this port to ping the SNMP agent and request the status of specific attributes.
If you target this SNMP agent to multiple server instances, and if two or more servers are running on the same computer, WebLogic Server will automatically increment this UDP port value by 1 for each agent. WebLogic Server never assigns port 162 because it is the default port that an agent uses to send notifications. In addition, if any port is already in use, WebLogic Server skips the port and assigns the next available port.
For example, if you use the default value of this attribute and then target this agent to ManagedServer1 and ManagedServer2, and if both servers are running on the same computer, then the agent on ManagedServer1 will listen on UDP port 161 and the agent on ManagedServer2 will listen on UDP port 163.
The incremented port number is not persisted in the domain's configuration; when WebLogic Server increments port numbers, it does so in the order in which servers are started on the same computer.
If WebLogic Server re-assigns the UDP port for an SNMP agent, look in the agent's SNMPAgentRuntimeMBean to see the agent's runtime UDP port.
SNMP agents can also communicate through the host server's TCP listen port (7001 by default) or through a TCP port that is configured by a custom network channel.
SNMPAgentRuntimeMBean
,
ServerTemplateMBean.getListenPort()
,
NetworkAccessPointMBean
void setSNMPPort(int port) throws javax.management.InvalidAttributeValueException, ConfigurationException
Sets the value of the SNMPPort attribute.
port
- The new SNMPPort valuejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPPort()
int getSNMPTrapVersion()
The SNMP notification version that this SNMP agent generates.
isCommunityBasedAccessEnabled()
void setSNMPTrapVersion(int version)
Sets the value of the SNMPTrapVersion attribute.
getSNMPTrapVersion()
@Deprecated int getMibDataRefreshInterval()
The minimum number of seconds that this SNMP agent caches OIDs before checking if new ones have been added to the Management Information Base (MIB).
A MIB is a database of all objects that can be managed through SNMP. When you create a new WebLogic Server resource, the SNMP agent assigns a unique OID to the resource and adds it to the MIB. For example, when you create a new server, the SNMP agent adds an OID to the MIB.
This attribute is not used by the SNMP Agent anymore. The SNMP Agent retrieves internal notifications about MBean registrations in the WLS MBeanServers.
void setMibDataRefreshInterval(int interval) throws javax.management.InvalidAttributeValueException, ConfigurationException
Sets the value of the MibDataRefreshInterval attribute.
interval
- The new mibDataRefreshInterval valuejavax.management.InvalidAttributeValueException
ConfigurationException
getMibDataRefreshInterval()
@Deprecated int getServerStatusCheckIntervalFactor()
The multiplier used to calculate the interval at which this SNMP agent checks for newly started or shut down server instances.
You can enable the SNMP agent to automatically generate
serverStartup and serverShutdown notifications when servers start or shut down.
See isSendAutomaticTrapsEnabled()
.
This status check value is multiplied by the MIB Data Refresh Interval to determine the interval:
interval = n * MibDataRefreshInterval
The SNMP Agent uses internal notifications to update itself when a server is restarted so there is no need to poll the server for their status.
For the most frequent interval, specify 1
as the
multiplier value.
void setServerStatusCheckIntervalFactor(int factor) throws javax.management.InvalidAttributeValueException, ConfigurationException
Sets the value of the ServerStatusCheckIntervalFactor attribute.
factor
- The new serverStatusCheckIntervalFactor valuejavax.management.InvalidAttributeValueException
ConfigurationException
getServerStatusCheckIntervalFactor()
@Deprecated java.lang.String getCommunityPrefix()
The password (community name) that you want this SNMP agent to use to secure SNMPv1 or v2 communication with SNMP managers. Requires you to enable community based access for this agent.
SNMPv3 does not use community names. Instead, it encrypts user names and passwords in its PDUs.
When you use SNMPv1 or v2, 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 this SNMP agent.
The community name that the SNMP manager defines. The 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, an
SNMP agent on an Administration Server uses the prefix to qualify
requests from SNMP managers. Because the Administration Server can
access data for all WebLogic Server instances in a domain, 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 that you send to SNMP agents on
Administration Servers, 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 for all server instances in
a domain, send a community name with the following form:
community_prefix
To secure access to the values of the WebLogic attributes when using
the SNMPv1 or v2 protocols, it is recommended that you set community prefix
to a value other than public
or private
.
You cannot specify a null (empty) value for the community prefix when SNMP agent is enabled. If you do not want this agent to receive SNMPv1 or v2 requests, disable community based access.
void setCommunityPrefix(java.lang.String prefix) throws javax.management.InvalidAttributeValueException, ConfigurationException
Sets the value of the CommunityPrefix attribute.
prefix
- The new communityPrefix valuejavax.management.InvalidAttributeValueException
ConfigurationException
getCommunityPrefix()
@Deprecated int getDebugLevel()
The minimum severity of debug messages that this 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 notification.
Valid values are:
0
No debug messages.
1
Fatal messages only.
2
Critical and fatal messages.
3
Non-critical, critical, and, fatal messages.
@Deprecated void setDebugLevel(int debugLevel) throws javax.management.InvalidAttributeValueException, ConfigurationException
Sets the value of the DebugLevel attribute.
debugLevel
- The new debugLevel valuejavax.management.InvalidAttributeValueException
ConfigurationException
getDebugLevel()
@Deprecated SNMPTrapDestinationMBean[] getTargetedTrapDestinations()
WebLogic Server uses a trap destination to specify the SNMP management station and the community name used by the SNMP agent to send trap notifications.
This attribute contains the collection of trap destinations that have been configured for this SNMP agent.
@Deprecated void setTargetedTrapDestinations(SNMPTrapDestinationMBean[] snmpTrapDestinations) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Sets the value of the TargetedTrapDestinations attribute.
snmpTrapDestinations
- The new targetedTrapDestinations valuejavax.management.InvalidAttributeValueException
ConfigurationException
getTargetedTrapDestinations()
@Deprecated boolean addTargetedTrapDestination(SNMPTrapDestinationMBean trapdestination) throws javax.management.InvalidAttributeValueException, ConfigurationException
Adds a single trap destination to this SNMP agent's list of targeted trap destinations.
trapdestination
- The feature to be added to the TargetedTrapDestination attributejavax.management.InvalidAttributeValueException
ConfigurationException
getTargetedTrapDestinations()
@Deprecated boolean removeTargetedTrapDestination(SNMPTrapDestinationMBean trapdestination) throws javax.management.InvalidAttributeValueException, ConfigurationException
trapdestination
- javax.management.InvalidAttributeValueException
ConfigurationException
SNMPTrapDestinationMBean createSNMPTrapDestination(java.lang.String name)
Factory method to create SNMPTrapDestination objects
name
- void destroySNMPTrapDestination(SNMPTrapDestinationMBean trapdestination)
Removes a SNMPTrapDestination from this SNMPAgent
trapdestination
- SNMPTrapDestinationMBean lookupSNMPTrapDestination(java.lang.String name)
name
- SNMPTrapDestinationMBean[] getSNMPTrapDestinations()
WebLogic Server uses a trap destination to specify the SNMP management station and the community name used by the SNMP agent to send notifications. Select which trap destination(s) should be used in this WebLogic Server domain from the list of available trap destinations.
@Deprecated boolean addSNMPTrapDestination(SNMPTrapDestinationMBean trapdestination) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Adds an SNMPTrapDestination to the SNMPAgentMBean object
trapdestination
- The feature to be added to the SNMPTrapDestination attributejavax.management.InvalidAttributeValueException
ConfigurationException
SNMPProxyMBean[] getSNMPProxies()
The SNMP agents for which this SNMP agent is a proxy.
SNMPProxyMBeans
describe settings for SNMP agents to
be proxied by this SNMP agent.
SNMPProxyMBean
@Deprecated void setSNMPProxies(SNMPProxyMBean[] snmpProxys) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Sets the value of the SNMPProxies attribute.
snmpProxys
- The new SNMPProxies valuejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPProxies()
@Deprecated boolean addSNMPProxy(SNMPProxyMBean snmpProxy) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Adds a feature to the SNMPProxy attribute of the SNMPAgentMBean object
snmpProxy
- The feature to be added to the SNMPProxy attributejavax.management.InvalidAttributeValueException
ConfigurationException
@Deprecated boolean removeSNMPProxy(SNMPProxyMBean snmpProxy) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.snmpProxy
- javax.management.InvalidAttributeValueException
ConfigurationException
SNMPProxyMBean createSNMPProxy(java.lang.String name)
Factory method to create SNMPProxy objects
name
- void destroySNMPProxy(SNMPProxyMBean snmpProxy)
Removes a SNMPProxy from this domain
snmpProxy
- SNMPProxyMBean lookupSNMPProxy(java.lang.String name)
name
- SNMPGaugeMonitorMBean[] getSNMPGaugeMonitors()
The SNMPGaugeMonitorMBeans
which describe the
criteria for generating notifications based on JMX GaugeMonitor.
SNMPGaugeMonitorMBean
@Deprecated void setSNMPGaugeMonitors(SNMPGaugeMonitorMBean[] snmpGaugeMonitors) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Sets the value of the SNMPGaugeMonitors attribute.
snmpGaugeMonitors
- The new SNMPGaugeMonitors valuejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPGaugeMonitors()
@Deprecated boolean addSNMPGaugeMonitor(SNMPGaugeMonitorMBean gaugemonitor) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Adds a feature to the SNMPGaugeMonitor attribute of the SNMPAgentMBean object
gaugemonitor
- The feature to be added to the SNMPGaugeMonitor attributejavax.management.InvalidAttributeValueException
ConfigurationException
@Deprecated boolean removeSNMPGaugeMonitor(SNMPGaugeMonitorMBean gaugemonitor) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.gaugemonitor
- javax.management.InvalidAttributeValueException
ConfigurationException
SNMPGaugeMonitorMBean createSNMPGaugeMonitor(java.lang.String name)
Factory method to create SNMPGaugeMonitor objects
name
- void destroySNMPGaugeMonitor(SNMPGaugeMonitorMBean gaugemonitor)
Removes a SNMPGaugeMonitor from this domain
gaugemonitor
- SNMPGaugeMonitorMBean lookupSNMPGaugeMonitor(java.lang.String name)
name
- SNMPStringMonitorMBean[] getSNMPStringMonitors()
The SNMPStringMonitorMBeans
which describe the
criteria for generating notifications based on JMX StringMonitor.
SNMPStringMonitorMBean
@Deprecated void setSNMPStringMonitors(SNMPStringMonitorMBean[] snmpStringMonitors) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Sets the value of the SNMPStringMonitors attribute.
snmpStringMonitors
- The new SNMPStringMonitors valuejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPStringMonitors()
@Deprecated boolean addSNMPStringMonitor(SNMPStringMonitorMBean stringmonitor) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Adds a single SNMPStringMonitorMBeans
to this SNMP agent's
collection.
stringmonitor
- The feature to be added to the SNMPStringMonitor attributejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPStringMonitors()
@Deprecated boolean removeSNMPStringMonitor(SNMPStringMonitorMBean stringmonitor) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.stringmonitor
- javax.management.InvalidAttributeValueException
ConfigurationException
SNMPStringMonitorMBean createSNMPStringMonitor(java.lang.String name)
Factory method to create SNMPStringMonitor objects
name
- void destroySNMPStringMonitor(SNMPStringMonitorMBean stringmonitor)
Removes a SNMPStringMonitor from this domain
stringmonitor
- SNMPStringMonitorMBean lookupSNMPStringMonitor(java.lang.String name)
name
- SNMPCounterMonitorMBean[] getSNMPCounterMonitors()
The SNMPCounterMonitorMBeans
which describe the
criteria for generating notifications based on JMX CounterMonitor.
SNMPCounterMonitorMBean
@Deprecated void setSNMPCounterMonitors(SNMPCounterMonitorMBean[] snmpCounterMonitors) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Sets the value of the SNMPCounterMonitors attribute.
snmpCounterMonitors
- The new SNMPCounterMonitors valuejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPCounterMonitors()
@Deprecated boolean addSNMPCounterMonitor(SNMPCounterMonitorMBean countermonitor) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Adds a feature to the SNMPCounterMonitor attribute of the SNMPAgentMBean object
countermonitor
- The feature to be added to the SNMPCounterMonitor attributejavax.management.InvalidAttributeValueException
ConfigurationException
@Deprecated boolean removeSNMPCounterMonitor(SNMPCounterMonitorMBean countermonitor) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.countermonitor
- javax.management.InvalidAttributeValueException
ConfigurationException
SNMPCounterMonitorMBean createSNMPCounterMonitor(java.lang.String name)
Factory method to create SNMPCounterMonitor objects
name
- void destroySNMPCounterMonitor(SNMPCounterMonitorMBean countermonitor)
Removes a SNMPCounterMonitor from this domain
countermonitor
- SNMPCounterMonitorMBean lookupSNMPCounterMonitor(java.lang.String name)
name
- SNMPLogFilterMBean[] getSNMPLogFilters()
The SNMPLogFilterMBeans
which describe filters for
generating notifications based on server log messages.
SNMPLogFilterMBean
@Deprecated void setSNMPLogFilters(SNMPLogFilterMBean[] snmpLogFilters) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Sets the value of the SNMPLogFilters attribute.
snmpLogFilters
- The new SNMPLogFilters valuejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPLogFilters()
@Deprecated boolean addSNMPLogFilter(SNMPLogFilterMBean logfilter) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Adds a feature to the SNMPLogFilter attribute of the SNMPAgentMBean object
logfilter
- The feature to be added to the SNMPLogFilter attributejavax.management.InvalidAttributeValueException
ConfigurationException
@Deprecated boolean removeSNMPLogFilter(SNMPLogFilterMBean logfilter) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.logfilter
- javax.management.InvalidAttributeValueException
ConfigurationException
SNMPLogFilterMBean createSNMPLogFilter(java.lang.String name)
Factory method to create SNMPLogFilter objects
name
- void destroySNMPLogFilter(SNMPLogFilterMBean logfilter)
Removes a SNMPLogFilter from this domain
logfilter
- SNMPLogFilterMBean lookupSNMPLogFilter(java.lang.String name)
name
- SNMPAttributeChangeMBean[] getSNMPAttributeChanges()
The SNMPAttributeChangeMBeans
which describe the
MBean type and Attribute name for which attribute change notification
should be sent when an attribute change is observed.
SNMPAttributeChangeMBean
@Deprecated void setSNMPAttributeChanges(SNMPAttributeChangeMBean[] snmpAttributeChanges) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Sets the value of the SNMPAttributeChanges attribute.
snmpAttributeChanges
- The new SNMPAttributeChanges valuejavax.management.InvalidAttributeValueException
ConfigurationException
getSNMPAttributeChanges()
@Deprecated boolean addSNMPAttributeChange(SNMPAttributeChangeMBean attrchange) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.Adds a feature to the SNMPAttributeChange attribute of the SNMPAgentMBean object
attrchange
- The feature to be added to the SNMPAttributeChange attributejavax.management.InvalidAttributeValueException
ConfigurationException
@Deprecated boolean removeSNMPAttributeChange(SNMPAttributeChangeMBean attrchange) throws javax.management.InvalidAttributeValueException, ConfigurationException
javax.management.MBeanServerConnection
interface.attrchange
- javax.management.InvalidAttributeValueException
ConfigurationException
SNMPAttributeChangeMBean createSNMPAttributeChange(java.lang.String name)
Factory method to create SNMPAttributeChange objects
name
- void destroySNMPAttributeChange(SNMPAttributeChangeMBean attrchange)
Removes a SNMPAttributeChange from this domain
attrchange
- SNMPAttributeChangeMBean lookupSNMPAttributeChange(java.lang.String name)
name
- @Deprecated boolean isCommunityBasedAccessEnabled()
Specifies whether this SNMP agent supports SNMPv1 and v2.
SNMPv1 and v2 use community strings for authentication. If you disable community strings for this SNMP agent, the agent will process only SNMPv3 requests. If an SNMP manager sends a v1 or v2 message, the agent discards the message and returns an error code to the manager.
void setCommunityBasedAccessEnabled(boolean enabled)
java.lang.String getSNMPEngineId()
An identifier for this SNMP agent that is unique amongst all other SNMP agents in the current WebLogic Server domain.
If you use SNMPv3 to send messages to this SNMP agent, you must specify the SNMP engine ID when you configure the SNMP manager.
For an SNMP agent on an Administration Server, the default value is the name of the WebLogic Server domain. For an agent on a Managed Server, the default is the name of the server.
void setSNMPEngineId(java.lang.String engineId)
java.lang.String getAuthenticationProtocol()
The protocol that this SNMP agent uses to ensure that only authorized users can request or receive information about your WebLogic Server domain. Applicable only with SNMPv3.
The protocol also ensures message integrity and prevents masquerading and reordered, delayed, or replayed messages.
To use this protocol when receiving requests from SNMP managers, you must configure credential mapping in the WebLogic Server security realm. To use this protocol when sending responses or notifications, you must configure the security level of your trap destinations.
If you do not choose an authentication protocol, then the SNMP agent does not authenticate incoming SNMPv3 requests; anyone can use SNMPv3 to retrieve information about your WebLogic Server domain.
void setAuthenticationProtocol(java.lang.String protocol)
java.lang.String getPrivacyProtocol()
The protocol that this SNMP agent uses to encrypt and unencrypt messages. Applicable only with SNMPv3. Requires you to also use an authentication protocol.
To use this protocol when sending responses or notifications, you must also configure the security level of your trap destinations.
If you do not choose a privacy protocol, then communication between this agent and managers can be viewed (but not altered) by unauthorized users.
SNMPTrapDestinationMBean.getSecurityLevel()
void setPrivacyProtocol(java.lang.String protocol)
int getInformRetryInterval()
The number of milliseconds that this SNMP agent will wait for a response to an INFORM notification.
If the agent does not receive a response within the specified interval, it will resend the notification.
void setInformRetryInterval(int interval)
int getMaxInformRetryCount()
The maximum number of times that this SNMP agent will resend INFORM notifications for which it has not received a response.
void setMaxInformRetryCount(int retryCount)
long getLocalizedKeyCacheInvalidationInterval()
The number of milliseconds after which WebLogic Server invalidates its cache of SNMP security keys. Setting a high value creates a risk that users whose credentials have been removed can still access SNMP data.
An SNMP security key is an encrypted version of an SNMP agent's engine ID and an authentication password or privacy password. WebLogic Server generates one security key for each entry that you create in the SNMP credential map. When a WebLogic Server SNMP agent receives an SNMPv3 request, it compares the key that is in the request with its WebLogic Server keys. If it finds a match, it processes the request. The SNMP agent also encodes these keys in its responses and notifications. (You configure which keys are encoded when you create a trap destination.)
Instead of regenerating the keys for each SNMPv3 communication, WebLogic Server caches the keys. To make sure that the cache contains the latest set of SNMP credentials, WebLogic Server periodically invalidates the cache. After the cache is invalidated, the next time an SNMP agent requests credentials, WebLogic Server regenerates the cache.
Note that making a change to the credential map does not automatically update the cache. Instead, the cache is updated only after it has been invalidated.
For example, if you update a privacy password in an existing entry in the SNMP credential map, the SNMP agent is not aware of the new password until the key cache is invalidated and regenerated. An SNMP user with the old security password can still access WebLogic Server data until the cache is invalidated.
You can invalidate a key immediately instead of waiting for this invalidation interval to expire.
SNMPAgentRuntimeMBean.invalidateLocalizedKeyCache(String)
,
SNMPTrapDestinationMBean
void setLocalizedKeyCacheInvalidationInterval(long value)
boolean isSNMPAccessForUserMBeansEnabled()
Configures this SNMP agent to provide read-only access to MBean types that you have created and registered (custom MBeans).
If you enable this access, when you register a custom MBean in a WebLogic Server MBeanServer, this SNMP agent dynamically updates a runtime MIB module that WebLogic Server maintains for custom MBeans.
For each custom MBean type, WebLogic Server adds a table to the MIB module. For each instance of the custom MBean, it adds a table row. While WebLogic Server does not persist the MIB as a file or other data structure, the OIDs in the MIB remain constant across server sessions.
The MIB module for custom MBeans is managed by a subAgent. Its master agent is this WebLogic Server SNMP agent and it communicates with the master agent through the AgentX port.
getMasterAgentXPort()
void setSNMPAccessForUserMBeansEnabled(boolean v)
boolean isInformEnabled()
Configures this SNMP agent to send notifications as an INFORM instead of a TRAP. Requires you to specify the agent's SNMPTrapVersion as SNMPv2 or SNMPv3.
When an agent sends an INFORM notification, it waits for a confirmation response from the SNMP manager. If it does not receive a response, it resends the INFORM notification.
getSNMPTrapVersion()
void setInformEnabled(boolean value)
int getMasterAgentXPort()
The port that this SNMP agent uses to communicate with its subagents.
The agent uses subagents to provide access to custom MBeans (MBeans that you create and register) and to other software components. WebLogic Server SNMP agents do not enable users to register their own subagents.
void setMasterAgentXPort(int value)