LAMGROW(1) LAM COMMANDS LAMGROW(1)NAMElamgrow - Extend a LAM multicomputer.
SYNTAXlamgrow [-hvd] [-cpu <num>] [-n <nodeid>] [-no-schedule] [-ssi <key>
<value>] <hostname>
OPTIONS-cpu <num> Indicate how many CPUs are available to LAM on the new
node.
-d Turn on debugging output. This implies -v.
-h Print useful information on this command.
-n <nodeid> Assign this ID to the new node.
-no-schedule Indicate that C and N expansion in mpirun and lamexec
should not schedule on this node.
-ssi <key> <value>
Send arguments to various SSI modules. See the "SSI"
section, below.
-v Be verbose.
<hostname> Extend LAM with this host.
DESCRIPTION
An existing LAM universe, initiated by lamboot(1), can be enlarged to
include more nodes with lamgrow. One new node is added for each invo‐
cation. At a minimum, the host name that will run the new node is giv‐
en on the command line. If a different userid is required to access
the host, it is specified with the appropriate boot SSI options (see
lamssi_boot(7)).
The new node can be assigned any unused, non-negative identifier. If
no identifier is specified, the highest node identifier in the current
LAM universe plus one is used. Note that lamboot(1) always assigns
node identifiers consecutively from 0.
lamgrow can be run from any node in the current LAM universe. Specifi‐
cally -- it cannot be run from the intended new host. Two invocations
of lamgrow should not run concurrently, and the command attempts to de‐
tect this situation. The name of the host specified in lamgrow should
not be the one which is already present in the user's LAM universe and
the command attempts to detect this situation too.
Resource managers will be the most common user of lamgrow. When hosts
become idle and a user has expressed a desire to the manager that extra
cycles should be exploited, the manager could invoke lamgrow and then
launch the specified application process(es) on the new node.
EXAMPLESlamgrow-v newhost
Start LAM on newhost and add it to the existing LAM universe.
Choose the next available node identifier and report about impor‐
tant steps as they are done.
lamgrow-n 30 newhost
Start LAM on newhost with node ID 30 and add it to the existing LAM
universe. Operate silently.
FILES
laminstalldir/etc/lam-conf.lamd default configuration file for LAM
nodes, where "laminstalldir" is the
directory where LAM/MPI was in‐
stalled.
BUGS
It is not currently possible to specify a configuration file other than
lam-conf.lamd on the remote node, even though this is possible with
lamboot.
SEE ALSOlamboot(1), lamhalt(1), hboot(1), lamwipe(1), tkill(1), bhost(5),
conf(5), lamssi_boot(7)LAM 7.1.2 March, 2006 LAMGROW(1)