X-Git-Url: http://git.grml.org/?p=grml-live.git;a=blobdiff_plain;f=docs%2Fgrml-live.txt;h=7e56bbd92be3a4cefad2385311b8a8dccf8133c3;hp=de7d401aeac3d03733cf52e23d04ac8047d61c4f;hb=25317dad266075062fbdf9fe85d26f3936a4cf17;hpb=8e04e2ca7f336657eabce9d9d11cb8c0195717d6 diff --git a/docs/grml-live.txt b/docs/grml-live.txt index de7d401..7e56bbd 100644 --- a/docs/grml-live.txt +++ b/docs/grml-live.txt @@ -205,7 +205,7 @@ Specify name of the release. Specify the Debian suite you want to use for your live-system. If unset defaults to "testing". Supported values are: stable, testing, unstable (or their -corresponding release names like "wheezy"). Please be aware that recent Debian +corresponding release names like "jessie"). Please be aware that recent Debian suites might require a recent base.tgz (${GRML_FAI_CONFIG}/config/basefiles/$CLASSNAME.tar.gz) or a recent version of debootstrap. @@ -285,7 +285,7 @@ The main and base class provided by grml-live is named GRMLBASE. It's strongly recommended to **always** use the class GRMLBASE when building an ISO using grml-live, as well as the architecture dependent class which provides the kernel (being 'I386' for x86_32 and 'AMD64' for x86_64) and a GRML_* class (like -GRML_SMALL, GRML_MEDIUM or GRML_FULL). The following files and directories are +GRML_SMALL or GRML_FULL). The following files and directories are relevant for class GRMLBASE by default: ${GRML_FAI_CONFIG}/config/scripts/GRMLBASE/ @@ -329,17 +329,11 @@ this class as well, so unless you have a really good reason you should always use this class. * GRML_FULL: full featured Grml, also known as the "normal", full grml as -introduced in December 2011 (~350MB ISO size). +introduced in December 2011 (~460MB ISO size). -* GRML_MEDIUM: medium sized Grml version, used to be known as grml-medium -until December 2011 (~220MB ISO size). - -* GRML_SMALL: minimum sized Grml version, known as grml-small (~110MB ISO +* GRML_SMALL: minimum sized Grml version, known as grml-small (~230MB ISO size). -* GRML_XL: large size Grml version, used to be known as "full grml" until -December 2011 (~700MB ISO size). - * LATEX: LaTeX(-related) packages like auctex, texlive,... (which used to be shipped by grml before the LaTeX removal) @@ -497,9 +491,9 @@ The easiest way to get a running grml-live setup is to just use Grml. Of course using grml-live on a plain, original Debian installation is supported as well. So there we go. -What we have: plain, original Debian wheezy (7.x). +What we have: plain, original Debian jessie (8.x). -What we want: build a Grml ISO based on Debian/wheezy for the amd64 architecture +What we want: build a Grml ISO based on Debian/jessie for the amd64 architecture using grml-live. Instructions @@ -541,7 +535,7 @@ Instructions # CHROOT_INSTALL="/etc/grml/fai/chroot_install" ## adjust if necessary (defaults to /grml/grml-live): ## OUTPUT="/srv/grml-live" - FAI_DEBOOTSTRAP="wheezy http://http.debian.net/debian/" + FAI_DEBOOTSTRAP="jessie http://ftp.debian.org/debian/" # ARCH="amd64" CLASSES="GRMLBASE,GRML_FULL,AMD64" EOF @@ -654,7 +648,7 @@ How do I create a base.tgz? First of all create the chroot using debootstrap: BASECHROOT='/tmp/basefile' - debootstrap wheezy "$BASECHROOT" http://http.debian.net/debian + debootstrap jessie "$BASECHROOT" http://ftp.debian.org/debian tar -C "$BASECHROOT" --exclude='var/cache/apt/archives/*.deb' -zcf base.tar.gz ./ [TIP] @@ -687,7 +681,7 @@ FAI_DEBOOTSTRAP: [...] APT_PROXY="http://localhost:3142/" [...] - FAI_DEBOOTSTRAP="wheezy http://localhost:3142/http.debian.net/debian wheezy main contrib non-free" + FAI_DEBOOTSTRAP="jessie http://localhost:3142/ftp.debian.org/debian jessie main contrib non-free" 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. @@ -714,7 +708,7 @@ How do I create a base tar.gz (I386.tar.gz or AMD64.tar.gz) Execute the following commands (requires root): ARCH='amd64' # replace with i386 if necessary - SUITE='wheezy' # using the current stable release should always work + SUITE='jessie' # using the current stable release should always work debootstrap --arch "$ARCH" --exclude=info,tasksel,tasksel-data "$SUITE" "$ARCH" http://debian.netcologne.de/debian cd "$ARCH" rm var/cache/apt/archives/*.deb @@ -724,6 +718,30 @@ And finally place the generated tarball in /etc/grml/fai/config/basefiles/ (note that it needs to be uppercase letters matching the class names, so: AMD64.tar.gz for amd64 and I386.tar.gz for i386). +[[localrepos]] +How to use your own local repository +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Let's assume you have Debian package(s) in your filesystem inside +`/home/foobar/local-packages` and want to include that in your grml-live build. +Make sure to create an according sources.list configuration file, e.g. using +your own class name `CUSTOM`: + + # cat > /etc/grml/fai/config/files/etc/apt/sources.list.d/local-packages.list/CUSTOM << EOF + deb file:///home/foobar/local-packages ./ + EOF + +Add the according MIRROR_DIRECTORY configuration to your grml-live configuration: + + # echo "MIRROR_DIRECTORY='/home/foobar/packages'" >> /etc/grml/grml-live.local + +Make sure the local directory looks like a mirror: + + % cd /home/foobar/packages && /usr/bin/dpkg-scanpackages . /dev/null > ./Packages + +Finally invoke grml-live with your class name (`CUSTOM` in this example) added +to the list of classes (see grml-live option `-c`). + [[download]] Download / install grml-live as a Debian package ------------------------------------------------