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.