SETPE(1)                System General Commands Manual                SETPE(1)  >>

NAME

     setpe - openMosix node configuration

SYNOPSIS

     setpe -[w|W] [-n inet] [-c] [-p openMosix-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
     openMosix cluster by mapping their IP addresses into openMosix-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 openMosix 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-openMosix-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
     openMosix nodes, thus having multiple IP addresses, it could be indenti-
     fying itself in outgoing IP packets using one of the other addresses,
     which may cause openMosix to fail to recognize the sender.  Table entries
     of the following form are used to clear the confusion:

     Gateways's-openMosix-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 openMosix-ID, is usu-
     ally determined by gethostname(3), unless the -p openMosix-ID argument
     specifies otherwise (this is required in case the openMosix 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 openMosix node and any other openMosix 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 pro-
     grams 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 main-
     tained (or the default of 0).

     The openMosix configuration may be modified at any time, but when open-
     Mosix is already configured and the new table would cause a change to
     either the node's own openMosix-ID or IP address, openMosix 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 configura-
     tion.


FILES

     /etc/hosts               recognised nodes.
     /etc/init.d/openmosix    script from which setpe is normally called.


SEE ALSO

     openmosix(1), mosmon(1).


HISTORY

     setpe is an openMosix utility.

openMosix                       August 5, 1999                       openMosix  >>