kusu-boothost(8)		   Kusu Base		      kusu-boothost(8)



NAME
       kusu-boothost - Creates the PXE configuration files for node booting.

SYNOPSIS
       kusu-boothost [-h|-v|-l {optional nodename}]

       kusu-boothost [-n node_group] | [-m node_list] | [-s node_group]
		[-r] [-k Kernel] [-i Initrd] [-p Kern_Parms]

DESCRIPTION
       The  kusu-boothost  tool	 creates  PXE  configuration files for booting
       nodes over the network.	 The  command  reads  kernel,  initrd,	kernel
       parameters and desired boot device from the database and constructs the
       PXE file for the node(s) in /tftpboot/kusu/pxelinux.cfg/.  The  command
       is  typically  called  by  the  other  tools such as kusu-ngedit, kusu-
       nghosts, and kusu-addhost, but can also be run manually.

       The tool can provide a list of the nodes and their booting state	 using
       the -l option.  This will list the nodes network information along with
       nodes installation state and nodegroup.

       The command provides a way of overriding the  default  kernel,  initrd,
       and kernel parameters of a given nodegroup.  This option can be used to
       try custom kernels on one or mode nodes without affecting all nodes  in
       a  nodegroup.   The command can also be used to revert the kernel, ini-
       trd, and kernel parameters back to the nodegroups default values.



OPTIONS
       -h, --help
	      Output help information and exit.

       -i <Initrd>,
	      Override the nodegroups initrd with the one provided.  The  ini-
	      trd  must	 reside	 in /tftpboot/kusu/ for the node to locate and
	      use it.  This option is not needed for normal use.

       -k <Kernel>,
	      Override the nodegroups default kernel with  the	one  provided.
	      The  kernel must exist in /tftpboot/kusu/ for the node to locate
	      and use it.  This option can be  used  to	 test  custom  kernels
	      without affecting other nodes in the nodegroup.

       -l <Optional Nodename>
	      Provide node booting information and status for all nodes provi-
	      sioned by the installer.	If the	<Optional  Nodename>  is  pro-
	      vided,  then  provide  this  information for this node only. The
	      information provided will include:

		 - Node name
		 - Nodegroup
		 - State [Expired|Installed]
		 - Where to boot from next [Disk|Network]
		 - Kernel to use
		 - Initrd to use
		 - Kernel Parameters
		 - MAC address of booting interface
		 - IP address of booting interface

       -m <Node List>
	      Update the PXE configuration files for the node(s) listed.  This
	      is  a  comma separated list.  The command will read the database
	      and regenerate the booting PXE file.

       -p <Kernel Paramaters>,
	      Override the nodegroups default kernel parameters with the  ones
	      provided.	 Note:	Remember to verify the paramaters are set cor-
	      rectly when they	contain	 quote	characters  by	using  the  -l
	      option.

       -r     Attempt  to connect to and reboot the requested node(s) or node-
	      group.  This uses pdsh, but may be slow if nodes are down.

       -s <Nodegroup>
	      Update the PXE configuration files for the nodes	in  the	 node-
	      group  that  are	in  a state or expired.	 This is option may be
	      removed if not useful.  If any custom kernel, initrd, or	kernel
	      parameters  were used these will be reset back to the nodegroups
	      defaults.

       -n <Nodegroup>
	      Update the PXE configuration files for the nodes	in  the	 node-
	      group.   If any custom kernel, initrd, or kernel parameters were
	      used these will be reset back to the  nodegroups	defaults.   If
	      used  in conjunction with -r it will trigger the re-installation
	      of all nodes in the specified nodegroup.

       -v     Output version information and exit.

FILES
       /tftpboot/kusu/pxelinux.cfg/*


EXAMPLES
       List the booting information for all nodes:

	  kusu-boothost -l

       List the booting information for node host000:

	  kusu-boothost -l host000

       Rebuild the PXE configuration file for nodes host000 and host999:

	  kusu-boothost -m host000,host999

       Rebuild the PXE configuration file for  all  nodes  in  nodegroup  com-
       pute-diskless-test

	  kusu-boothost -n compute-diskless-test

       Rebuild the PXE configuration file for host000 and set a custom kernel,
       initrd, and kernel parameters.

	  kusu-boothost -m host000 -k kernel-custom  -i	 initrd-custom.img  -p
       'param1 booger=nuggets'

AUTHORS
       Mark Black <mblack_at_platform_dot_com>

SEE ALSO
       kusu-ngedit(8) kusu-addhost(8) kusu-nghosts(8)



Mark Black			Version: 2.0.1		      kusu-boothost(8)