Merge remote-tracking branch 'origin/github/pr/45'
[grml.org.git] / grml-live / setup.txt
1 Setup of grml-live build system
2 -------------------------------
3
4 The build system is a Debian/etch system (inside VMware) installed via grml-debootstrap.
5
6 Installation of software
7 ~~~~~~~~~~~~~~~~~~~~~~~~
8
9 Add grml and FAI repository to Debian package list:
10
11   cat >> /etc/apt/sources.list << EOF
12   deb http://deb.grml.org/ grml-stable  main
13   deb http://deb.grml.org/ grml-testing main
14
15   deb http://fai-project.org/download etch koeln
16   EOF
17
18 Pin down grml repository so only the packages manually chosen for installation
19 are taken from it:
20
21   cat >> /etc/apt/preferences << EOF
22   Package: *
23   Pin: origin deb.grml.org
24   Pin-Priority: 100
25   EOF
26
27 Install working squashfs-tools:
28
29   apt-get update
30   apt-get install squashfs-lzma-tools
31
32 [NOTE]
33 Depending on which grml version your are remastering make sure to use the right
34 squashfs tools, please make sure to check out
35 link:http://grml.org/grml-live/#current_state[http://grml.org/grml-live/#current_state]!
36
37 Install grml-live and additional software for comfortable console work:
38
39   apt-get install zsh grml-live mercurial gpm asciidoc
40
41   mkdir ~/bin && cd ~/bin
42   wget http://grml.org/scripts/grml-config.sh
43   chmod 775 grml-config.sh
44   cd && ~/bin/grml-config.sh
45
46 Configuration of custom ISO
47 ~~~~~~~~~~~~~~~~~~~~~~~~~~~
48
49 Copy grml-live templates:
50
51   cp -a /usr/share/grml-live/templates ~/
52
53 Now we can adjust configuration
54 link:isolinux.cfg[templates/boot/isolinux/isolinux.cfg] according to our needs
55 (like get "forensic" and "lang=de" bootoptions by default).
56
57 Prepare local configuration (adjust it according to your personal needs):
58
59   cat > /etc/grml/grml-live.local << EOF
60   # Main output directory
61   OUTPUT="/grml/grml-live"
62   #ZERO_LOGFILE='1'
63   #ZERO_FAI_LOGFILE='1'
64
65   #GRML_LIVE_SOURCES="
66   #deb http://192.168.1.112/debian     lenny         main contrib non-free
67   #deb http://deb.grml.org/            grml-stable  main
68   #deb http://deb.grml.org/            grml-testing main
69   #deb http://ftp.de.debian.org/debian lenny         main contrib non-free
70   #"
71
72   # FAI_DEBOOTSTRAP="lenny http://ftp.de.debian.org/debian"
73   EOF
74
75 Create FORENSIC grml-live/FAI class with package list:
76
77   cat >> /etc/grml/fai/config/package_config/FORENSIC << EOF
78   PACKAGES aptitude
79
80   afflib
81   autopsy
82   foremost
83   libewf
84   scalpel
85   sleuthkit
86   EOF
87
88 Create FORENSIC script for grml-live/FAI:
89
90   mkdir /etc/grml/fai/config/scripts/FORENSIC
91
92   cat > /etc/grml/fai/config/scripts/FORENSIC/01-create-forensic-dir << EOF
93   #!/bin/sh
94   # Filename:      /etc/grml/fai/config/scripts/FORENSIC/01-create-forensic-dir
95   # Purpose:       create directory "/forensic" in chroot
96   # Authors:       grml-team (grml.org), (c) Michael Prokop <mika@grml.org>
97   # Bug-Reports:   see http://grml.org/bugs/
98   # License:       This file is licensed under the GPL v2 or any later version.
99   # Latest change: Sat Mar 22 00:27:58 CET 2008
100   ################################################################################
101
102   set -e
103
104   [ -d "$target"/forensic ] || mkdir "$target"/forensic
105
106   ## END OF FILE #################################################################
107   # vim:ft=sh expandtab ai tw=80 tabstop=4 shiftwidth=3
108   EOF
109
110   chmod 775 /etc/grml/fai/config/scripts/FORENSIC/01-create-forensic-dir
111
112 Build ISO
113 ~~~~~~~~~
114
115 Execute grml-live as root to build ISO in /grml/grml-live/grml_isos:
116
117   grml-live -s lenny -a i386 -c GRMLBASE,GRML_MEDIUM,FORENSIC,I386 -t ~/templates -V