dping Command

Purpose

Pings nodes or devices in parallel.

Syntax

dping [-h] [-v] [ -a ] [-s] [-S] [-r] [-i interface...] [-w " selectstr"] [-H host_list] [-f filename] [-N nodegroup...] [-d devicename...] [-D devicegroup] [[-n] node_list]

Description

The dping command pings the specified servers. The command can be used to retrieve node status or when you suspect a problem with Rational® Method Composer (RMC) and its heartbeating. The dping command is used to ping nodes or devices in parallel. - Ping nodes pings every second node interface in the series. For example, eth1 or mryi0 and - Direct nodes pings other nodes.

Keywords

Item Description
-a Specifies to ping all the nodes. This flag cannot be combined with the -n, -N, -f, -d, -Hor -w flags.
-c Collapses identical output from more than 1 node and displays it 1 time.
-d devicename... Specifies one or more comma-separated devices to ping. The asterisk character (*) indicates all devices.
-D devicegroup... Specifies one or more comma-separated device groups to ping.
-f filename Specifies a file that contains a list of nodes. If the file name specified is the dash character (-), then the list is read from the standard input. The file can contain multiple lines, and each line can list one or more comma or space-separated node host names or node ranges.
-h Displays command usage information.
-H host_list Specifies the host name that is separated by comma or space to be pinged. These host names must not be defined NIM nodes. Space separated host names must be specified within double quotation marks. The -H flag cannot be specified with the -n, -N, -f, -d, -w, or the-a flags.
-i interface.. Specifies one or more comma-separated network interfaces to ping for each node specified. The flag assumes that nodename-interface.domain resolves to the IP address of that network adapter on the node. You must set up host name resolution before running dping. If one of the host names is an empty string, for example "eth1,eth2", the flag also pings the primary host name.
-n node_list Specifies one or more comma or space-separated node host names or node ranges to ping. This flag can be used simultaneously with -N and -f. The host name value can be specified without -n, if it is the last argument specified. See the noderange file for information about node ranges.
-N nodegroup.. Specifies one of more comma-separated node groups on which to run the command.
-r Pings recursively. This flag runs dsh command to the nodes that pinged successfully. It pings all remaining nodes specified with the dping command, from those nodes.
-s Pings the nodes serially instead of in parallel. This flag cannot be used with the -S flag.
-S Displays a summary of the ping results only. This flag cannot be used with the -s flag.
-v Specifies verbose mode.
-w selectstr Displays the nodes that match the "where" clause of the select string. Specifying the entire string within double quotation marks will allow you to specify attribute value strings within single quotation marks. The asterisk character (*) indicates all nodes, as if a "where" clause were not specified. The -w flag cannot be specified with the -n, -N, -f, -d, -H, or -a flags.

Security

The command requires root access to the cluster management server.

Examples

  1. To ping all nodes, enter:
    dping -a  
    Output is similar to:

    node1.localdomain: ping (alive)

    node2.localdomain: noping (unreachable)

    node3.localdomain: ping (alive)

  2. To ping the group1 nodegroup and eth1 node interface, enter:
    dping -N group1 -i eth1   
    Output is similar to:

    node1-eth1.localdomain: ping (alive)

    node2-eth1.localdomain: noping (unreachable)

  3. To ping the hostname node1-eth2.clusters.com, enter
    dping -i eth2 node1.clusters.com   
    Output is similar to:
    Exit Status 0 The command completes successfully. 1 The command failed. 10 No nodes or devices were specified.