The REMOTEPING.conf file contains configuration parameters that you edit to customize the global values of the remote ping manager. The parameters are a subset of attributes that are defined for the remote ping manager (“remotePingManager” object) in the MPLS Topology Server environment, and for the remote ping manager (“remotePingManager” object) in the MPLS Monitoring Server environment.
The remote ping manager in the MPLS Topology Server environment will execute on-demand remote ping requests. The remote ping manager in the MPLS Monitoring Server environment will execute periodic remote ping instances.
When running, the remote ping manager in the MPLS Monitoring Server will obtain all of its attribute values except NumberOfThreads from the remote ping manager in the MPLS Topology Server.
Each newly invoked on-demand remote ping or newly deployed periodic remote ping instance inherits the global values that are specified in the REMOTEPING.conf file.
Remote ping is available for Layer 3 VPNs but not Layer 2 VPNs.
Global values in the REMOTEPING.conf file describes the parameters in the REMOTEPING.conf file. The parameters and their values are case-sensitive.
Parameter |
Type |
Default global value |
Allowed global values |
Description |
---|---|---|---|---|
1 Applicable to periodic but not on-demand remote pings. 2 Described in “Default remote ping groups and settings” on page 141. 3 The only parameter in the REMOTEPING.conf file in the mpls-m directory. |
||||
MibStartIndex |
Integer |
1 |
Integer greater than or equal to 1 |
In the PING MIB table on the source device, the starting location of rows reserved for the remote ping manager’s remote ping entry. |
MibBlockSize |
Integer |
1000 |
1 to 1000 |
In the PING MIB table on the source device, the number of rows reserved for the remote ping manager’s remote ping entry. |
WriteCommunity |
String |
“private” |
String of unspecified length |
Community name that is used by the remote ping manager to write (SET) a ping entry to the PING MIB table on the source device. Typically overwritten by a value that is defined in a “System Write Community Strings” group. 2 |
PingsPerInterval |
Integer |
5 |
1 to 2147483647 |
Number of pings sent by the source device per polling interval. |
ImpairedThreshold 1 |
Integer |
2 |
Integer greater than or equal to 1 |
Minimum number of missed packets per polling interval before the remote ping manager generates an “Impaired” notification. |
NumberOfThreads 3 |
Integer |
1 |
1 to 10 |
Number of threads used by the remote ping manager for RemotePing execution. |
MaximumTotalPings 1 |
Integer |
10000 |
1 to 10000 |
Maximum number of periodic RemotePings that can be issued by the remote ping manager. |
RefreshFactor 1 |
Integer |
3 |
3 to 360 |
Determines the interval at which the remote ping manager (1) performs a remote ping event calculation and (2) rewrites the ping entry to the PING MIB table on the source device. Interval is equal to the RefreshFactor value times the PollingInterval value. 2 |