DragonFly On-Line Manual Pages

SLREPORTD(1)          User Contributed Perl Documentation         SLREPORTD(1)

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
       Wilson Snyder <wsnyder@wsnyder.org>

SEE ALSO
       slchoosed, Schedule::Load, Schedule::Load::Reporter,

perl v5.20.2                      2011-01-02                      SLREPORTD(1)