Using the es-trapdest Command

Secondary trap destinations are managed with the es-trapdest command. You can use the following options with the command.

You can also specify the following optional parameters when adding a new secondary trap destination with the es-trapdest -a command:

-v version

Specify SNMP version: SNMPv1, SNMPv2c, or SNMPv2u

-u user

Specify the SNMP community or user name

-f filter

Specify the trap filter

Trap Filter Specification

Trap filters are specified as a list of criteria, which can be either a series of numerical OID prefixes or a series of these mnemonic trap names:

• sunmcTraps

• snmpTraps

• coldStart

• warmStart

• linkDown

• linkUp

• authenticationFailure

The trap name sunmcTraps represents the OID prefix for all Sun Management Center enterprise-specific traps, and the trap name snmpTraps represents the OID prefix for all the standard traps defined in the SNMP RFCs.

Trap filters can be either positive or negative. A positive filter specifies which traps to send. A negative filter specifies which traps should not be sent. A negative filter is defined by specifying NOT as the first criterion.

For example, to forward only standard SNMP traps to the secondary trap destination, specify the filter as -f "snmpTraps".

To forward all traps except Sun Management Center enterprise-specific traps to the secondary trap destination, specify the filter as -f "NOT sunmcTraps".

Filter specifications that contain spaces must be enclosed in quotation marks to prevent misinterpretation by the shell.

The following command adds machine02:162 as a secondary trap destination that only receives warmStart and coldStart traps for the Sun Management Center agent:

es-trapdest -a machine02:162 -f "warmStart coldStart"

Platform Agent Instances

Each instance of a platform agent can have its own set of secondary trap destinations. To specify secondary trap destinations for a particular instance of a platform agent, use the -c instance option to the es-trapdest command, where instance is the name of the platform agent instance. If the -c is not specified as an argument to the es-trapdest command, the es-trapdest command uses the default value of agent, which manages the secondary trap destinations for the Sun Management Center agent component.