Detailed descriptions of configuration parameters in the trapd.conf file presents detailed descriptions of the configuration parameters in the trapd.conf file. Any line in the trapd.conf file that is preceded with a pound sign is read as a comment. Remove the pound sign to uncomment the line.

Table 1. Detailed descriptions of configuration parameters in the trapd.conf file

Parameter

Description

PORT

UDP port number on which the built-in trap receiver or trap adapter listens for traps.

Valid values are 162 or integers in the range 2049 to 65534 inclusive. The default port is 9000.

WINDOW

De-duplication window, in seconds. The maximum amount of time between the receiving of similar traps before the second trap is considered unique.

Valid values are nonnegative integers, including 0. The default is 10.

If not set or set to 0, the de-duplication feature is disabled, which means that all traps are considered unique.

THREADS

Number of trap-processing threads to spawn. This number determines how many traps can be processed concurrently.

Valid values are integers in the range 1 to 25 inclusive. The default is 1.

If not set, the number of trap-processing threads is 1.

ASCII

No longer used; should remain FALSE (default).

SOURCE

Determines whether the source address of the IP packet that contains the trap is printed or not printed. Printing the source address of the IP packet makes the source address available to customer-configurable .conf files and ASL scripts.

Valid values are TRUE and FALSE. The default is FALSE.

  • When TRUE, source address of IP packet is printed.

  • When FALSE, source address of IP packet is not printed.

TAG

Enables the tagging of variable-binding (varbind) values.

Valid values are TRUE and FALSE. The default is FALSE.

  • When TRUE, the type of the varbind value appears before each value; for example, INTEGER-32 3.

  • When FALSE, the type of the varbind value does not appear before each value.

ENABLE_FWD

Determines whether uncommented FORWARD parameters are enabled or disabled.

Valid values are TRUE and FALSE. The default is TRUE.

  • When TRUE, uncommented FORWARD parameters are enabled: Trap forwarding statements that are specified in uncommented FORWARD parameters are read.

  • When FALSE, uncommented FORWARD parameters are disabled: Trap forwarding statements that are specified in uncommented FORWARD parameters are not read.

MATCH

Determines whether an incoming trap is tested against all matching criteria that are specified in an uncommented FORWARD parameter, or tested up to the first criterion that matches.

Valid values are “all” or “first.” The default is “all.”

If no uncommented FORWARD parameters are specified, the MATCH parameter is ignored.

QUEUE_LIMIT_MEGS

Limits the size of internal trap queue to the stated size, in megabytes.

Valid values are nonnegative integers, including 0. The default is 0, which means that there is no limit on the size of the internal trap queue.

Note:

The limit is not exact: The queue can grow slightly larger than the specified value.

When the limit is reached, some traps will be discarded.

QUEUE_LIMIT_SECONDS

Limits the time that a trap can spend in the internal trap queue, in seconds.

Valid values are nonnegative integers, including 0. The default is 0, which means that there is no limit on the time that a trap can spend in the internal trap queue.

Note:

This limit is even less exact than the limit set for QUEUE_LIMIT_MEGS. In general, you should specify values for both QUEUE_LIMIT_MEGS and QUEUE_LIMIT_SECONDS.

When the limit is reached, some traps will be discarded.

TIMESTAMP_RCV

Determines whether to send the actual received time of the incoming trap to ASL, or to send the timestamp in the incoming trap to ASL.

Valid values are TRUE and FALSE. The default is FALSE.

  • When TRUE, send the actual time that the trap was received.

  • When FALSE, send the timestamp in the trap. This timestamp is in the normal SNMP time format of hundredths of a second since the source device for the trap last initialized or reinitialized.

FORWARD

Specifies the matching criteria for incoming traps and the forwarding destinations for matched traps.

Valid syntax is:

<source device address> <OID> <generic type> <specific type> \     <destination host address>[:<port>|:<port>:<community>] \          [<destination host address>[:<port>|:<port>:<community>]] ...

where:

  • <source device address> is the IP address (IPv4, IPv6) of the object (SNMP agent) that is generating the trap.

  • <OID> is the sysObjectID of the type of object that is generating the trap.

  • <generic type> is the generic trap type:

    0 coldStart

    1 warmStart

    2 linkDown

    3 linkUp

    4 authenticationFailure

    5 egpNeighborLoss

    6 enterpriseSpecific

    Valid syntax for <generic type> is a generic specific trap number (for example, 3), a range of generic specific trap numbers (for example, <3-5>), or any generic specific trap number (for example, *). An asterisk is a wildcard character that matches any arbitrary string of characters.

  • <specific type> is the specific trap code, present even if <generic type> is not enterpriseSpecific (6).

    Valid syntax for <specific type> is an enterprise specific trap number (for example, 733), a range of enterprise specific trap numbers (for example, <130-156>), or any enterprise specific trap number (for example, *).

FORWARD(continued)

  • <destination host address> is the IP address (for example, [3FFE:80C0:22C:101:219:56FF:FE3F:8A50] or 192.35.144.12) or the hostname (for example, myserver.example.com::v6) of the destination host. An IPv6 address must be enclosed in brackets ([ ]).

    The syntax for hostname is described in"Controlling the IP version for name resolution" section of Chapter 2, Configuration, in E VMware Smart Assurance IP Manager User Guide. If no IP protocol suffix is included with a hostname (for example, myserver.example.com), the IP protocol setting for the SM_IP_VERSIONS environment variable is used to resolve the hostname to an IP address. SM_IP_VERSIONS is described in"SM_IP_VERSIONS environment variable" section of Chapter 8, IPv6 Address Conventions, in VMware Smart Assurance IP Manager Reference Guide.

  • <port> is the trap listening port on the destination host. Port is optional; if not specified, port defaults to 162.

  • <community> is the community string to be assigned to the community string field in the forwarded traps. Community is optional; if not specified, community defaults to the value that is specified in the community string field of the incoming v1 or v2c trap, and defaults to an empty string for an incoming v3 trap.

Wildcards (for globbing) are allowed for all fields except destination host address, port, and community. Wildcard syntax is discussed in Chapter 9, “Wildcard Patterns”, in the VMware Smart Assurance IP Manager Reference Guide.

Examples:

FORWARD: * .* * * 192.35.144.12:2004

All traps that are received from all IPv4 and IPv6 network devices will be sent to port 2004 on a host that is identified by IPv4 address 192.35.144.12.

FORWARD: *:*:* .* * * [3FFE:80C0:22C:109:203:BAFF:FEE5:7BE1]:2002

All traps that are received from all IPv6 network devices will be sent to port 2002 on a host that is identified by IPv6 address 3FFE:80C0:22C:109:203:BAFF:FEE5:7BE1.

FORWARD: *.*.*.* .* * * snake:v4:9099:public1

All traps that are received from all IPv4 network devices will be sent to port 9099 on an IPv4 host that is named “snake”; the community string “public1” will be assigned to the forwarded traps.

Other trap forwarding examples are presented at the end of the trapd.conf file.