Skip to content

Commit

Permalink
Update docs for move to github
Browse files Browse the repository at this point in the history
  • Loading branch information
garlick committed Aug 21, 2014
1 parent 722cc0a commit 7353323
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 1 deletion.
2 changes: 1 addition & 1 deletion README
Original file line number Diff line number Diff line change
Expand Up @@ -8,4 +8,4 @@ All that is left is:
- rc scripts which try various methods to make root read-write and exec init
- tools for maintaining pxelinux.cfg and grubby hooks to keep it updated

kdump and mklivecd support is still pending.
mklivecd support is still pending.
35 changes: 35 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
*nfsroot* is a package designed to help make Linux root file system
images network-bootable and sharable by many clients. It was designed
for the CHAOS Linux distribution (now renamed to TOSS) for clusters,
developed at Lawrence Livermore National Laboratory, but will work with
other Red Hat Enterprise Linux derived distros.

*nfsroot* distinguishes itself from other tools for managing diskless
clusters by restricting itself to things that can be done by a package
installed within the root image, e.g.:

* management of initramfs images in /boot (leveraging dracut) and
pxelinux boot options
* making a shared, read-only root file system usable using selectable
methods (unionfs, aufs, bind-mounts, etc)
* hook for saving kdump vmcore images to NFS
* hook for configuration management before init starts

The goal is that one can install the *nfsroot* RPM into a root image
and presto, it becomes bootable and sharable given appropriate server
configuration.

*nfsroot* leaves the root server configuration and configuration management
within the image to your superior mental prowess. This minimalist design
is intended for sites (like ours) that already have procedures and
techniques in place for managing these subsystems and don't want a
diskless solution to help.

*nfsroot version 4* will run on TOSS 3 (RHEL 7 based), _in development_.

*nfsroot version 3* runs on CHAOS 5/TOSS 2 (RHEL 6 based), _feature-frozen_.

*nfsroot version 2* ran on CHAOS 4/TOSS 1 (RHEL 5 based), _end-of-life_.

*nfsroot version 1* ran on CHAOS 3 (RHEL 4 based), _end-of-life_.

0 comments on commit 7353323

Please sign in to comment.