MOSRUN(1) System General Commands Manual MOSRUN(1) >>
mosrun - run a command with particular node-allocation preferences
mosrun [-{h | openMosix_ID | jID1-ID2 [,ID3-ID4] ... } [-F]] [-{l|L|k}]
[-{c|i|n|s|f| [-t tt] [-d dec] } [-{e|E}] [-{r|R}]] [-z]
command [ arg ... ]
nomig [-z] command [ arg ... ]
runhome [-z] command [ arg ... ]
runon openMosix_ID [-z] command [ arg ... ]
cpujob [-{h|openMosix_id}] [-z] command [ arg ... ]
iojob [-{h|openMosix_id}] [-z] command [ arg ... ]
nodecay [-{h|openMosix_id}] [-z] command [ arg ... ]
slowdecay [-{h|openMosix_id}] [-z] command [ arg ... ]
fastdecay [-{h|openMosix_id}] [-z] command [ arg ... ]
mosrun runs a command while advising openMosix about the placement, node-
lock status and the best method of decaying its openMosix per-process
statistics to suit the program's behaviour.
The -h option (h for "home") requests that the command be run on the home
node. Similarly, a numeric option (-openMosix_ID) requests that the pro-
cess be run on a particular openMosix node. mosrun will fail should that
node be unavailable, unless the -F option is specified, in which case,
the program could run anywhere. The -jID-LIST option selects a random
node from among the supplied list of nodes. the list should be comma-
separated and may contain any combination of either single openMosix node
numbers, or dash-separated range of openMosix nodes. Again, mosrun will
fail should the selected random node be unavailable (unless the -F option
is specified).
The node-lock, preventing automatic process-migrations (except in emer-
gencies, such as when a node is being shut-down, in which case the pro-
cesses will migrate to their home-node), can be controlled via one of the
-l (unlock), -L (lock) or -k (keep) flags.
The default is to lock whenever either -h, -openMosix_ID or -j are speci-
fied or when no decay options are specified and to otherwise keep the
status as per the calling shell/program.
The -c option advises openMosix that the program is heavy user-mode com-
putational and should therefore ignore the statistics of any I/O or other
system-calls.
The -i option advises openMosix that the program uses heavy I/O or other
system calls and should therefore ignore the statistics of any user-mode
CPU usage.
The -n option advises openMosix that the program runs an irregular pat-
tern of mixed CPU and I/O (or other system-calls), thus decaying should
not be applied.
The -s option advises openMosix to apply slow decaying over the program's
statistics (this is also openMosix's default).
The -f option advises openMosix to apply fast decaying over the program's
statistics, indicating a program that alternates between large-granular-
ity chunks of CPU and I/O (or other system-calls).
The -d option and/or the -t option specifies explicitly how often to
decay the statistics for the program and what portion of the statistics
should remain after decaying: tt specifies the interval between decays in
seconds and dec specifies the (integer) portion to keep out of 1000
units. If only one of -d or -t is specified, the other is obtained from
the current decaying policy (or if the current policy is either -c or -i,
from the current default settings, eg. of a slow decay).
The -e argument specifies that the new decaying preferences will cease to
apply for any of the generated processes that performs a successful
exec(3) system call. -E (the default) specifies that the decaying pref-
erences be kept even across an exec(3).
The -r argument specifies that the new decaying preferences will not be
inherited to the program's child processes (and further descendants),
while -R (the default) specifies that the decaying preferences be inher-
ited.
The -z argument specifies that the argument-list begins with argument
number zero (which is normally identical to the command), rather than the
usual argument number one.
Without any options, 'mosrun command arg ...' is equivalent to
'mosrun -L command arg ...'.
On a plain, non-openMosix Linux operating system, mosrun will simply
spawn the command with no side-effects.
The following scripts operate as simple front-ends to mosrun:
Nomig runs a command with a node-lock.
Runhome runs a command locked at the home node.
runon runs a command locked on a particular openMosix node.
cpujob runs a command, advising openMosix that it is a computation inten-
sive program.
iojob runs a command, advising openMosix that it is an I/O intensive pro-
gram.
nodecay runs a command, advising openMosix to not decay the program's
statistics.
slowdecay runs a command, advising openMosix to apply slow statistics-
decaying.
fastdecay runs a command advising openMosix to apply fast statistics-
decaying.
mosrun -7 -F -c program
runs a computation-intensive program on openMosix node #7, if available.
mosrun -j2-5,7,10-16 program arg
runs a program on a random node among node numbers 2-5, 7 or 10-16.
mosrun -h -l -i -r job_manager file-name
runs a program (job_manager) initially on the home-node, but allowing it
to subsequently migrate. openMosix is informed that the main process, a
manager is heavily I/O bound, but that its children are not so necessar-
ily.
mosrun -t 1 -d 700 two_phases
runs a program that alternates between a relatively long I/O phase and a
computational phase. openMosix is advised to decay the statistics very
quickly - leaving only 70% every second, so that the program is migrated
away quickly between the home node and a most available/fast node when-
ever it switches between stages.
openmosix(1), cpujob(1), fastdecay(1), iojob(1), joingroup(1),
migrate(1), migrategroup(1), mosmon(1), mosctl(1), mosrun(1), mps(1),
mtop(1), nodecay(1), nomig(1), omdiscd(1), resetgroup(1), runhome(1),
runon(1), setpe(1), showgroup(1), slowdecay(1)
mosrun is an openMosix utility.
openMosix May 3, 1999 openMosix >>
Last modified: Fri, 01 Oct 2004 - 15:24:09 CEST