configure snmpv3 add filter

configure snmpv3 add filter [[hex hex_profile_name] | profile_name] subtree object_identifier {/subtree_mask} type [included | excluded] {volatile}

Description

Adds a filter to a filter profile.

Syntax Description

hex_profile_name Specifies the filter profile that the current filter is added to. The value is to be supplied as a colon separated string of hex octets.
profile_name Specifies the filter profile that the current filter is added to in ASCII format.
object identifier Specifies a MIB subtree.
subtree_mask Specifies a hex octet string used to mask the subtree. For example, f7a indicates 1.1.1.1.0.1.1.1.1.0.1.0.
included Specifies that the MIB subtree defined by object identifier/mask is to be included.
excluded Specifies that the MIB subtree defined by object identifier/mask is to be excluded.
volatile Specifies volatile storage.

Default

The default values are:
  • mask value—empty string (all 1s).

  • type—included.

  • storage—non-volatile.

Usage Guidelines

Use this command to create a filter entry in the snmpNotifyFilterTable. Each filter includes or excludes a portion of the MIB. Multiple filter entries comprise a filter profile that can eventually be associated with a target address. Other commands are used to associate a filter profile with a parameter name, and the parameter name with a target address.

This command can be used multiple times to configure the exact filter profile desired.

Example

The following command adds a filter to the filter profile prof1 that includes the MIB subtree 1.3.6.1.4.1/f0:

configure snmpv3 add filter prof1 subtree 1.3.6.1.4.1/f0 type included

History

This command was first available in ExtremeXOS 10.1.

The hex_profile_name parameter was added in ExtremeXOS 11.0.

Platform Availability

This command is available on the ExtremeSwitching X435, X440-G2, X450-G2, X460-G2, X465, X590, X620, X670-G2, X690, X695, and X870 series switches.