SNMPAgentMBean

Overview  |   Related MBeans  |   Attributes  |   Operations

Overview

This singleton MBean represents an SNMP agent that is scoped to a WebLogic Server domain.

BEA provides this MBean 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.

Fully Qualified Interface Name If you use the getMBeanInfo operation in MBeanTypeServiceMBean, supply the following value as this MBean's fully qualified interface name:
weblogic.management.configuration.SNMPAgentMBean
   
Factory Methods No factory methods. Instances of this MBean are created automatically.    
Subtypes The following MBeans extend or implement this MBean type:

    Related MBeans

    This section describes attributes that provide access to other MBeans. For more information about the MBean hierarchy, refer to WebLogic Server MBean Data Model.

     

    SNMPAttributeChanges

    The SNMPAttributeChangeMBeans which describe the MBean type and Attribute name for which attribute change notification should be sent when an attribute change is observed.

    For more information, see:

    Factory Methods createSNMPAttributeChange (java.lang.String name)

    destroySNMPAttributeChange (SNMPAttributeChangeMBean SNMPAttributeChange)

    Factory methods do not return objects.

    See Using factory methods.    

    Lookup Operation lookupSNMPAttributeChange(String name)

    Returns a javax.management.ObjectName for the instance of SNMPAttributeChangeMBean named name.    

    Privileges Read/Write

    Setter method for this attribute is deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.    

    Type SNMPAttributeChangeMBean[]
    Relationship type: Containment.

     

    SNMPCounterMonitors

    The SNMPCounterMonitorMBeans which describe the criteria for generating notifications based on JMX CounterMonitor.

    For more information, see:

    Factory Methods createSNMPCounterMonitor (java.lang.String name)

    destroySNMPCounterMonitor (SNMPCounterMonitorMBean SNMPCounterMonitor)

    Factory methods do not return objects.

    See Using factory methods.    

    Lookup Operation lookupSNMPCounterMonitor(String name)

    Returns a javax.management.ObjectName for the instance of SNMPCounterMonitorMBean named name.    

    Privileges Read/Write

    Setter method for this attribute is deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.    

    Type SNMPCounterMonitorMBean[]
    Relationship type: Containment.

     

    SNMPGaugeMonitors

    The SNMPGaugeMonitorMBeans which describe the criteria for generating notifications based on JMX GaugeMonitor.

    For more information, see:

    Factory Methods createSNMPGaugeMonitor (java.lang.String name)

    destroySNMPGaugeMonitor (SNMPGaugeMonitorMBean SNMPGaugeMonitor)

    Factory methods do not return objects.

    See Using factory methods.    

    Lookup Operation lookupSNMPGaugeMonitor(String name)

    Returns a javax.management.ObjectName for the instance of SNMPGaugeMonitorMBean named name.    

    Privileges Read/Write

    Setter method for this attribute is deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.    

    Type SNMPGaugeMonitorMBean[]
    Relationship type: Containment.

     

    SNMPLogFilters

    The SNMPLogFilterMBeans which describe filters for generating notifications based on server log messages.

    For more information, see:

    Factory Methods createSNMPLogFilter (java.lang.String name)

    destroySNMPLogFilter (SNMPLogFilterMBean SNMPLogFilter)

    Factory methods do not return objects.

    See Using factory methods.    

    Lookup Operation lookupSNMPLogFilter(String name)

    Returns a javax.management.ObjectName for the instance of SNMPLogFilterMBean named name.    

    Privileges Read/Write

    Setter method for this attribute is deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.    

    Type SNMPLogFilterMBean[]
    Relationship type: Containment.

     

    SNMPProxies

    The SNMP agents for which this SNMP agent is a proxy. SNMPProxyMBeans describe settings for SNMP agents to be proxied by this SNMP agent.

    For more information, see:

    Factory Methods createSNMPProxy (java.lang.String name)

    destroySNMPProxy (SNMPProxyMBean SNMPProxy)

    Factory methods do not return objects.

    See Using factory methods.    

    Lookup Operation lookupSNMPProxy(String name)

    Returns a javax.management.ObjectName for the instance of SNMPProxyMBean named name.    

    Privileges Read/Write

    Setter method for this attribute is deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.    

    Type SNMPProxyMBean[]
    Relationship type: Containment.

     

    SNMPStringMonitors

    The SNMPStringMonitorMBeans which describe the criteria for generating notifications based on JMX StringMonitor.

    For more information, see:

    Factory Methods createSNMPStringMonitor (java.lang.String name)

    destroySNMPStringMonitor (SNMPStringMonitorMBean SNMPStringMonitor)

    Factory methods do not return objects.

    See Using factory methods.    

    Lookup Operation lookupSNMPStringMonitor(String name)

    Returns a javax.management.ObjectName for the instance of SNMPStringMonitorMBean named name.    

    Privileges Read/Write

    Setter method for this attribute is deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.    

    Type SNMPStringMonitorMBean[]
    Relationship type: Containment.

     

    SNMPTrapDestinations

    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.

    Factory Methods createSNMPTrapDestination (java.lang.String name)

    destroySNMPTrapDestination (SNMPTrapDestinationMBean SNMPTrapDestination)

    Factory methods do not return objects.

    See Using factory methods.    

    Lookup Operation lookupSNMPTrapDestination(String name)

    Returns a javax.management.ObjectName for the instance of SNMPTrapDestinationMBean named name.    

    Privileges Read only    
    Type SNMPTrapDestinationMBean[]
    Relationship type: Containment.

     

    TargetedTrapDestinations

    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. 9.0.0.0 Use the getSNMPTrapDestinations() method instead.

       
    Lookup Operation lookupSNMPTrapDestination(String name)

    Returns a javax.management.ObjectName for the instance of SNMPTrapDestinationMBean named name.    

    Privileges Read/Write    
    Type SNMPTrapDestinationMBean[]
    Relationship type: Reference.

    Attributes

    This section describes the following attributes:

     

    AuthenticationProtocol

    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, configure credential mapping in the WebLogic Server security realm. To use this protocol when sending responses or notifications, 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.

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type java.lang.String
    Default Value noAuth
    Legal Values

    • noAuth

    • MD5

    • SHA

     

    CachingDisabled

    Private property that disables caching in proxies.

       
    Privileges Read only    
    Type boolean
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

     

    CommunityBasedAccessEnabled

    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.

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type boolean
    Default Value true

     

    CommunityPrefix

    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.

    You cannot specify a null (empty) value for the community prefix. If you delete the prefix value, WebLogic Server resets the value to public. If you do not want this agent to receive SNMPv1 or v2 requests, instead of trying to set the community prefix to a null value, disable community based access. With community based access disabled, WebLogic Server ignores the community prefix value.

       
    Privileges Read/Write    
    Type java.lang.String
    Default Value public
    Secure value not public

     

    DebugLevel

    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. 10.0.0.0 Use the ServerDebugMBean.DebugSNMPToolkit attribute to configure the SNMP Toolkit debug

       
    Privileges Read/Write    
    Type int
    Default Value 0
    Legal Values

    • 0

    • 1

    • 2

    • 3
    Secure value 0

     

    Enabled

    Whether this SNMP agent is enabled.

       
    Privileges Read/Write    
    Type boolean

     

    InformEnabled

    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.

    For more information, see:

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type boolean

     

    InformRetryInterval

    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.

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type int
    Default Value 10000
    Minimum value 3000
    Maximum value 30000

     

    LocalizedKeyCacheInvalidationInterval

    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.

    For more information, see:

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type long
    Default Value 3600000
    Maximum value 86400000

     

    MasterAgentXPort

    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 BEA software components. WebLogic Server SNMP agents do not enable users to register their own subagents.

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type int
    Default Value 705
    Minimum value 1
    Maximum value 65535

     

    MaxInformRetryCount

    The maximum number of times that this SNMP agent will resend INFORM notifications for which it has not received a response.

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type int
    Default Value 1
    Minimum value 1
    Maximum value 3

     

    MBeanInfo

    Returns the MBean info for this MBean.

    Deprecated.

       
    Privileges Read only    
    Type javax.management.MBeanInfo
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

     

    MibDataRefreshInterval

    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.

    Deprecated. 10.0.0.0 There is no replacement for this attribute.

       
    Privileges Read/Write    
    Type int
    Default Value 120
    Minimum value 30
    Maximum value 65535

     

    Name of

    The user-specified name of this MBean instance.

    This name is included as one of the key properties in the MBean's javax.management.ObjectName:
    Name of=user-specified-name

       
    Privileges Read/Write    
    Type java.lang.String

     

    Notes

    Optional information that you can include to describe this configuration.

    WebLogic Sever saves this note in the domain's configuration file (config.xml) as XML PCDATA. All left angle brackets (<) are converted to the XML entity &lt;. Carriage returns/line feeds are preserved.

    Note:

    If you create or edit a note from the Administration Console, the Administration Console does not preserve carriage returns/line feeds.

       
    Privileges Read/Write    
    Type java.lang.String

     

    ObjectName

    Returns the ObjectName under which this MBean is registered in the MBean server.

    Deprecated.

       
    Privileges Read only    
    Type weblogic.management.WebLogicObjectName
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

     

    Parent

    Return the immediate parent for this MBean

       
    Privileges Read/Write    
    Type

     

    PrivacyProtocol

    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, 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.

    For more information, see:

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type java.lang.String
    Default Value noPriv
    Legal Values

    • noPriv

    • DES

    • AES_128

     

    Registered

    Returns false if the the MBean represented by this object has been unregistered.

    Deprecated.

       
    Privileges Read only    
    Type boolean
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

     

    SendAutomaticTrapsEnabled

    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.

    For more information, see:

       
    Privileges Read/Write    
    Type boolean
    Default Value true

     

    ServerStatusCheckIntervalFactor

    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 SNMPAgentMBean#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.

    Deprecated. 10.0.0.0 There is no replacement for this attribute.

       
    Privileges Read/Write    
    Type int
    Default Value 1
    Minimum value 1
    Maximum value 65535

     

    SNMPAccessForUserMBeansEnabled

    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.

    For more information, see:

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type boolean

     

    SNMPEngineId

    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, 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.

    Available Since Release 10.0.0.0    
    Privileges Read/Write    
    Type java.lang.String

     

    SNMPPort

    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.

    For more information, see:

       
    Privileges Read/Write    
    Type int
    Default Value 161
    Minimum value 1
    Maximum value 65535

     

    SNMPTrapVersion

    The SNMP notification version that this SNMP agent generates.

    For more information, see:

       
    Privileges Read/Write    
    Type int
    Default Value 1
    Legal Values

    • 1

    • 2

    • 3

     

    Type

    Returns the type of the MBean.

       
    Privileges Read only    
    Type java.lang.String
    Redeploy or Restart required Changes take effect after you redeploy the module or restart the server.

    Operations

    This section describes the following operations:

     

    addSNMPAttributeChange

    Adds a feature to the SNMPAttributeChange attribute of the SNMPAgentMBean object

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "addSNMPAttributeChange"    
    Parameters Object [] {  attrchange }

    where:

    • attrchange is an object of type weblogic.management.configuration.SNMPAttributeChangeMBean that specifies:

      The feature to be added to the SNMPAttributeChange attribute

    Signature String [] { "weblogic.management.configuration.SNMPAttributeChangeMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    addSNMPCounterMonitor

    Adds a feature to the SNMPCounterMonitor attribute of the SNMPAgentMBean object

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "addSNMPCounterMonitor"    
    Parameters Object [] {  countermonitor }

    where:

    • countermonitor is an object of type weblogic.management.configuration.SNMPCounterMonitorMBean that specifies:

      The feature to be added to the SNMPCounterMonitor attribute

    Signature String [] { "weblogic.management.configuration.SNMPCounterMonitorMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    addSNMPGaugeMonitor

    Adds a feature to the SNMPGaugeMonitor attribute of the SNMPAgentMBean object

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "addSNMPGaugeMonitor"    
    Parameters Object [] {  gaugemonitor }

    where:

    • gaugemonitor is an object of type weblogic.management.configuration.SNMPGaugeMonitorMBean that specifies:

      The feature to be added to the SNMPGaugeMonitor attribute

    Signature String [] { "weblogic.management.configuration.SNMPGaugeMonitorMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    addSNMPLogFilter

    Adds a feature to the SNMPLogFilter attribute of the SNMPAgentMBean object

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "addSNMPLogFilter"    
    Parameters Object [] {  logfilter }

    where:

    • logfilter is an object of type weblogic.management.configuration.SNMPLogFilterMBean that specifies:

      The feature to be added to the SNMPLogFilter attribute

    Signature String [] { "weblogic.management.configuration.SNMPLogFilterMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    addSNMPProxy

    Adds a feature to the SNMPProxy attribute of the SNMPAgentMBean object

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "addSNMPProxy"    
    Parameters Object [] {  snmpProxy }

    where:

    • snmpProxy is an object of type weblogic.management.configuration.SNMPProxyMBean that specifies:

      The feature to be added to the SNMPProxy attribute

    Signature String [] { "weblogic.management.configuration.SNMPProxyMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    addSNMPStringMonitor

    Adds a single SNMPStringMonitorMBeans to this SNMP agent's collection.

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    For more information, see:

    Operation Name "addSNMPStringMonitor"    
    Parameters Object [] {  stringmonitor }

    where:

    • stringmonitor is an object of type weblogic.management.configuration.SNMPStringMonitorMBean that specifies:

      The feature to be added to the SNMPStringMonitor attribute

    Signature String [] { "weblogic.management.configuration.SNMPStringMonitorMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    addSNMPTrapDestination

    Adds an SNMPTrapDestination to the SNMPAgentMBean object

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "addSNMPTrapDestination"    
    Parameters Object [] {  trapdestination }

    where:

    • trapdestination is an object of type weblogic.management.configuration.SNMPTrapDestinationMBean that specifies:

      The feature to be added to the SNMPTrapDestination attribute

    Signature String [] { "weblogic.management.configuration.SNMPTrapDestinationMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    addTargetedTrapDestination

    Adds a single trap destination to this SNMP agent's list of targeted trap destinations.

    Deprecated. 9.0.0.0

    For more information, see:

    Operation Name "addTargetedTrapDestination"    
    Parameters Object [] {  trapdestination }

    where:

    • trapdestination is an object of type weblogic.management.configuration.SNMPTrapDestinationMBean that specifies:

      The feature to be added to the TargetedTrapDestination attribute

    Signature String [] { "weblogic.management.configuration.SNMPTrapDestinationMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    freezeCurrentValue

    If the specified attribute has not been set explicitly, and if the attribute has a default value, this operation forces the MBean to persist the default value.

    Unless you use this operation, the default value is not saved and is subject to change if you update to a newer release of WebLogic Server. Invoking this operation isolates this MBean from the effects of such changes.

    Note:

    To insure that you are freezing the default value, invoke the restoreDefaultValue operation before you invoke this.

    This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute for which some other value has been set.

    Deprecated. 9.0.0.0

    Operation Name "freezeCurrentValue"    
    Parameters Object [] {  attributeName }

    where:

    • attributeName is an object of type java.lang.String that specifies:

      attributeName

    Signature String [] { "java.lang.String" }
    Returns void
    Exceptions

    • javax.management.AttributeNotFoundException

    • javax.management.MBeanException

     

    isSet

    Returns true if the specified attribute has been set explicitly in this MBean instance.

    Operation Name "isSet"    
    Parameters Object [] {  propertyName }

    where:

    • propertyName is an object of type java.lang.String that specifies:

      property to check

    Signature String [] { "java.lang.String" }
    Returns boolean

     

    removeSNMPAttributeChange

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "removeSNMPAttributeChange"    
    Parameters Object [] {  attrchange }

    where:

    • attrchange is an object of type weblogic.management.configuration.SNMPAttributeChangeMBean that specifies:

      attrchange

    Signature String [] { "weblogic.management.configuration.SNMPAttributeChangeMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    removeSNMPCounterMonitor

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "removeSNMPCounterMonitor"    
    Parameters Object [] {  countermonitor }

    where:

    • countermonitor is an object of type weblogic.management.configuration.SNMPCounterMonitorMBean that specifies:

      countermonitor

    Signature String [] { "weblogic.management.configuration.SNMPCounterMonitorMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    removeSNMPGaugeMonitor

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "removeSNMPGaugeMonitor"    
    Parameters Object [] {  gaugemonitor }

    where:

    • gaugemonitor is an object of type weblogic.management.configuration.SNMPGaugeMonitorMBean that specifies:

      gaugemonitor

    Signature String [] { "weblogic.management.configuration.SNMPGaugeMonitorMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    removeSNMPLogFilter

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "removeSNMPLogFilter"    
    Parameters Object [] {  logfilter }

    where:

    • logfilter is an object of type weblogic.management.configuration.SNMPLogFilterMBean that specifies:

      logfilter

    Signature String [] { "weblogic.management.configuration.SNMPLogFilterMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    removeSNMPProxy

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "removeSNMPProxy"    
    Parameters Object [] {  snmpProxy }

    where:

    • snmpProxy is an object of type weblogic.management.configuration.SNMPProxyMBean that specifies:

      snmpProxy

    Signature String [] { "weblogic.management.configuration.SNMPProxyMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    removeSNMPStringMonitor

    Deprecated. 9.0.0.0 Instead, use standard JMX design patterns using <code>javax.management.MBeanServerConnection</code> interface.

    Operation Name "removeSNMPStringMonitor"    
    Parameters Object [] {  stringmonitor }

    where:

    • stringmonitor is an object of type weblogic.management.configuration.SNMPStringMonitorMBean that specifies:

      stringmonitor

    Signature String [] { "weblogic.management.configuration.SNMPStringMonitorMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    removeTargetedTrapDestination

    Deprecated. 9.0.0.0

    Operation Name "removeTargetedTrapDestination"    
    Parameters Object [] {  trapdestination }

    where:

    • trapdestination is an object of type weblogic.management.configuration.SNMPTrapDestinationMBean that specifies:

      trapdestination

    Signature String [] { "weblogic.management.configuration.SNMPTrapDestinationMBean" }
    Returns boolean
    Exceptions

    • javax.management.InvalidAttributeValueException

    • weblogic.management.configuration.ConfigurationException

     

    restoreDefaultValue

    If the specified attribute has a default value, this operation removes any value that has been set explicitly and causes the attribute to use the default value.

    Default values are subject to change if you update to a newer release of WebLogic Server. To prevent the value from changing if you update to a newer release, invoke the freezeCurrentValue operation.

    This operation has no effect if you invoke it on an attribute that does not provide a default value or on an attribute that is already using the default.

    Deprecated. 9.0.0.0

    Operation Name "restoreDefaultValue"    
    Parameters Object [] {  attributeName }

    where:

    • attributeName is an object of type java.lang.String that specifies:

      attributeName

    Signature String [] { "java.lang.String" }
    Returns void
    Exceptions

    • javax.management.AttributeNotFoundException

     

    unSet

    Restore the given property to its default value.

    Operation Name "unSet"    
    Parameters Object [] {  propertyName }

    where:

    • propertyName is an object of type java.lang.String that specifies:

      property to restore

    Signature String [] { "java.lang.String" }
    Returns void