configure snmpv3 add target-addr

configure snmpv3 add target-addr [[hex hex_addr_name] | addr_name] param [[hex hex_param_name] |param_name ] ipaddress [ ip_address | ipv4-with-mask ip_and_tmask ] | [ ipv6_address | ipv6-with-mask ipv6_and_tmask ]] {transport-port port_number} {from [src_ip_address | src_ipv6_address]} {vr vr_name} {tag-list [tag_list | hex hex_tag_list]} {volatile}

Description

Adds and configures an SNMPv3 target address and associates filtering, security, and notifications with that address.

Syntax Description

hex_addr_name Specifies a string identifier for the target address. The value is to be supplied as a colon separated string of hex octets.
addr_name Specifies a string identifier for the target address in ASCII format.
hex_param_name Specifies the parameter name associated with the target. The value is to be supplied as a colon separated string of hex octets.
param_name Specifies the parameter name associated with the target in ASCII format.
ip_address Specifies an SNMPv3 target IPv4 address.
ipv4-with-mask Specify IPv4 address with hexadecimal mask.
ip_and_tmask Specifies the IPv4 address and hexadecimal mask in form A.B.C.D/NN...
ipv6_address Specifies an SNMPv3 target IPv6 address.
ipv6-with-mask Specify IPv6 address with hexadecimal mask.
ipv6_and_tmask Specifies an IPv6 address and hexadecimal mask in form A:B:C:D:E:F:G:H/NN...
port_number Specifies a UDP port. Default is 162.
src_ip_address Specifies the IPv4 address of a VLAN (Virtual LAN) to be used as the source address for the trap.
src_ipv6_address Specifies the IPv6 address of a VLAN to be used as the source address for the trap.
vr_name Specifies the name of the virtual router.
tag-list Specifies a list of comma separated string identifiers for the notifications to be sent to the target.
hex_tag_list Tag list in RFC 3413 format (in hexadecimal).
volatile Specifies volatile storage. By specifying volatile storage, the configuration is not saved across a switch reboot.

Default

The default values are:
  • transport-port—port 162.

  • non-volatile storage.

If you do not specify tag-list the single tag defaultNotify, a pre-defined value in the snmpNotifyTable is used.

Usage Guidelines

Use this command to create an entry in the SNMPv3 snmpTargetAddressTable. The param parameter associates the target address with an entry in the snmpTargetParamsTable, which specifies security and storage parameters for messages to the target address, and an entry in the snmpNotifyFilterProfileTable, which specifies filter profiles to use for notifications to the target address. The filter profiles are associated with the filters in the snmpNotifyFilterTable.

The list of tag-lists must match one or more of the tags in the snmpNotifyTable for the trap to be sent out.

Example

The following command specifies a target address of 10.203.0.22 with the name A1, and associates it with the security parameters and target address parameter P1:

configure snmpv3 add target-addr A1 param P1 ipaddress 10.203.0.22

The following command specifies a target address of 10.203.0.22 with the name A1, and associates it with the security parameters and target address parameter P1, and the notification tags type1 and type2:

configure snmpv3 add target-addr A1 param P1 ipaddress 10.203.0.22 from 10.203.0.23 tag-list type1,type2

History

This command was first available in ExtremeXOS 10.1.

The virtual router, IP address and hexadecimal mask parameters were added in ExtremeXOS 12.3.

IPv6 support was added in ExtremeXOS 12.4.

The IPv4-with-mask and IPv6-with-mask keywords were added in ExtremeXOS 15.3.2.

The hex keyword and hex_tag_list variable were added in ExtremeXOS 15.6.

Platform Availability

This command is available on the Summit X450-G2, X460-G2, X670-G2, X770, and ExtremeSwitching X440-G2, X620, X690, X870 series switches.