kusu-buildimage(8)		   Kusu Base		    kusu-buildimage(8)



NAME
       kusu-buildimage	-  Builds  the root filesystem for diskless and imaged
       nodes.

SYNOPSIS
       kusu-buildimage [OPTIONS] -n <nodegroup name>

DESCRIPTION
       The kusu-buildimage tool creates the  root  ("/")  filesystem  for  the
       Diskless	 and  Imaged nodes to download and use.	 The tool is typically
       called automatically by the Nodegroup  Editor  (kusu-ngedit),  but  can
       safely  be manually run as well.	 The tool will install all of packages
       and components associated with the requested nodegroup  into  the  root
       filesystem  used by the nodes.  The tool will build the image and place
       it in /depot/images.

       The tool should be called when the list of packages,  or	 the  list  of
       components to install on a node change.	It may be run when other node-
       group properties change.

       Caution should be taken to ensure  there	 is  enough  disk  space  when
       building	 images.   It will require almost twice the uncompressed image
       size while the image is being generated.



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

       -i <IMAGE>, --image=<IMAGE>
	      Do not use the default image name from the  database.   Override
	      it  with	IMAGE.	Note the nodes will not use this image without
	      first replacing the existing image file in /depot/images.

       -n <Nodegroup Name>, --nodegroup=<Nodegroup Name>
	      The name of the nodegroup to build the image for.

       -v, --version
	      Output version information and exit.

       -d, <DATABASE>, --database=<DATABASE>
	      Connect to an alternate database to read the nodegroup  informa-
	      tion from.  This option is not needed for normal use.

       -u, <USER>, --database=<USER>
	      Connect  to  an  alternate  database  as user <USER> to read the
	      nodegroup information from.  This option is not needed for  nor-
	      mal use.

       -p, <PASSWORD>, --password=<PASSWORD>
	      Connect  to an alternate database using the password provided to
	      read the nodegroup information from.  This option is not	needed
	      for normal use.

FILES
       /depot/images/* /opt/kusu/initrds/*



EXAMPLES
       To  generate  a	new root filesystem for the default diskless nodegroup
       using Red Hat 5 run:

       kusu-buildimage -n compute-diskless-rhel-5-x86_64


AUTHORS
       Mark Black <mblack_at_platform_dot_com>

SEE ALSO
       kusu-buildinitrd(8) kusu-boothost(8) kusu-ngedit(8)



Mark Black			Version: 2.0.1		    kusu-buildimage(8)