Configuring ping

This topic provides information about configuring the Ping monitor type. The Ping monitor type is used to ping a system using either its IP address or its DNS name (resolved to an IP address) and get the system's availability and response time.

This topic includes the following information:

Before you begin

You must download and install the PATROL for Light Weight Protocols.

Perform the following steps (For Linux only):

  1. Permissions are required for PPM binary. Check if you can ping the remote server using the ping command and compare the value on the graph.
  2. Check if the following permission and ownership for the ppm binary are present in Patrol3/PPM directory:
    • chown root permission granted for ppm binary
    • Assigned sticky bit to ppm binary chmod +s rwsr-xr-x root root ppm
  3. Run the ppmRootScript.sh script for setting up the ppm binary permission once the LWP KM is installed. Use the root account to run the script.
    The default location of the script is <Patrol Installation directory>PPM/Scripts

  4. Use the following commands. The script needs to be run with the PATROL Home and the TARGET is set to the platform.

    # cd /opt/bmc/Patrol3
    # . ./patrolrc.sh
    # cd PPM
    # cd Scripts
    #./ppmRootScript.sh /opt/bmc/Patrol3/

    The PATROL Home location can be different based on the installation.

  5.  After the permissions are set, restart the PATROL Agent.

To configure the monitor type

In the Add Monitoring Configuration panel, select the following parameters for the Ping monitor profile:

Parameter

Selection

Monitoring Solution

Light Weight Protocols

Monitor Profile

ICMP

Monitor Type

Ping

To configure a device

Click Add and enter the device details

Field

Description

Device details

Device name/IP

Enter the alias name, hostname or IP address of the network device you want to ping.

You must configure the device IP address if the alias name cannot get resolved to an IP address.

IP Address

(Optional) Enter the IP address of the network device you want to ping.

You can leave this field blank if you have provided the actual hostname or IP address as the alias name.

IP Addresses

IP Address

Enter the IP address of the network device to monitor.

Note

There can be multiple IP addresses associated with each configured device. The configured device acts as a container and contains multiple IP addresses.

Protocol

If you have entered the device name in the Device name/IP field, select one of the following protocols:

  • IPv4

  • IPv6

    If you have selected the IPv4 protocol, then the device is pinged using the IPv4 address. If you have selected the IPv6 protocol, then the device is pinged using the IPv6 address.

Dynamic IP

Enable this option to configure the device with the dynamic IP address. If the IP address is dynamic, the device communicates with the DNS server during each poll interval to resolve the IP address.

Disable this option to configure the device with static the IP address. If the IP address is static, the device communicates with the DNS server only once to resolve the IP address.

By default, this option is disabled.

Poll interval (sec)

Select the poll interval time in seconds to ping the device. The default value is 300 seconds. The minimum value you can select is 10 seconds. The maximum value you can select is 3600 seconds.

Transmit packet size (bytes)

Select the transmit packet size in bytes.The default value is 32 bytes. The minimum bytes you can transmit is 32 bytes. The maximum bytes you can transmit is 65500 bytes.

Retries count

Select the number of echo request messages to send. The default value is 4. The minimum value you can select is 1 and the maximum value you can select is 10.

Timeout (ms)

Enter the timeout in milliseconds to wait for each reply. The default value is 1000 milliseconds. The minimum value you can select is 1 millisecond and the maximum value you can select is 30000 milliseconds.

Network segment

IP address range

Enter the IP address range in the following format: IPAddress-Range.

For example, if you enter the IP address range as 10.64.109.1-10, all IP addresses in the range between 10.64.109.1 to 10.64.109.10 are configured.

Category

(Optional) Enter the category for all IP addresses in the range. If you will leave this field blank, the group name is the IP address range.

Exclude IP addresses

(Optional) Enter comma-separated IP addresses to be excluded from the range.

For example, if you enter the IP address range is 10.64.109.1-10 and you want to exclude IPaddresses:10.64.109.6, 10.64.109.7, and 10.64.109.8, use one of the following options:

  • 10.64.109.6,10.64.109.7,10.64.109.8
  • 6,7,8
  • 6-8
  • 10.64.109.6-10.64.109.8

