grml-live [-c <classe[s]>] [-t <target_directory>] [-F] [-h|--help]
*******************************************************************************
-Important! grml-live is under heavy construction, your feedback is highly
+Important! grml-live is under heavy construction, though your feedback is highly
appreciated. This document is growing as requested. If you have questions which
aren't answered by this document yet please let me (mika@grml.org) know!
*******************************************************************************
independent!
[NOTE]
+
Please notice that you should have a fast network connection as all the Debian
packages will be installed via network. If you want to use a local mirror
-(strongly recommended!) checkout
-mkdebmirror (see /usr/share/doc/grml-live/examples/mkdebmirror)
-debmirro(1) and reprepro(1) (check out
-/usr/share/doc/grml-live/examples/reprepro/ for a sample configuration).
-To avoid downloading of the base system check out FAI's
-NFSROOT (check docs for ../fai/nfsroot/live/filesystem.dir/var/tmp/base.tgz).
+(strongly recommended!) checkout mkdebmirror (see
+/usr/share/doc/grml-live/examples/mkdebmirror), debmirror(1), reprepro(1) (see
+/usr/share/doc/grml-live/examples/reprepro/ for a sample configuration) and
+approx(8). To avoid downloading of the base system check out FAI's NFSROOT (check
+docs for ../fai/nfsroot/live/filesystem.dir/var/tmp/base.tgz).
Options
-------
the classes GRMLBASE and I386 are assumed, resulting in a small base system
(being about ~150MB ISO size).
+ -s **SUITE**::
+
+Specify the Debian suite you want to use for your live-system. Defaults to
+"etch"; support values are: etch, lenny, sid, stable, testing, unstable.
+
-t **TARGET_DIRECTORY**::
-Output directory of the build process of FAI - being the chroot
-used for building the ISO.
+Main output directory of the build process of FAI. Three directories are
+created inside the target directory, being: grml_cd/ - where the files for
+creating the ISO are located (including the compressed squashfs file),
+grml_chroot/ - the generated chroot system and grml_isos/ - where the resulting
+ISO is stored.
-F::
-Force execution and do not display summary of configuration details.
+Force execution and do not prompt for / display summary of configuration
+details.
- -h|--help::
+ -h::
Display short usage information and exit.
+ -v::
+
+Increase verbosity in the build process.
+
How to get your own live-cd - the easy, fast and simple way
-----------------------------------------------------------
-To get a small, Debian-stable and grml based live-cd using /dev/shm/
+To get a small, Debian-stable and grml based live-cd using /grml/grml-live
as build and output directory:
# grml-live
+To get a small Debian-unstable and grml-small based live-cd using
+/home/mika/grml-live as build and output directory:
+
+ # grml-live -c GRMLBASE,GRML_SMALL,I386 -t /home/mika/grml-live
+
[NOTE]
If you have about 700MB of free space inside /dev/shm (being a tmpfs, usually
empty /dev/shm, so please another directory for $CHROOT_TARGET, $BUILD_TARGET
and $ISO_TARGET if you plan to create more persistent output. :)
+Features
+--------
+
+* create a grml-/Debian-based Linux Live-CD with one single command
+
+* class based concept, providing a maximum of flexibility
+
+* supports integration of own hooks, scripts and configuration
+
+* supports use and integration of own Software and/or Kernels via use of Debian
+repositories
+
+* native support of FAI features
+
+* multi-arch support (work in progress)
+
The class concept
-----------------
Known TODOs
-----------
-* do not use /dev/shm/ als default target directory (which one do we want to use
-instead?)
+* make sure the suite-target adjusts the mirror definitions according (working
+also vice versa!)
* add support for amd64 [gebi?] + ppc [formorer?] (and identify all packages
that are arch specific so we have a clean package list in all classes)
* support different grml-flavours through classes right out-of-the-box (being:
-grml, grml64, grml-small for at least x86, amd64 and ppc)
-
-* support setting grml-live configuration on the command line to provide
-different flavours using the commandline only
-
-* really support signed apt repositories (currently it's deactivated via fai's
-dirinstall for some packages)
+grml, grml64, grml-small (in progress) for at least x86, amd64 and ppc)
-* explain (and provide configuration for) the use of NFSROOT
+* support signed apt repositories (currently it's deactivated via FAI's
+FAI_ALLOW_UNSIGNED=1 for some packages in the toolchain)
-* support setting stuff like ISO name, version,... (especially for stuff inside
-x86_files/boot/isolinux)
+* explain (and provide configuration for) use of NFSROOT
-* support "final builds" (including stuff like md5sums)
+* support setting stuff like ISO name, version,... on-the-fly (especially for
+stuff inside boot/isolinux/*)
-* use hooks of FAI as far as possible in all grml-live scripts
+* support "final builds" (including stuff like generating md5sums, gpg,...)
* the grml-live class(es) should send output as used inside FAI as well (so it's
not as verbose unless you specify it, make it configurable)
-* provide possibility for cleanup of all created build directories
+* provide possibility for cleanup of all created build directories and
+a smart summary of the buildprocess (including "took ... minutes/seconds to
+build...)
+
+* support hooks to allow further customisation of the build process
+
+* test the package on non-grml systems (and maybe even non-Debian) as well
+
+Debian package
+--------------
+
+Debian packages will be available through the grml-repository at
+link:http://deb.grml.org/[http://deb.grml.org/] as soon as the grml-team
+considers grml-live as stable enough. In the meantime just build the package on
+your own:
+
+ hg clone http://hg.grml.org/grml-live
+ cd grml-live
+ debuild -us -uc
-* support hooks to further allow customisation of the build process
+Source
+------
-* support nocolor-option for /etc/grml/fai/grml/grml_cleanup_chroot
+The source of grml-live is available at
+link:http://hg.grml.org/grml-live/[http://hg.grml.org/grml-live/]
Bugs
----
projects / grml-live.git / blobdiff