hboot man page on YellowDog

Man page or keyword search:  
man Server   18644 pages
apropos Keyword Search (all sections)
Output format
YellowDog logo
[printable version]

HBOOT(1)			   LAM TOOLS			      HBOOT(1)

NAME
       hboot - Start LAM on the local node.

SYNTAX
       hboot [-dhstvNV] [-c <conf>] [-I <inet_topo>] [-R <rtr_topo>]

OPTIONS
       -d	       Turn on debugging.  This implies -v.

       -h	       Print the command help menu.

       -s	       Close stdio of child processes.

       -t	       Terminate  (tkill(1))  any  previous LAM session before
		       starting.

       -v	       Be verbose.

       -N	       Go through the motions but do not actually take any ac‐
		       tion.

       -V	       Format and print the process schema.

       -c <conf>       Use <conf> as the process schema.

       -I <inet_topo>  Set the $inet_topo variable in the process schema.

       -R <rtr_topo>   Set the $rtr_topo variable in the process schema.

DESCRIPTION
       Most  MPI  users	 will  probably not need to use the hboot command; see
       lamboot(1).

       The hboot tool can be understood as a generic utility that starts  mul‐
       tiple  processes	 on  the local node, based on information in a process
       schema.	It is not restricted to starting  LAM.	 It  is	 part  of  the
       startup sequence preformed by lamboot(1).

       A process schema is a description of the processes which constitute the
       operating system on a given node.  Naturally, the process  schema  used
       by  hboot  should be the one that describes LAM on a node.  The grammar
       of the process schema is described in conf(5).

       When starting LAM on a remote machine using rsh(1), the open  file  de‐
       scriptors of the processes started by hboot must be closed in order for
       rsh(1) to exit.	This is done by using the -s option.   The  -t	option
       can  be	used  to  force a tkill(1) on the machine before attempting to
       start LAM.  This feature is used by lamboot(1) to handle the case where
       a  user might start a machine a second time without using lamwipe(1) to
       terminate the previous LAM session.

       The -I and -R options set their respective variables to the given  val‐
       ues.   The  $inet_topo  variable	 is typically used by the LAM Internet
       datalinks that communicate with other nodes.  The $rtr_topo variable is
       passed to the LAM router that handles network and topology information.
       The variables can also be set in the process schema file (see  conf(5))
       but their values are overridden by the command line options.

       When  LAM  is  started, the kernel records all processes that attach to
       it, including all the processes in the process schema.  It is  the  job
       of  tkill(1) to use this information to remove these processes from the
       node.

EXAMPLES
       hboot -v
	   Start LAM on the local node with the default process	 schema.   Re‐
	   port about every step as it is done.

       hboot -c myconfig
	   Boot the local node with the custom process schema, myconfig.

FILES
       laminstalldir/etc/lam-conf.lamd
				     default   node   process	schema,	 where
				     "laminstalldir" is	 the  directory	 where
				     LAM/MPI was installed

       laminstalldir/etc/lam7.1.2helpfile
				     Default  location for help file for diag‐
				     nostic messages that hboot may generate.

       /tmp/lam-$USER@<hostname>     kill file for the LAM session on  machine
				     <hostname>, where $USER is the userid.

DIAGNOSTICS
       Using  ps(1)  after hboot will display, among others, the LAM processes
       that have been started.	They may be killed one by one with kill(1), or
       all  at	once by killing the LAM kernel process with a HUP signal.  The
       preferred method is to use the LAM tool tkill(1) which should kill them
       all at once, and also remove the kill file.  New users should make lib‐
       eral use of ps(1) to gain confidence that the system is working proper‐
       ly.  In a disaster, ps(1) and kill(1) are your only hope of recovery.

SEE ALSO
       lamboot(1), tkill(1), conf(5), lam-helpfile(5)

LAM 7.1.2			  March, 2006			      HBOOT(1)
[top]

List of man pages available for YellowDog

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Tweet
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
....................................................................
Vote for polarhome
Free Shell Accounts :: the biggest list on the net