Poll interval (sec)

Select the poll interval time in seconds to ping the device. The default value is 300 seconds. The minimum value you can select is 10 seconds. The maximum value you can select is 3600 seconds.

Transmit packet size (bytes)

Select the transmit packet size in bytes. The default value is 32 bytes. The minimum bytes you can transmit is 32 bytes. The maximum bytes you can transmit is 65500 bytes.

Retries count

Select the number of echo request messages to send. The default value is 4. The minimum value you can select is 1 and the maximum value you can select is 10.

Timeout (ms)

Enter the timeout in milliseconds to wait for each reply. The default value is 1000 milliseconds. The minimum value you can select is 1 millisecond. The maximum value you can select is 30000 milliseconds.

Configuration files based monitoring

Import devices from file

Enable this option to configure devices to be pinged automatically from files. The devices to be pinged automatically place the files at %PATROL_HOME%\PPM\Conf\ImportDevices\ directory. You can have multiple files for configuring devices and should specify an appropriate name to the files. The devices are grouped under these file names. By default, this option is disabled. For more information, see Importing devices from file.

If you have multiple PATROL Agents with different port numbers running on the same computer and each PATROL Agent wants to load a different file, then you can create subdirectories under the file location with the port number.

Files location

Specify the location to load the configured files based configuration. If it is not specified then by default it considers %PATROL_HOME%\PPM\Conf\ImportDevices.

Note

Input value must not contain any character from the set '*?><|'.


Default Configuration Settings

The default configuration settings enable you to set pre-defined values for the configuration fields to ping a device or network segment. You can set up default configuration for the following configuration fields.

Protocol

Select any of the following protocol to ping the configured devices:

  • IPv4
  • IPv6

Dynamic IP

Enable this option to configure the device with the dynamic IP address. If the IP address is dynamic, the device communicates with the DNS server during each poll interval to resolve the IP address.

Disable this option to configure the device with static the IP address. If the IP address is static, the device communicates with the DNS server only once to resolve the IP address.

By default, this option is disabled.

Poll interval (sec)

Select the poll interval time in seconds to ping the device. The default value is 300 seconds. The minimum value you can select is 10 seconds. The maximum value you can select is 3600 seconds.

Transmit packet size (bytes)

Select the transmit packet size in bytes. The default value is 32 bytes. The minimum bytes you can transmit is 32 bytes. The maximum bytes you can transmit is 65500 bytes.

Retries count

Select the number of echo request messages to send. The default value is 4. The minimum value you can select is 1 and the maximum value you can select is 10.

Timeout (ms)

Enter the timeout in milliseconds to wait for each reply. The default value is 1000 milliseconds. The minimum value you can select is 1 millisecond. The maximum value you can select is 30000 milliseconds.

Administration

Root display name

Enter a display name for the monitor type to display a meaningful location name for the target agent. The target agent pings the configured destination devices. The default root display name is Network Devices.

Device Mapping

Select any of the following monitoring modes:

  • FQDN — Monitors are created within a device according to the discovered FQDN of the monitored system. If the configured Device name/IP set with an alias name and the force IP address is configured, the device gets mapped to the TrueSight with the Device name/IP instead of the device FQDN although this option was selected.

    Example

    If you want to ping a device whose FQDN is "myServer.bmc.com" and you have provided the alias name like " Test" in the Device name/IP field. By selecting the Enabled: FQDN option, the device name in the Operations Console will be the FQDN of the network device, which in this example is myServer.bmc.com. 

  • User defined — Monitors are created within a monitored device using the name provided by the user (alias name).

    Example

    If you want to ping a device whose FQDN is "myServer.bmc.com" and you have provided the alias name like " Test" in the Device name/IP field. By selecting the Enabled: User defined option, the device name in the Operations Console will be the alias name of the network device, which in this example is "Test".

  • Disable — Monitors are created within the device of the PATROL Agent(s).

Enable logging

Select this option to enable logging. The log files are created at %PATROL_HOME%\PPM\logs. By default, this option is disabled.

After entering all the required details, click OK and Close button and save the policy.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*