|
|
|
The trapreceiver.conf configuration file is an XML-like file that contains all of the SNMP Trap Receiver settings. This file is provided so you can change these settings as needed. You can configure settings to enable trap blocking, format traps, send traps to CA Server Automation Event Manager, or convert traps into CIM_SNMPTrapIndications. These traps can be sent to the Product Management Modules (PMMs). You can configure the file dynamically without restarting Apache for all settings except for SNMPPort which requires you to restart Apache. All other changes take effect 30 seconds after you save them.
Locate the trapreceiver.conf file in the Install_Path\CA\productname\config directory and open with a text editor.
Configuration parameters include the following:
Defines the UDP port to which Trap Receiver connects and listens for incoming SNMP traps. If another application is connected to the port specified by this parameter, Trap Receiver does not start. Instead, it logs a message to the Event Manager and attempts to reconnect to that port every 30 seconds. If this parameter is modified with a new port number, Trap Receiver attempts to connect to the new port.
Default: 162
Note: If you change the SNMPPort setting after Trap Receiver is connected to the SNMP port, restart Apache for the new port to take effect.
Prevents duplicate trap handling. A configurable value prevents identical traps from coming in more often than the TrapStormTimer value setting. If the value is set to 0, then trap storm is disabled.
Default: 30
Filters all incoming SNMP traps before being evaluated by the Converter or Subscriber components in the configuration file.
Default: All Traps
Applies only to the PreFilter. Options include the following:
Determines which traps are permitted to pass for handling.
Determines which traps are blocked.
Default: positive if <FilterType>negative</FilterType> or <FilterType>positive</FilterType> is not included.
Note: If you specify the asterisk * for all fields in negative prefilters, then all prefilters are disabled and traps are blocked.
Specifies a descriptive name for the converted trap and can be duplicated when specifying other trap names.
Example: <Converter Name="eHealthTrap25">
Specifies a string containing %s to represent the values that are defined by the list of varbind values below the format string.
Specifies the variables that are used to replace the %s in the format string.
Valid values include the following:
SourceIP
EnterpriseOID
GenericTrapID
SpecificTrapID
Note: The SpecificTrapID filter entry is only evaluated if generic type from the incoming trap is 6 (enterpriseSpecific). If GenericTrapID is * and the generic type from the incoming trap is 0-5, then both GenericTrapID and SpecificTrapID are matches.
Varbind1, Varbind2 - up to and including the number of expected varbinds in the trap. The number of variables below the Format must match the number of %s values in the Format.
(Optional) Substitutes the SourceIP of the trap to another value, such as a specific varbind of the incoming trap. Some incoming traps originate from the manager and are not from the node were the trap originated.
Default: SourceIP
(Optional) Substitutes the localhost node name with a value from the incoming trap, such as a specific varbind.
Default: localhost
Specifies a descriptive name for the subscriber and can be duplicated when specifying other trap names.
Example: <Subscriber Name="SUNZoneAim_PMM">
Specifies the ActiveMQ topic name where messages are sent for CA Server Automation.
These settings apply to Filter and PreFilter. They allow incoming traps to be evaluated to determine if each Converter or Subscriber uses them. If the PreFilter blocks traps, then the other Filters do not evaluate them.
Specifies any regular expression string variable that is a subset of the range of IP addresses.
Examples:
111.*.*.*
112.223.*.*
112.223.334.5
*
Limits: IPv4 addresses only.
Specifies any regular expression string variable that is a subset of the range of enterprise OIDs. Use backslash (\) before any period (.) that appears in the regular expressions. The period (.) is a special character in regular expression syntax.
Specifies an integer-based regular expression that is used to compare the trap Protocol Data Unit (PDU) TrapType field. Valid values are *, a single integer 0 through 6, or a range (0-1) or (0-6).
Valid SNMP TrapType values include the following:
coldStart(0)
warmStart(1)
linkDown(2)
linkup(3)
authenticationFailure(4)
egpNeighborloss(5)
enterpriseSpecific(6)
Specifies an integer-based regular expression that is used to compare the trap PDU’s TrapType field.
Valid values can be one of the following:
*
A single integer
A range from (1200-2225) or (165201-165299)
Specifies comments which can be on the same line or separate lines.
Defines the beginning of a comment.
Defines the end of a comment.
Example:
<!-- If the port is already connected, it does not change dynamically. Restart Apache. -->
| Copyright © 2011 CA. All rights reserved. | Tell Technical Publications how we can improve this information |