sendstats

Name

sendstats -- transmit cluster node status

Synopsis

sendstats [-h, --help ] [-v, --version ] [-a ADDRESS, --address=ADDRESS ] [-d, --debug ] [-i if, --interface=if ] [-p port, --port=port ] [-r rate, --rate=rate ]

Description

The sendstats daemon is part of the Beostat package. It transmits status and alerts from cluster nodes. In some configurations it also receives multicast packets to request immediate updates or change the reporting rate. These messages typically are sent by a cluster master running the recvstats daemon.

The exact content and format of the sendstats messages vary between versions, but it typically transmits the dynamic values of the following proc file system files: /proc/cpuinfo, /proc/meminfo, /proc/loadavg, /proc/net/dev, and /proc/stat.

The sendstats command may be used on machines outside of the Scyld ClusterWare cluster management domain. In this case a node number outside of the assigned node range for the cluster should be used. This avoids status update clashes and the possibility that a scheduler mistakes the machine as an available compute node.

The destination address and port may be specified as either a unicast or multicast address. Older releases of the Scyld ClusterWare system used multicast by default. Using multicast allows all machines on the cluster network to monitor the status, but increases the likelyhood that status packets are discarded or delayed in the network. Current releases use the unicast address of the master, along with a installation-specific UDP port.

Options

The following options are available to the sendstats daemon.

-h, --help

Display a short help message and list the available options and then exit.

-v, --version

Display the program version and exit.

-a address, --address=address

Send on the network interface whose IP address matches address.

-d, --debug

Debug mode/Don't fork, normally the program will fork and exit, this flag will prevent the fork.

-i if, --interface=if

The name of the network interface to send on. This option should always be specified unless the -a is used.

-p port, --port=port

Override the default listen port of 3040 (0xbe0). Only use this option if there's a conflict with the standard port.

-r rate, --rate=rate

Override the default auto-transmit rate of 59 seconds. Units are seconds.

Examples

The sendstats daemon is primarily meant to be used as a part of the Scyld ClusterWare Beostat system. In Scyld releases before 28z-5, the sendstats daemon was automatically started as part of the init process on the slave nodes. In later releases, it is explicitly started as part of the node initialization script /etc/beowulf/init.d/beostat.