X-Git-Url: https://git.grml.org/?p=grml-live.git;a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=02b3265df8f24ccf18814debbdf91885efc586ae;hp=8cc095570b8acc5f28176e84d5372f530e3c1573;hb=b97721f7f383f030396fa41bab2c80e5151cdda1;hpb=f3b335ea5c94d5cf24ec6b9184106b298849f311 diff --git a/docs/grml-live.txt b/docs/grml-live.txt index 8cc0955..02b3265 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -12,7 +12,8 @@ Synopsis grml-live [-a ] [-c ] [-C ] [-g ] [-i ] [-o ] [-r ] [-s -] [-t ] [-v ] [-bBFnNquVz] +] [-t ] [-v ] [-U ] [ +-AbBFnNquVz] CAUTION: Please check out <> for details about current state of involved @@ -54,6 +55,11 @@ for details). Options ------- + -A:: + +Clean up output directories before attempting the build. Packs the chroot +into a tar archive, and removes chroot and iso build directories before exiting. + -a **ARCHITECTURE**:: Use the specified architecture instead of the currently running one. This @@ -206,6 +212,10 @@ Specify place of the templates used for building the ISO. By default Update existing chroot instead of rebuilding it from scratch. This option is based on the softupdate feature of FAI. + -U **USERNAME**:: + +Sets ownership of all build output files to specified username before exiting. + -v **VERSION_NUMBER**:: Specify version number of the release. @@ -348,6 +358,9 @@ official grml release * REMOVE_DOCS: get rid of documentation directories (like /usr/share/doc, /usr/share/man/, /usr/share/info,...) +* SOURCES: retrieve Debian source packages after installation. Files will be +placed in the output directory under grml_sources. + * XORG: providing important packages for use with a base grml-featured X.org setup @@ -464,7 +477,7 @@ The FAI part of grml-live logs to /var/log/fai/$HOSTNAME/ - so the default being /var/log/fai/grml/. If you are using the grml-live buildd you will find the logs of the grml-live -run at /var/log/grml-buildd.stdout and /var/log/grml-buildd.stderr. +run at /var/log/grml-buildd.log. If you want to store build information in a database just install the grml-live-db Debian package. Further details available in the grml-live-db @@ -835,18 +848,6 @@ points to the specified directory instead of using /etc/grml/fai and all the configuration files, scripts and hooks will be taken from your '$GRML_FAI_CONFIG' directory. -[[fai-on-etch]] -Help, I'm using Debian etch and I don't have FAI version >3.2 -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ - - wget http://fai-project.org/download/etch/fai-client_3.2.8_all.deb \ - http://fai-project.org/download/etch/fai-server_3.2.8_all.deb \ - http://fai-project.org/download/etch/fai-doc_3.2.8_all.deb - dpkg -i fai-client_3.2.8_all.deb fai-server_3.2.8_all.deb fai-doc_3.2.8_all.deb - -or check out the link:http://fai-project.org/[FAI-homepage] for -further details. - [[how-to-debug]] I've problems with the build process. How to start debugging? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -940,6 +941,9 @@ taken as first entry in the generated sources.list so it's preferred over non-local mirrors. Using a fallback mirror (via providing several mirrors in GRML_LIVE_SOURCES as used by default) is a recommended setting. +If you want to use a HTTP Proxy (like apt-cacher-ng), set APT_PROXY. Example: +APT_PROXY="http://localhost:3142/" + [[add-additional-debian-packages]] How do I add additional Debian package(s) to my CD/ISO? ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ @@ -1020,25 +1024,20 @@ or if using /etc/grml/fai/config/basefiles/$CLASSNAME.tar.gz for: Existing base.tgz can be found at http://daily.grml.org/ [[apt-cacher]] -Set up apt-cacher / apt-cacher-ng for use with grml-live +Set up apt-cacher-ng for use with grml-live ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Make sure /etc/grml/grml-live.conf provides according GRML_LIVE_SOURCES and +Make sure /etc/grml/grml-live.local provides according APT_PROXY and FAI_DEBOOTSTRAP: - # cat /etc/grml/grml-live.conf + # cat /etc/grml/grml-live.local [...] - GRML_LIVE_SOURCES=" - deb http://localhost:3142/deb.grml.org grml-stable main - deb http://localhost:3142/deb.grml.org grml-testing main - deb http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free - " + APT_PROXY="http://localhost:3142/" [...] FAI_DEBOOTSTRAP="squeeze http://localhost:3142/cdn.debian.net/debian squeeze main contrib non-free" -Make sure apt-cacher / apt-cacher-ng is running ('/etc/init.d/apt-cacher -restart' or '/etc/init.d/apt-cacher-ng restart'). That's it. All downloaded -files will be cached in /var/cache/apt-cacher/ or /var/cache/apt-cacher-ng then. +Make sure apt-cacher-ng is running ('/etc/init.d/apt-cacher-ng restart'). +That's it. All downloaded files will be cached in /var/cache/apt-cacher-ng then. [[approx]] Set up approx for use with grml-live