#############################################################################
#
#     This Cplant(TM) source code is the property of Sandia National
#     Laboratories.
#
#     This Cplant(TM) source code is copyrighted by Sandia National
#     Laboratories.
#
#     The redistribution of this Cplant(TM) source code is subject to the
#     terms of the GNU Lesser General Public License
#     (see cit/LGPL or http://www.gnu.org/licenses/lgpl.html)
#
#     Cplant(TM) Copyright 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005 
#     Sandia Corporation. 
#     Under the terms of Contract DE-AC04-94AL85000, there is a non-exclusive
#     license for use of this work by or on behalf of the US Government.
#     Export of this program may require a license from the United States
#     Government.
#
#############################################################################


DISKFULL MODULE OVERVIEW
-------------------------
This module enables diskfull booting. Prior to installing 
this module, you must have installed the base module as well 
the distros module. Additionally, you must have created a
distro object and have run the build_disto command. For
further instructions on how to do this, please consult the
INSTALL.distros document. If you have already done this,
then follow the instructions below. 

PROCESS
--------
* Install the module following the standard steps
	# ./configure; make; make install
* After you have installed the module, you have a 
  choice between two methods for creating a diskfull
  installation. The first method employs the 
  build_diskfull tool and the second uses the cclone
  tool to do a kickstart install. Since the second
  method is documented in the diskfull.kickstart
  module, this document focuses on how to use
  the build_diskfull tool. To employ the build_diskfull
  tool, the nodes must already be successfully booting 
  diskless. 
* Prior to running the build_diskless command, configure 
  your database for a diskfull install. In particular, 
  set the bootmode attribute to diskfull and set the disks 
  attribute to reflect the partitioning and formatting 
  information. (The build_diskfull tool provides a good 
  description of the disks attribute: #perldoc build_diskfull).
* Next, backup your original pxe configuration files so that
  if you have trouble booting diskfull, you can reboot diskless
  for troubleshooting without having to change your database. 
  Then use the mk_conf tool to regenerate pxe configuration files.
* Test the installation on one node by rsh'ing directly 
  to that node and issuing the build_diskfull command.
  You can build the distribution in steps or supply the
  --full option, which is equivalent to --prep --mount 
  --update --image --boot 
      # build_diskfull --full 
* Reboot and watch the console
* If the node doesn't boot, then you can always troubleshoot
  by booting in diskless mode and then issuing the following
  command.
      #	build_diskfull --mount
  This command will mount your new partitions and enable you 
  to look and troubleshoot the configuration files for the 
  the diskfull installation.