ADC CLI Commands

snmp-trap

The following operations can be performed on “snmp-trap”:

show unset bind set add unbind rm

show snmp trap

Displays the settings of all trap listeners or of the specified trap listener. To display the settings of all the trap listeners, run the command without any parameters. To display the settings of a particular trap listener, specify the trapClass (Trap Type) and trapDestination (IP Address) of the trap listener.

Synopsis

show snmp trap [ [-version ] [-td ]]

Arguments

trapClass Trap type specified in the trap listener entry.

Possible values: generic, specific

trapDestination IP address specified in the trap listener entry.

version The SNMP version of the trap specified in the trap listener entry.

Possible values: V1, V2, V3

td Integer value that uniquely identifies the traffic domain in which you want to configure the entity. If you do not specify an ID, the entity becomes part of the default traffic domain, which has an ID of 0. Minimum value: 0 Maximum value: 4094

Output

destPort The destination port of the SNMP trap.

communityName Password (string) sent with the trap messages, so that the trap listener can authenticate them. Can include 1 to 31 uppercase or lowercase letters, numbers, and hyphen (-), period (.) pound (#), space ( ), at (@), equals (=), colon (:), and underscore (_) characters. You must specify the same community string on the trap listener device. Otherwise, the trap listener drops the trap messages.

The following requirement applies only to the Citrix ADC CLI: If the string includes one or more spaces, enclose the name in double or single quotation marks (for example, “my string” or ‘my string’).

srcIP The source IP of the SNMP trap to be sent.

severity The minimum severity of traps to be sent to this destination.

allPartitions Send traps of all partitions to this destination.

userName Name of the SNMP user that will send the SNMPv3 traps.

securityLevel Security level of the SNMPv3 trap.

stateflag devno count

Example

show snmp trap

unset snmp trap

Resets the specified parameters to their default settings in a trap-listener entry..Refer to the set snmp trap command for meanings of the arguments.

Synopsis

unset snmp trap [-version ] [-td ] [-destPort] [-communityName] [-srcIP] [-severity] [-allPartitions]

Example

unset snmp trap generic 192.168.3.4 -version V1 -severity

bind snmp trap

Binds an SNMPv3 trap to an SNMP user.

Synopsis

bind snmp trap [-td ] [-version ] (-userName [-securityLevel ])

Arguments

trapClass Type of trap messages that the Citrix ADC sends to the trap listener: Generic or the enterprise-specific messages defined in the MIB file.

Possible values: generic, specific

trapDestination IPv4 or the IPv6 address of the trap listener to which the Citrix ADC is to send SNMP trap messages.

td Integer value that uniquely identifies the traffic domain in which you want to configure the entity. If you do not specify an ID, the entity becomes part of the default traffic domain, which has an ID of 0. Minimum value: 0 Maximum value: 4094

version SNMP version, which determines the format of trap messages sent to the trap listener. This setting must match the setting on the trap listener. Otherwise, the listener drops the trap messages.

Possible values: V1, V2, V3 Default value: V3

userName Name of the SNMP user that will send the SNMPv3 traps.

securityLevel Security level of the SNMPv3 trap.

Possible values: noAuthNoPriv, authNoPriv, authPriv Default value: authNoPriv,

set snmp trap

Modifies the specified parameters in a trap-listener entry.

Synopsis

set snmp trap [-version ] [-td ] [-destPort ] [-communityName ] [-srcIP <ip_addr|ipv6_addr>] [-severity ] [-allPartitions ( ENABLED | DISABLED )]

Arguments

trapClass Type of trap specified in the trap-listener entry. Because this parameter is used for identifying the trap listener entry, it cannot be modified after the entry has been created.

Possible values: generic, specific

trapDestination IPv4 or the IPv6 address of the trap listener to which the Citrix ADC is to send SNMP trap messages.

version SNMP version, which determines the format of trap messages sent to the trap listener. This setting must match the setting on the trap listener. Otherwise, the listener drops the trap messages.

Possible values: V1, V2, V3 Default value: V2

td Integer value that uniquely identifies the traffic domain in which you want to configure the entity. If you do not specify an ID, the entity becomes part of the default traffic domain, which has an ID of 0. Minimum value: 0 Maximum value: 4094

destPort UDP port at which the trap listener listens for trap messages. This setting must match the setting on the trap listener. Otherwise, the listener drops the trap messages. Default value: 162 Minimum value: 1 Maximum value: 65534

communityName Password (string) sent with the trap messages, so that the trap listener can authenticate them. Can include 1 to 31 uppercase or lowercase letters, numbers, and hyphen (-), period (.) pound (#), space ( ), at (@), equals (=), colon (:), and underscore (_) characters. You must specify the same community string on the trap listener device. Otherwise, the trap listener drops the trap messages.

The following requirement applies only to the Citrix ADC CLI: If the string includes one or more spaces, enclose the name in double or single quotation marks (for example, “my string” or ‘my string’).

srcIP IPv4 or IPv6 address that the Citrix ADC inserts as the source IP address in all SNMP trap messages that it sends to this trap listener. By default this is the appliance’s NSIP or NSIP6 address, but you can specify an IPv4 MIP or SNIP/SNIP6 address. In cluster setup, the default value is the individual node’s NSIP, but it can be set to CLIP or Striped SNIP address. In non default partition, this parameter must be set to the SNIP/SNIP6 address.

severity Severity level at or above which the Citrix ADC sends trap messages to this trap listener. The severity levels, in increasing order of severity, are Informational, Warning, Minor, Major, Critical. This parameter can be set for trap listeners of type SPECIFIC only. The default is to send all levels of trap messages. Important: Trap messages are not assigned severity levels unless you specify severity levels when configuring SNMP alarms.

Possible values: Critical, Major, Minor, Warning, Informational Default value: Unknown

allPartitions Send traps of all partitions to this destination.

Possible values: ENABLED, DISABLED Default value: DISABLED

Example

set snmp trap generic 192.168.3.4 -version V1 -severity Critical

add snmp trap

Adds an SNMP trap listener. You can configure the Citrix ADC to generate asynchronous events (trap messages) to report abnormal conditions. The trap messages are sent to a remote device (trap listener) to help administrators monitor the appliance and respond promptly to any issues.

Synopsis

add snmp trap ... [-version ] [-td ] [-destPort ] [-communityName ] [-srcIP <ip_addr|ipv6_addr>] [-severity ] [-allPartitions ( ENABLED | DISABLED )]

Arguments

trapClass Type of trap messages that the Citrix ADC sends to the trap listener: Generic or the enterprise-specific messages defined in the MIB file.

Possible values: generic, specific

trapDestination IPv4 or the IPv6 address of the trap listener to which the Citrix ADC is to send SNMP trap messages.

version SNMP version, which determines the format of trap messages sent to the trap listener. This setting must match the setting on the trap listener. Otherwise, the listener drops the trap messages.

Possible values: V1, V2, V3 Default value: V2

td Integer value that uniquely identifies the traffic domain in which you want to configure the entity. If you do not specify an ID, the entity becomes part of the default traffic domain, which has an ID of 0. Minimum value: 0 Maximum value: 4094

destPort UDP port at which the trap listener listens for trap messages. This setting must match the setting on the trap listener. Otherwise, the listener drops the trap messages. Default value: 162 Minimum value: 1 Maximum value: 65534

communityName Password (string) sent with the trap messages, so that the trap listener can authenticate them. Can include 1 to 31 uppercase or lowercase letters, numbers, and hyphen (-), period (.) pound (#), space ( ), at (@), equals (=), colon (:), and underscore (_) characters. You must specify the same community string on the trap listener device. Otherwise, the trap listener drops the trap messages.

The following requirement applies only to the Citrix ADC CLI: If the string includes one or more spaces, enclose the name in double or single quotation marks (for example, “my string” or ‘my string’).

srcIP IPv4 or IPv6 address that the Citrix ADC inserts as the source IP address in all SNMP trap messages that it sends to this trap listener. By default this is the appliance’s NSIP or NSIP6 address, but you can specify an IPv4 MIP or SNIP/SNIP6 address. In cluster setup, the default value is the individual node’s NSIP, but it can be set to CLIP or Striped SNIP address. In non default partition, this parameter must be set to the SNIP/SNIP6 address.

severity Severity level at or above which the Citrix ADC sends trap messages to this trap listener. The severity levels, in increasing order of severity, are Informational, Warning, Minor, Major, Critical. This parameter can be set for trap listeners of type SPECIFIC only. The default is to send all levels of trap messages. Important: Trap messages are not assigned severity levels unless you specify severity levels when configuring SNMP alarms.

Possible values: Critical, Major, Minor, Warning, Informational Default value: Unknown

allPartitions Send traps of all partitions to this destination.

Possible values: ENABLED, DISABLED Default value: DISABLED

unbind snmp trap

Unbind snmp user to a V3 trap

Synopsis

unbind snmp trap [-td ] [-version ] -userName

Arguments

trapClass Type of trap messages that the Citrix ADC sends to the trap listener: Generic or the enterprise-specific messages defined in the MIB file.

Possible values: generic, specific

trapDestination IPv4 or the IPv6 address of the trap listener to which the Citrix ADC is to send SNMP trap messages.

td Integer value that uniquely identifies the traffic domain in which you want to configure the entity. If you do not specify an ID, the entity becomes part of the default traffic domain, which has an ID of 0. Minimum value: 0 Maximum value: 4094

version SNMP version, which determines the format of trap messages sent to the trap listener. This setting must match the setting on the trap listener. Otherwise, the listener drops the trap messages.

Possible values: V1, V2, V3 Default value: V3

userName Name of the SNMP user that will send the SNMPv3 traps.

rm snmp trap

Removes a trap listener entry from the Citrix ADC.

Synopsis

rm snmp trap ... [-version ] [-td ]

Arguments

trapClass Trap type specified in the trap listener entry that you want to remove.

Possible values: generic, specific

trapDestination IP address of the trap listener specified in the trap listener entry that you want to remove.

version Version of the trap specified in the trap listener entry that you want to remove.

Possible values: V1, V2, V3 Default value: V2

td Integer value that uniquely identifies the traffic domain in which you want to configure the entity. If you do not specify an ID, the entity becomes part of the default traffic domain, which has an ID of 0. Minimum value: 0 Maximum value: 4094

snmp-trap