MOSMON(1) openMosix tools User's Manual MOSMON(1) >>
mosmon - openMosix load monitor
mosmon [ options ] ...
mosmon [ -w | -v | -V | -a ]
mosmon [ -s | -m | -r | -u | [ -l | -L ] ]
mosmon [ -d ] [ -t ] [ +NODE_NUMBER ]
mosmon [ -F KVER ]
mosmon [ -h | -H ]
Displays the load, speed and memory of openMosix nodes as
a bar chart.
The following options and (interactive keys) are avail-
able:
-w (w) Wide (horizontal) numbering. Although this allows
the load of fewer nodes to be displayed simulta-
neously, it looks better visually.
-v (v) Vertical numbering. This allows more nodes to be
displayed simultaneously.
-V (V) Vertical (tight) numbering. This allows the maxi-
mum number of nodes to be displayed simultane-
ously.
-a (a) Automatic numbering (default). Vertical numbering
is selected if it allows all nodes to be dis-
played simultaneously. Otherwise, horizontal num-
bering is selected.
-s (s) Speed of processor (10000 = 400 MHz Pentium-2).
For SMP nodes, this option also displays the num-
ber of CPU's.
-m (m) Memory (MB). Used memory is displayed as a solid
bar, free memory is displayed as '+' signs
extended to total memory size.
-r (r) Raw memory (MB). Raw-used memory is displayed as
a solid bar, free memory is displayed as '+'
signs extended to total memory size.
-u (u) Utilizability (%). This represents the proportion
of time a node spends running processes, or wait-
ing for swapped-pages to be loaded. Under normal
conditions, utilizability should be 100%, drop-
ping only when memory is under pressure.
-l (l) Load (default). A load unit represents 100% util-
isation of a 'standard' processor. If the speed
of a CPU is the same as the yardstick, one load
unit is equivalent to a load average of 1.0 as
displayed by "top", "mtop" and "uptime". How-
ever, nodes with faster CPU's and/or SMP nodes
with multiple CPU's will show a lower load and
nodes with slower CPU's will show a higher load.
-L (L) Log load. Displaying the load on a log scale
makes it easier to assess load balancing when
cluster performance is uneven. The log scale is
fixed at 0.0-4.0 where 2.0 = log10(100%).
-d (d) Dead nodes. Display all configured nodes includ-
ing nodes that are not responding.
-t (t) Total number of operational nodes. (not recom-
mended on very large clusters, will be very slow)
+NODE_NUMBER
begin the display at a particular node-number
-F KVER force kernel version instead of guessing
/proc/hpc/info/infos record size. KVER range is
2416-2425, useful values are
[2416|2419|2420|2421|2422|2423] (devel/debug)
-h|-H display short help message
The following keys may also be used while in mosmon:
h|H|? bring up a help screen.
Enter redraw the screen.
y Yardstick (default = 15000). This is the speed
of a 'standard' processor.
Insert force update of /proc/hpc/info/infos handling
stuff (useful when openMosix has been restarted
while mosmon is running).
q|Q Quit mosmon.
The following keys are useful when all nodes do not fit on
the screen:
Right-Arrow|+
Right shift display. Move one node to the right
Left-Arrow|-
Left shift display. Move one node to the left
n Next screen. Move one screen to the right
p Previous screen. Move one screen to the left
load
A CPU cannot be more than 100% utilised, but a load can
be more than 100% of CPU utilisation when processes are
candidates to run but cannot run because they are
blocked waiting for CPU or other limited resources to
become available.
- Minimum screen size 9x8, minimum suggested size 43x9 ;)
Display total configured nodes and begin displaying at
node 12:
mosmon -t +12
Display cluster load on a log scale and display dead
nodes:
mosmon -L -d
Force a specific kernel version (infos record size):
mosmon -F 2420
Help message for command line options:
mosmon -h
/proc location of the proc file system
/proc/hpc location of the openMosix proc
interface
/proc/hpc/info/infos cluster info (load,status,...)
/proc/hpc/admin/sspeed standard speed (used to compute
yardstick)
mosmon is affected by LINES and COLUMNS environment vari-
ables.
A specific screen size can be forced in this way:
COLUMNS=80 LINES=24 mosmon
On success, exit status is zero. On error, 1 is returned.
Usage function returns a short line describing the error
that occurred.
When the 't' option is used, the message "openMosix not
configured" means that openMosix is not enabled on the
node running mosmon.
In previous versions of mosmon this could also mean that
mosmon had been compiled against the wrong kernel headers
(i.e. the size of the mosix_info structure used by mosmon
and the openMosix kernel don't match).
In mosmon v2.0 the size of the mosix_info structure used
by the running openMosix kernel is detected automatically.
Please send bug reports to <openmosix-devel@lists.source-
forge.net> and <baro@democritos.it>.
mosmon is an openMosix utility.
Amnon Shiloh for Mosix, original code is (c) of prof.
Amnon Barak.
Adapted to openMosix from Mosix and bugfixing by David
Santo Orcero <irbis@orcero.org>
Last (heavily) modified on 2004/04/07 by Moreno 'baro'
Baricevic <baro@democritos.it>.
Thanks also to Tony Travis <ajt@rri.sari.ac.uk> for his
log-load patch.
Permission to use, copy and distribute this software is
hereby granted under the terms of version 2 or any later
version of the GNU General Public License, as published by
the Free Software Foundation.
openmosix(1), setpe(1), mtop(1).
openMosix April 07, 2004 MOSMON(1) >>
Last modified: Fri, 01 Oct 2004 - 15:24:11 CEST