NAME

slreportd - Distributed load reporter for Perl Schedule::Load

SYNOPSIS

slreportd [ --help ] [ --port=port ] [ --dhost=host ] [ --version ]

DESCRIPTION

slreportd will start a daemon to report machine loading for the Schedule::Load package. It will create two similar processes, so that if second process exits, the first may restart it automatically.

slreportd must be running on every host in the network, usually started with a init.d script. It reports itself to the slchoosed daemon periodically, and is responsible for checking loading and top processes specific to the host that it runs on.

slreportd may also be invoked with some variables set. This allows static host information, such as class settings to be passed to applications.

ARGUMENTS

--help: Displays this message and program version and exits.
--dhost: Specifies the daemon host name that slchoosed uses. May be specified multiple times to specify backup hosts. Defaults to SLCHOOSED_HOST environment variable, which contains colon separated host names.
--fake: Specifies load management should not be used, for reporting of a "fake" hosts' status. Often the hostname and other parameters will want to be overridden, for example:
slreportd hostname=lab_1 cpus=1 max_clock=100 osname=myos osvers=1 archname=myarch reservable=1 load_limit=1
--nofork: For debugging, prevents the daemon from creating additional processes and from going into the background. This allows messages to appear on stdout, and ctrl-C to stop the daemon.
--port: Specifies the port number that slchoosed uses. Defaults to SLCHOOSED_PORT environment variable or slchoosed service, or 1752.
--version: Displays program version and exits.
{variable}={value}: Sets a arbitrary constant variable to the specified value. This variable may be used so that a process requesting a machine can choose a machine with specific properties.

dynamic_cache_timeout={secs}: When set, after this number of seconds the dynamic load information for this host will no longer be cached by slchoosed, and when next needed must be reread from the slreportd. If not set, slchooserd picks a default, currently 10 seconds. Turning this number up may improve performance at the cost of decreased accuracy.
load_limit={value}: Set a maximum number of jobs that the scheduler can run on this machine.
load_pctcpu={1|0}: When set, determine load as a floating point number based on CPU usage percentage of all tasks. Default, or when clear, load is a absolute number where each high CPU job counts as one job, regardless of what percentage of the CPU is used. Using pctcpu tends to keep CPUs busy more often, at the possible expense of slowing down interactive jobs that are not using an entire CPU.
rating_adder={value}: Add the specified value to the rating obtained for the machine. A positive rating will make the machine less desirable for scheduling.
rating_mult={value}: Multiply the specified value to the rating obtained for the machine. The value 2 would act the same as a halved clock frequency, making the machine less desirable for scheduling.

DISTRIBUTION

The latest version is available from CPAN and from <http://www.veripool.org/>.

Copyright 1998-2011 by Wilson Snyder. This package is free software; you can redistribute it and/or modify it under the terms of either the GNU Lesser General Public License Version 3 or the Perl Artistic License Version 2.0.

AUTHORS