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 | ip_and_tmask ] | [ ipv6_address | 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.
`ipv6_address`	Specifies an SNMPv3 target IPv6 address.
`port_number`	Specifies a UDP port. Default is 162.
`src_ip_address`	Specifies the IPv4 address of a VLAN 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.

The IPv4-with-mask and IPv6-with-mask keywords were removed in version 32.7.1.

Platform Availability

This command is available on all Universal switches supported in this document.