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.

Note:

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.

Table 1. Global values in the REMOTEPING.conf file

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