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 available:
-w (w) Wide (horizontal) numbering. Although this allows the load of fewer nodes to be displayed simultaneously, it looks bet-
ter visually.
-v (v) Vertical numbering. This allows more nodes to be displayed simultaneously.
-V (V) Vertical (tight) numbering. This allows the maximum number of nodes to be displayed simultaneously.
-a (a) Automatic numbering (default). Vertical numbering is selected if it allows all nodes to be displayed simultaneously.
Otherwise, horizontal numbering is selected.
-s (s) Speed of processor (10000 = 400 MHz Pentium-2). For SMP nodes, this option also displays the number 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 waiting for swapped-pages
to be loaded. Under normal conditions, utilizability should be 100%, dropping only when memory is under pressure.
-l (l) Load (default). A load unit represents 100% utilisation 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 including nodes that are not responding.
-t (t) Total number of operational nodes. (not recommended 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 variables.
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.sourceforge.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