Clusterpunch: a distributed mini-benchmark system for clusters

Documentation—clusternodecount

clusternodecount - count nodes in the cluster

NAME

clusternodecount - count nodes in the cluster


SYNOPSIS

The clusternodecount binary enumerates all nodes running the clusterpunchserver daemon. Any node running this service which responds to the roll call is considered live.


Basic Counting

 # Count cluster nodes (xofy)
 >clusternodecount
 29

Please see the documentation for clusterpunchserver to see how you should use the -f flag to load configuration files.

 # Get verbose list of all nodes
 > clusternodecount -v
 ...
 8of0
 7of0
 9of1
 1of1
 2of1
 ...


Adjusting Timeout

 # Adjust the roll call timeout (seconds)
 > clusternodecount -t 15


Setting Port and/or Broadcast

 > clusternodecount -p 8095 -b 10.1.2.255


Debug Mode

 # You can receive the full node stat table and some 
 # debug text during the polling with
 > clusternodecount -d
 ...
 $STAT1 = {
            'live' => 1,
            'load' => '0.01'
          };
 ...


DESCRIPTION

This is part of the clusterpunch system. Each node that you wish to monitor must be running the clusterpunch.shutdown daemon, documented in the clusterpunch.shutdown. Once the server is running, you can poll it and send commands using the API documented in clusterpunchclient.pm, or through the various utilities, such as this one.

The clusternodecount utility counts the number of nodes which are running the server, thus providing some manner to check availability.


SEE ALSO


Daemons

clusterpunchserver, clusterpunch.start, clusterpunch.shutdown


API

clusterpunch.pm


Utilities

benchdriver, clusterbench, clusterlogin, clusternodecount, clustersnapshot


CHANGES


AUTHOR

Martin Krzywinski (martink@bcgsc.ca), January 2003

$Id: clusternodecount,v 1.8 2003/02/04 00:18:34 martink Exp $