SNMP Trap Groups Commands

snmp-trap-group

Syntax

[no] snmp-trap-group log-id

Context

config>log

Description

This command enables the context to configure a group of SNMP trap receivers and their operational parameters for a specified log-id.

A trap group specifies the types of SNMP traps and specifies the log ID that will receive the group of SNMP traps. A trap group must be configured in order for SNMP traps to be sent.

To suppress the generation of all alarms and traps, see the event-control command. To suppress alarms and traps that are sent to this log-id, see the filter (log destination) command. When alarms and traps are generated, they can be directed to one or more SNMP trap groups. Logger events that can be forwarded as SNMP traps are always defined on the main event source.

The no form of the command deletes the SNMP trap group.

Default

There are no default SNMP trap groups.

Parameters

log-id

the log ID value of a log configured in the to snmp context. Alarms and traps cannot be sent to the trap receivers until a valid log-id exists.

Values

1 to 99

trap-target

Syntax

trap-target name address ip-address [port port] [snmpv1 | snmpv2c | snmpv3] notify-community {communityName | snmpv3SecurityName} [security-level {no-auth-no-privacy | auth-no-privacy | privacy}]

no trap-targetname

Context

config>log>snmp-trap-group

Description

This command adds or modifies a trap receiver and configures the operational parameters for the trap receiver. A trap reports significant events that occur on a 7705 SAR, such as errors or failures.

Before an SNMP trap can be issued to a trap receiver, the to console, snmp-trap-group, and at least one trap-target must be configured.

The trap-target command is used to add or remove a trap receiver from an snmp-trap-group. The operational parameters specified in the command include:

  • the IP address of the trap receiver

  • the UDP port used to send the SNMP trap

  • SNMP version

  • SNMP community name for SNMPv1 and SNMPv2c receivers

  • security name and level for SNMPv3 trap receivers

A single snmp-trap-group log-id can have multiple trap receivers. Each trap receiver can have different operational parameters.

An address can be configured as a trap receiver more than once as long as a different port is used for each instance.

To prevent resource limitations, only configure a maximum of 10 trap receivers.

Note:

If the same trap-target name port portparameter value is specified in more than one SNMP trap group, each trap destination should be configured with a different notify-community value. This allows a trap receiving an application, such as NMS, to reconcile a separate event sequence number stream for each 7705 SAR event log when multiple event logs are directed to the same IP address and port destination.

The no form of the command removes the SNMP trap receiver from the SNMP trap group.

Default

No SNMP trap targets are defined.

Parameters

name

specifies the name of the trap target, up to 28 characters in length

ip-address

the IP address of the trap receiver. Only one IP address destination can be specified per trap destination group.

Values

ipv4-address a.b.c.d

ipv6-address x:x:x:x:x:x:x:x (eight 16-bit pieces)

x:x:x:x:x:x:d.d.d.d

x: [0 to FFFF]H

d: [0 to 255]D

port

the destination UDP port used for sending traps to the destination, expressed as a decimal integer. Only one port can be specified per trap-target statement. If multiple traps need to be issued to the same address, multiple ports must be configured.

Values

0 to 65535

Default

162

snmpv1 | snmpv2c | snmpv3

specifies the SNMP version format to use for traps sent to the trap receiver

Values

snmpv1

Selects the SNMP version 1 format. When specifying snmpv1, the notify-community parameter must be configured for the correct SNMP community string that the trap receiver expects to be present in alarms and traps messages. If the SNMP version is changed from snmpv3 to snmpv1, then the notify-community parameter must be changed to reflect the community string instead of the snmpv3securityName that is used by snmpv3.

snmpv2c

Selects the SNMP version 2c format. When specifying snmpv2c, the notify-community parameter must be configured for the correct SNMP community string that the trap receiver expects to be present in alarms and traps messages. If the SNMP version is changed from snmpv3 to snmpv2c, then the notify-community parameter must be changed to reflect the community string instead of the security-name that is used by snmpv3.

snmpv3

Selects the SNMP version 3 format. When specifying snmpv3, the notify-community parameter must be configured for the SNMP security-name. If the SNMP version is changed from snmpv1 or snmpv2c to snmpv3, then the notify-community parameter must be changed to reflect the security-nameinstead of the community string used by snmpv1 or snmpv2c.

Default

snmpv3

notify-community communityName | snmpv3SecurityName

specifies the community string for snmpv1 or snmpv2c, or the snmpv3 security-name. If no notify-community parameter is configured, then no alarms or traps are issued for the trap destination. If the SNMP version is modified, the notify-community parameter must be changed to the correct form for the SNMP version.

Values

communityName

the community string as required by the snmpv1 or snmpv2c trap receiver. The community string can be an ASCII string up to 32 characters in length

snmpv3SecurityName

the security name as defined in the config>system>security>user context for SNMP v3. The snmpv3SecurityName can be an ASCII string up to 32 characters in length

security-level {no-auth-no-privacy | auth-no-privacy | privacy}

specifies the required authentication and privacy levels required to access the views configured on this node when configuring an snmpv3 trap receiver.

Values

no-auth-no-privacy

Specifies that no authentication and no privacy (encryption) are required.

auth-no-privacy

Specifies that authentication is required but no privacy (encryption) is required. When this option is configured, the security-name must be configured for authentication.

privacy

Specifies that both authentication and privacy (encryption) are required. When this option is configured, the security-name must be configured for authentication and privacy.

Default

No default. The security level must be specified when configuring an SNMPv3 trap receiver.