NAME
setpe – MOSIX node configuration
SYNOPSIS
setpe -[w|W] [-n inet] [-c] [-p MOSIX-ID] [-g {0|1|2}] [-f {filename|-}]
setpe -r [-f {filename|-}]
setpe -off
DESCRIPTION
setpe with the -w (or -W) argument configures which nodes belong to a MOSIX cluster by mapping their IP addresses into MOSIX-ID numbers (1-65535). setpe takes its input from the standard input or, if -f is used, from the specified file (use "-" for the standard intput).
setpe -r reads the current configuration. If -f is used, the output is written to the specified file (use "-" for standard output).
setpe -off shuts down MOSIX by removing the configuration.
To configure, a simple conversion table is given as input from either filename or the standard-input. Each line in the table has the following three, space-separated, fields:
first-MOSIX-ID hostname number-of-consecutive-nodes
The hostnames may be specified as either IP addresses or host-names that appear in /etc/hosts.
When a participating node is also used as a gateway between groups of MOSIX nodes, thus having multiple IP addresses, it could be indentifying itself in outgoing IP packets using one of the other addresses, which may cause MOSIX to fail to recognize the sender. Table entries of the following form are used to clear the confusion:
Gateways's-MOSIX-ID Alternate-IP ALIAS
The table may also contain empty lines or comment lines (beginning with a '#'). The number of entry-lines in the table is limited to 256.
The node's own IP address, hence its corresponding MOSIX-ID, is usually determined by gethostname(3), unless the -p MOSIX-ID argument specifies otherwise (this is required in case the MOSIX network is other than the node's standard network, hence uses a different IP address). In either case, the node's own IP address must be included within the supplied table.
The -c argument, causes setpe to only check the table's consistency, without making any actual changes.
The -g argument specifies the maximum number of gateways interposed between the current MOSIX node and any other MOSIX node (but no more than 2). This has the effect of increasing the time-out when requesting information about other nodes - however, it slows down programs such as mon(1) when too many of the configured nodes are not responding.
When not using the -g option, the value from any previous calls is maintained (or the default of 0).
The MOSIX configuration may be modified at any time, but when MOSIX is already configured and the new table would cause a change to either the node's own MOSIX-ID or IP address, MOSIX would need to first be shutdown, bringing all processes back home. Because of this drastic side-effect, the -W argument must be specified, while using the -w argument will produce an error message and not modify the configuration.
FILES
- /etc/hosts
-
recognised nodes.
- /etc/rc.d/init.d/mosix
-
script from which setpe is normally called.
SEE ALSO
HISTORY
setpe is a MOSIX utility.