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:08 CEST