8.3. the userspace-tools
These following tools are providing easy administration to openMosix
clusters.
migrate -send a migrate request to a process
syntax:
migrate [PID] [openMosix_ID] |
mon -is a ncurses-based terminal monitor
several informations about the current status are displayed in bar-charts |
mosctl -is the openMosix main configuration utility
syntax:
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|openMosix_ID||this]
mosctl setspeed interger-value
mosctl setdecay interval [slow fast] |
Table 8-6. more detailed
|
stay | no automatic process migration |
|
nostay | automatic process migration (default) |
| lstay | local processes should stay |
| nolstay | local processes could migrate |
| block | block arriving of guest processes |
| noblock | allow arriving of guest processes |
| quiet | disable gathering of load-balancing informations |
| noquiet | enable gathering of load-balancing informations |
| nomfs | disables MFS |
| mfs | enables MFS |
| expel | send away guest processes |
| bring | bring all migrated processes home |
| gettune | shows the current overhead parameter |
| getyard | shows the current used Yardstick |
| getdecay | shows the current decay parameter |
| whois | resolves openMosix-ID, ip-addresses and hostnames of the cluster |
| getload | display the (openMosix-) load |
| getspeed | shows the (openMosix-) speed |
| status | displays the current status and configuration |
| isup | is a node up or down (openMosix kind of ping) |
| getmem | shows logical free memory |
| getfree | shows physical free mem |
| getutil | display utilization |
| setyard | sets a new Yardstick-value |
| setspeed | sets a new (openMosix-) speed value |
| setdecay | sets a new decay-interval |
mosrun -run a special configured command on a chosen node
syntax:
mosrun [-h|openMosix_ID| list_of_openMosix_IDs] command [arguments] |
The mosrun command can be executed with several more commandline options.
To ease this up there are several preconfigured run-scripts for executing
jobs with a special (openMosix) configuration.
Table 8-7. extra options for mosrun
| nomig | runs a command which process(es) won't migrate |
| runhome | executes a command locked to its home node |
| runon | runs a command which will be directly migrated and locked to a node |
| cpujob | tells the openMosix cluster that this is a cpu-bound process |
| iojob | tells the openMosix cluster that this is a io-bound process |
| nodecay | executes a command and tells the cluster not to refresh the load-balancing statistics |
| slowdecay | executes a command with a slow decay interval for collecting load-balancing statistics |
| fastdecay | executes a command with a fast decay interval for collecting load-balancing statistics |
setpe -manual node configuration utility
syntax:
setpe -w -f [hpc_map]
setpe -r [-f [hpc_map]]
setpe -off
-w reads the openMosix configuration from a file (typically /etc/hpc.map)
-r writes the current openMosix configuration to a file (typically /etc/hpc.map)
-off turns the current openMosix configuration off |
tune openMosix calibration and optimizations utility.
(for further informations review the tune-man page)
|
Additional to the /proc interface and the commandline-openMosix utilities
(which are using the
/proc interface) there is a patched "ps" and "top" available (they are
called "mps" and "mtop")
which displays also the openMosix-node ID on a column. This is useful for
finding out where a
specific process is currently being computed.
This actually summarised the command line tools, but have a look at
openMosixview which is
a
GUI for the most common
administration tasks, and which ill be discussed in a future chapter.