MOSCTL(1)               System General Commands Manual               MOSCTL(1)

NAME

     mosctl - openMosix system administrator's tools


SYNOPSIS

     mosctl { stay | nostay | lstay | nolstay | block | noblock | quiet |
             noquiet | nomfs | mfs | expel | bring | gettune | getyard |
            getdecay }
     mosctl whois [ openMosix-ID | IP-address | hostname ]
     mosctl { getload | getspeed | status | isup | getmem | getfree | getutil
            } [ openMosix-ID ]
     mosctl setyard [ processor-type | number | this ]
     mosctl setspeed numeric-value
     mosctl setdecay interval slow fast


DESCRIPTION

     Mosctl provides a variety of openMosix system-administration and informa-
     tion tools.

     stay prevents automatic migration of processes out from the current node.
     nostay or -stay cancels the effect of stay.

     lstay prevents only local processes from migrating away automatically,
     but still allows remote/guest processes to do so.  nolstay or -lstay can-
     cels the effect of lstay.

     block prevents remote/guest processes from arriving in.  noblock or
     -block cancels the effect of block.

     quiet stops the background activity of the node providing other nodes
     with its load-information.  noquiet or -quiet cancels the effect of
     quiet.

     nomfs disables access to this node's files via the MFS file-system (if
     configured).  mfs re-enables access to this node's files via MFS.

     expel sends away all remote/guest processes.  It does not return until
     all remote/guest processes were evacuated (or until interrupted).  It
     also acts as block, preventing new remote/guest processes from arriving.

     bring brings back to the node all processes that are running away from
     it.  It does not return until all processes were brought back (or until
     interrupted).  It also acts as lstay in preventing local processes from
     migrating away automatically.

     getdecay displays the current decay parameters, which control the gradual
     decay of old process-statistics for the use of load-balancing.  Every
     given number of seconds, only a given portion of the statistics is kept.
     That portion is different for slow-decaying (the default) and for fast-
     decaying processes.

     setdecay loads a new set of decay parameters:

     * Interval in seconds.
     * How much out of 1000 to keep for slow-decaying processes.
     * How much out of 1000 to keep for fast-decaying processes.

     The interval must be within the range of 1-65535, the slow and fast
     parameters must be in the range of 0-1000 and the slow parameter must be
     greater or equal than the fast parameter.

     gettune displays the overhead parameters used by the kernel to estimate
     the "I/O factor" in its load-balancing.  These paramters are:

     * Deputy overhead in processing a demand-page
     * Remote overhead in processing a demand-page
     * Deputy overhead in processing a system call
     * Remote overhead in processing a system call
     * Basic deputy overhead for reading data
     * Deputy overhead per 1KB read
     * Basic remote overhead for reading data
     * Remote overhead per 1KB read
     * Basic deputy overhead for writing data
     * Deputy overhead per 1KB written
     * Basic remote overhead for writing data
     * Remote overhead per 1KB written
     * Migration time of an empty process
     * Extra migration time per dirty page

     All integers express microseconds.

     getyard displays the yardstick in use.  This is the processor-speed of
     the most typical openMosix node.  By default, it is 10000 speed-units,
     representing a Pentium-III at 1GHz.  setyard sets the yardstick according
     to the argument, which can be either numeric (speed-units), the word
     "this", implying the node's own processor-speed, or the name of a recog-
     nised processor, such as: 386/33, 486/66, Pentium/133 (or p/133),
     ppro/200, pII/300 (or Pentium2/300), pIII/1000, PIV/1400.

     the processor names are case-insensitive and the '/' may also be replaced
     by '-' or '_'.

     whois converts openMosix-ID numbers to current IP addresses and vice-
     versa (See setpe(1)). If given an integer, it assumes a openMosix-ID and
     displays the corresponding IP-address.  If given an IP address (a.b.c.d),
     it converts it to a openMosix-ID.  If given a hostname that is either
     listed in /etc/hosts or deteceted by named(8), it finds its IP addresses
     and converts it to a openMosix-ID.  Without a second argument, the local
     node's openMosix-ID is displayed.

     getload displays the load on the given openMosix-ID (or the current node
     if the second argument is missing).  Although the load is a rather com-
     plex function, under normal conditions, a load of 100 represents one pro-
     cess, constantly requiring the CPU on a node with a yardstick processor-
     speed.  On faster processors, the load caused by a similar process would
     be less than 100 and accordingly, on slower processors it would be more
     than 100.

     getspeed displays the processor speed of the given openMosix-ID (or the
     current node if the second argument is missing).  The speed is relative
     to a Pentium-III at 1GHz being 10000 units.

     getmem (or memory or mem) displays the logically-free and total memory on
     the given openMosix-ID (or the current node if the second argument is
     missing).  The free memory may not necessarily correspond with
     "vmstat(8)", as it also takes other factors into account.

     getfree (or getrawmem or rawfree) displays the raw free and total memory
     on the given openMosix-ID (or the current node if the second argument is
     missing).  The free memory should correspond with "vmstat(8)".

     getutil displays the processor utilizability percentage on the given
     openMosix-ID (or the current node if the second argument is missing).
     This means how much of the time either the node is serving some process,
     or there are no processes on that node waiting for swapped-pages.  Under
     normal operating conditions on a single-processor node, utilizability
     should be 100%, dropping only when the memory is being pressured.  On
     SMPs, the utilizability should be 100% times the number of processors.

     status (or stat) displays whether the given openMosix-ID node (or the
     current node if the second argument is missing) is up and connected, and
     whether any of the following conditions described above is set on that
     node: "stay", "lstay", "block" or "quiet".

     isup responds whether the node specified by openMosix-ID is running and
     connected or not.

     setspeed overrides the node's idea of its own speed.  The speed must
     still be defined so that a Pentium-III at 1GHz yields 10000 units, but
     this option is provided to allow for systems that always run the same (or
     very similar) computation-intensive application, for which the ratio of
     the speeds between different processors is other than with the mixed
     benchmark used by openMosix.


SEE ALSO

     openmosix(1), setpe(1), tune(1), mosmon(1), mosrun(1), migrate(1).


HISTORY

     mosctl is an openMosix utility.

openMosix                        May 16, 1999                        openMosix  >>