3.11 SyncSet

Use this Knowledge Script to set one or more SNMP attributes on one or more SNMP-enabled devices to the specified values. The values can be of different types. However, so that the value types can be determined, the SNMP proxy agent computer that executes the script must have the MIB available for the specified attributes even if numeric OIDs are supplied. If the MIB for the specified attributes is not available, an SNMP Failure event is raised. Although requiring the MIB to be installed is a restriction, it does allow the flexibility to easily set multiple SNMP attributes of different types from a single script.

This script attempts to set the specified attributes on all supplied SNMP devices, regardless of whether any or all of the attempts fail. If failures do occur, successful sets on other devices cannot be reversed or backed out.

Collected data for this script is a Boolean value that specifies whether the SNMP Set operation failed or succeeded.

3.11.1 Resource Objects

SNMP Device objects

3.11.2 Default Schedule

By default, this script runs once.

3.11.3 Setting Parameter Values

Set the following parameters as needed:

Parameter

How to Set It

SNMP ODE/OIDs

Supply a list of ODEs and/or OIDs. The default is “sysContact.0”.

SNMP values (comma-separated)

Supply a comma-separated list of SNMP attribute values. As some SNMP values could be text strings, commas must be used as separators rather than spaces. The list must contain the same number of items as the SNMP ODE/OIDs parameter, and should be in the order corresponding to their respective attribute. The default is “Your System Administrator”.

SNMP port number

Specify the UDP port number on the remote SNMP device to which you want to send SNMP requests. The default is 161.

SNMP retries

Specify the number of retries to attempt if a timeout occurs on an SNMP request. The default is 0 retries.

SNMP timeout

Specify the number of seconds to wait for a response before timing out an SNMP request. The default is 5 seconds.

Set success

Collect data for Set success?

Set to Yes to collect data for use in graphs and reports. The data is stored in the AppManager repository. When enabled, returns a data stream containing a Boolean value representing whether the Set request succeeded or failed.

Raise event if Set success not equal to threshold?

Set to Yes to raise an event if the result of the Set request is not equal to the threshold. The default is Yes.

Threshold – Set success

Set this value to one of the following:

  • 1 -- the Set request succeeds

  • 0 -- the Set request does not succeed.

The default is 1 (success).

Event severity when Set success not equal to threshold

Set the severity level, from 1 to 40, to indicate the importance of an event in which Set success is not equal to the threshold you set. The default is 15.

Event Notification

Raise event if SNMP operation succeeds?

Set to Yes to raise an event if the SNMP Set operation is successful. The details of the event contain the list of attributes you set.

Event severity when SNMP operation succeeds

Set the severity level, from 1 to 40, to indicate the importance of an event in which the SNMP Set operation succeeds. The default is 25.

Raise event if SNMP timeout exceeded?

Set to Yes to raise an event if the SNMP Set request receives no response from the device, and all retries fail.

Event severity when SNMP timeout exceeded

Set the severity level, from 1 to 40, to indicate the importance of an event in which the SNMP timeout interval is exceeded. The default is 15.

Raise event if SNMP Response error received?

Set to Yes to raise an event if an SNMP Response error is received from the device. The type of error is reported in the event details.

Event severity when SNMP Response error received

Set the severity level, from 1 to 40, to indicate the importance of an event in which an SNMP Response error is received. The default is 10.