pg.snmp.communityTarget.
These parameters are used only when you have set
pg.snmp.customTarget to
communityTarget (see
pg.snmp.customTarget).
Note: | These settings must match those of your third-party SNMP server. |
pg.snmp.communityTarget.base64Encoded
Specifies whether to use a third-party SNMPv1 community-based connection. If set to true, the community name entered in the Community Name field in the Mediator > Administration > SNMP page in Integration Server Administrator must be the Base64 value. The default is false.
pg.snmp.communityTarget.communityName
Specifies the name used to interact with the SNMP receiver. This value must match the value that you set in the SNMP receiver. The default is public.
You can edit this parameter from the 3rd Party SNMP Configuration > Community Name field in the Mediator > Administration > SNMP page in Integration Server Administrator.
pg.snmp.communityTarget.transportProtocol
Specifies the protocol used by SNMP to send traps. Valid values are TCP (default) and UDP.
If you select UDP, ensure that the SNMP server is in the same subnet, or else configure the routers to get packets across subnet boundaries. The maximum PDU size when running in UDP mode is 64Kb, which might be restrictive when sending large request and response payloads for Transaction Events.
You can edit this parameter from the 3rd Party SNMP Configuration > Transport field in the Mediator > Administration > SNMP page in Integration Server Administrator.
pg.snmp.communityTarget.ipAddress
Specifies the IP address of the host running the SNMP server. You cannot set this parameter to localhost.
Important: | If you do not set this parameter properly, the traps might not reach the SNMP server. Mediator sends events as SNMP traps, but because there is no mechanism for acknowledging traps that are configured incorrectly, the SNMP server does not return errors when settings are incorrect. |
You can edit this parameter from the 3rd Party SNMP Configuration > Host Name/IP Address field in the Mediator > Administration > SNMP page in Integration Server Administrator.
pg.snmp.communityTarget.port
Specifies the port accepting requests for the SNMP server. The default is 2162.
You can edit this parameter from the 3rd Party SNMP Configuration > Port field in the Mediator > Administration > SNMP page in Integration Server Administrator.
pg.snmp.communityTarget.retries
Specifies the number of times to resend SNMP traps upon failure. The default is 1.
This parameter works with pg.snmp.communityTarget.sendTimeOut to determine the delay in re-sending SNMP traps to malfunctioning SNMP servers (that is, it retries *sendTimeOut). This means that if the retries parameter is set to 3, and the sendTimeOut parameter is set to 500 milliseconds, there is a 1.5 second delay before the Mediator thread sending the alert is available to send another event. Malfunctioning event destinations could delay the amount of time it takes Mediator to report events, or it could cause discarded events when the queue reaches its maximum level.
pg.snmp.communityTarget.sendTimeOut
Specifies the amount of time (in milliseconds) to wait before the SNMP trap times out because the server destination is not responding. This value schedules a timer that resends an SNMP event that has not yet completed when it expires. You must set a timeout value that ensures that the trap is sent to the SNMP server within the time frame. This parameter does not abort an event that is in progress. Set this parameter higher than the default when sending traps with large payloads. The default is 500.
This parameter works with pg.snmp.communityTarget.retries to determine the delay in re-sending SNMP traps to non-responsive SNMP servers (that is, it retries *sendTimeOut). This means that if the retries parameter is set to 3, and the sendTimeOut parameter is set to 500 milliseconds, there is a 1.5 second delay before the Mediator thread sending the alert is available to send another event. Malfunctioning event destinations could delay the amount of time it takes Mediator to report events, or it could cause discarded events when the queue reaches its maximum level.
pg.snmp.communityTarget.maxRequestSize
Specifies the maximum size (in bytes) for SNMP traps. The default is 65535.
pg.snmp.customTarget
Set these properties if you want to use a third-party SNMP server instead of the CentraSite SNMP server.
pg.snmp.customTarget
Specifies the security model of your third-party SNMP server:
communityTarget, for the SNMPv1 community-based security model (the default). In addition, you need to set the parameters specified in
pg.snmp.communityTarget.
userTarget, for the SNMPv3 user-based security model. In addition, you need to set the parameters specified in
pg.snmp.userTarget..
You can edit this parameter from the SNMP Target Type option on the Mediator > Administration > SNMP page in Integration Server Administrator.
pg.snmp.customTarget.connTimeout
Specifies the number milliseconds before an inactive connection to the third-party SNMP server is closed. If set to 0, the socket remains open indefinitely.
pg.snmp.customTarget.sendTraps
If set to true, Mediator sends traps to the third-party SNMP server. The default is false.
You can edit this parameter from the Send Traps to 3rd Party SNMP Server option on the Mediator > Administration > SNMP page in Integration Server Administrator.
