0815ce75c9064aec8216bb081b16e2eac6b99444
[grml.org.git] / grml2hd / index.php
1 <!DOCTYPE html>
2 <html>
3 <head>
4 <title>grml.org - grml2hd</title>
5 <meta name="Title" content="grml.org - grml2hd" />
6 <meta name="Author" content="the grml team [www.grml.org/team/]" />
7 <meta name="Keywords" content="grml.org, grml" />
8 <meta name="Description" content="grml2hd of grml.org" />
9 <meta name="Abstract" content="grml, just another linux-distribution" />
10 <meta name="fdse-index-as" content="http://www.grml.org/kernel/" />
11 <meta name="Robots" content="index,follow" />
12 <meta name="Language" content="english" />
13 <meta name="identifier-url" content="http://www.grml.org/" />
14 <meta name="MSSmartTagsPreventParsing" content="true" />
15 <meta http-equiv="imagetoolbar" content="no" />
16 <link rel="home" href="/" title="grml.org" />
17 <link rel="help" href="/features/" title="About" />
18 <link rel="author" href="/team/" title="Team" />
19 <link rel="icon" href="/favicon.png" type="image/png" />
20 <link rel="stylesheet" href="/style.css" type="text/css" />
21 </head>
22
23 <body>
24 <?php include '../static.inc'; ?>
25
26       <div class="content">
27
28         <p><img style="float: right" src="/img/clanbomber.png" alt="*" /></p>
29
30         <h1>grml2hd</h1>
31
32         <p>Index:</p>
33
34         <ul>
35           <li><a href="#preface">Preface</a></li>
36           <li><a href="#screenshots">Screenshots</a></li>
37           <li><a href="#faq">Frequently Asked Questions</a></li>
38           <li><a href="#known_issues">Known Issues</a></li>
39         </ul>
40
41         <h2><a name="preface"></a>Preface</h2>
42
43         <p>grml2hd is the installer for <strong>installing the running grml
44         system</strong> to a harddisk.</p>
45
46         <p><strong>Important!</strong> The Grml team does not take responsibility for
47         loss of any data!</p>
48
49         <p>grml2hd supports filesystems ext2/ext3/ext4, JFS, XFS and reiserfs. You
50         should have a partition with at least 2.7 GB free space to use Grml. You
51         can choose the one you would like to use when running grml2hd.  You are
52         prompted for the root-password, the username and some more
53         easy-to-answer-questions and that's it! Take a look at the <a
54         href="#screenshots">screenshots</a> to get an idea.  Depending of your
55         hardware you can get a working linux box within 5 to 30 minutes.</p>
56
57         <p><strong>Notice:</strong> If you are using Grml in a productive environment
58         and/or use a grml2hd installation we strongly recommend to subscribe to <a
59         href="/mailinglist/">the grml user mailinglist</a>! Notice that Grml is based
60         on Debian unstable, so you really should be familiar with Debian unstable if you
61         plan to use grml as a harddisk system.</p>
62
63         <p>Make sure you are using the latest version of grml2hd. Just run 'apt-get
64         update ; apt-get install grml2hd' if you have network access.</p>
65
66         <p>Please make sure that your grml-ISO is ok. Otherwise installation
67         will not be possible and might hang at a specific point. Verify the
68         ISO via booting with 'grml testcd'. Check your CD low-level running
69
70 <pre class="rahmen">
71 # readcd -c2scan dev=/dev/cdrom</pre>
72
73         <p>If you are running a grml2hd installation we strongly recommend to
74         subscribe to the <a href="http://grml.org/mailinglist/">grml-user
75         mailinglist</a>!</p>
76
77         <p>For more information take a look at <a href="grml2hd.html">the grml2hd
78         manpage</a>.</p>
79
80         <h2><a name="screenshots"></a>Screenshots of installation</h2>
81
82         <p>An image gallery providing <strong>screenshots for all the
83         steps</strong> of grml2hd is <a href="gallery/">available
84         online. Just take the tour!</a></p>
85
86 <!--
87         <p><a href="/grml2hd/img/big/screeni1.png"><img style="border: 0" src="/grml2hd/img/small/screeni1.png" alt="*" /></a></p>
88         <p>Let's install grml to partition /dev/hda5 and write lilo to MBR of /dev/hda.</p>
89
90         <p><a href="/grml2hd/img/big/screeni2.png"><img style="border: 0" src="/grml2hd/img/small/screeni2.png" alt="*" /></a></p>
91         <p>The welcome screen.</p>
92
93         <p><a href="/grml2hd/img/big/screeni3.png"><img style="border: 0" src="/grml2hd/img/small/screeni3.png" alt="*" /></a></p>
94         <p>Choose the filesystem you want to use.</p>
95
96         <p><a href="/grml2hd/img/big/screeni4.png"><img style="border: 0" src="/grml2hd/img/small/screeni4.png" alt="*" /></a></p>
97         <p>Are you sure you want to install it to harddisk?</p>
98
99         <p><a href="/grml2hd/img/big/screeni5.png"><img style="border: 0" src="/grml2hd/img/small/screeni5.png" alt="*" /></a></p>
100         <p>Copying files to harddisk...</p>
101
102         <p><a href="/grml2hd/img/big/screeni6.png"><img style="border: 0" src="/grml2hd/img/small/screeni6.png" alt="*" /></a></p>
103         <p>... and still copying...</p>
104
105         <p><a href="/grml2hd/img/big/screeni7.png"><img style="border: 0" src="/grml2hd/img/small/screeni7.png" alt="*" /></a></p>
106         <p>Copying was successful!</p>
107
108         <p><a href="/grml2hd/img/big/screeni8.png"><img style="border: 0" src="/grml2hd/img/small/screeni8.png" alt="*" /></a></p>
109         <p>Enter password for user root.</p>
110
111         <p><a href="/grml2hd/img/big/screeni9.png"><img style="border: 0" src="/grml2hd/img/small/screeni9.png" alt="*" /></a></p>
112         <p>Choose an username.</p>
113
114         <p><a href="/grml2hd/img/big/screeni10.png"><img style="border: 0" src="/grml2hd/img/small/screeni10.png" alt="*" /></a></p>
115         <p>Enter realname.</p>
116
117         <p><a href="/grml2hd/img/big/screeni11.png"><img style="border: 0" src="/grml2hd/img/small/screeni11.png" alt="*" /></a></p>
118         <p>Enter password for selected user.</p>
119
120         <p><a href="/grml2hd/img/big/screeni12.png"><img style="border: 0" src="/grml2hd/img/small/screeni12.png" alt="*" /></a></p>
121         <p>Running lilo was successful too.</p>
122
123         <p><a href="/grml2hd/img/big/screeni13.png"><img style="border: 0" src="/grml2hd/img/small/screeni13.png" alt="*" /></a></p>
124         <p>Done!</p>
125
126         <p><a href="/grml2hd/img/big/screeni14.png"><img style="border: 0" src="/grml2hd/img/small/screeni14.png" alt="*" /></a></p>
127         <p>It took only 7 minutes and 12 seconds to install grml Linux to harddisk!
128         (And including taking some screenshots ;-))</p>
129 -->
130
131         <h2><a name="faq"></a>Frequently Asked Questions (FAQ)</h2>
132
133         <h3><a name="automatic"></a>How do I use the automatic installation?</h3>
134
135         <p>You can install grml without any manual interaction. Either configure
136         /etc/grml2hd/config and run 'GRML2HD_NONINTERACTIVE=1 grml2hd' afterwards or
137         take a look at the boot parameter 'grml2hd' (take a look at the bootsplash
138         F9). If you want to install it via network take a look at the grml2hd
139         configuration dialog within <a
140         href="/terminalserver/">grml-terminalserver</a>.</p>
141
142         <h3><a name="update"></a>How about installing software and updates?</h3>
143
144         <p>If you install grml to harddisk you have a Debian unstable with some
145         special packages. You can install any software you like from the pools which
146         are defined in /etc/apt/sources.list and of course you can keep your system
147         up to date via running 'apt-get update; apt-get upgrade'. So if you are
148         missing some software just install it as you are used from your 'normal'
149         Debian system. Of course you also get all updates of grml-packages (unless
150         you remove the grml.org-line in your sources.list).  If you encounter any
151         problems when running 'apt-get update' just compare /etc/apt/sources.list
152         with /etc/apt/sources.list.grml. /etc/apt/sources.list.grml is a repository
153         list provided by package grml-etc which provides current package lists. If
154         you want to use the grml-list just symlink it: 'ln -sf
155         /etc/apt/sources.list.grml /etc/apt/sources.list'.</p>
156
157         <h3><a name="binary"></a>What about binary compatibility between grml and Debian?</h3>
158
159         <p>As grml is based on Debian you have full binary compatibility between grml
160         and Debian (sid/unstable).</p>
161
162         <h2><a name="known_issues"></a>Known Issues</h2>
163
164         <h3><a name="lilo"></a>I can't boot my grml system because Lilo says LI L99 99 99...</h3>
165
166         <p>You probably did not install lilo to master boot record (MBR) boot chose
167         'install lilo into partition' in the grml2hd dialog. So now you don't have a
168         bootmanager in your MBR.  Solution: Install lilo to MBR. Example:</p>
169
170 <pre class="rahmen">
171 sudo mount -o rw,dev,suid /mnt/hda1 # mount harddisk
172 sudo chroot /mnt/hda1 # chroot into the grml-system
173 vim -X /etc/lilo.conf # adjust the line containing the bootoption to 'boot=/dev/hda'
174 lilo  # now run lilo again, leave chroot environment (exit) and reboot your system afterwards</pre>
175
176         <h3><a name="xfs"></a>I installed grml on a XFS filesystem and grml does not boot anymore</h3>
177
178         <p>XFS and lilo don't work together when lilo is installed in the boot sector
179         of the harddisk because the XFS superblock goes where lilo would be
180         installed.  You have to install lilo in the master boot record of your
181         harddisk to solve this problem.</p>
182
183         <p>If you read this after installing grml to your harddisk you should
184         use the grml live-cd and fix /etc/lilo.conf manually and rerun lilo
185         (see above).</p>
186
187 <!--
188         <h3><a name="scsi"></a>I installed grml to an SCSI device and now I can not boot it anymore</h3>
189
190         <p>To access an SCSI device you probably need a specific kernel module. As
191         grml uses an initial ramdisk providing hardware recognition when running from
192         CD, the SCSI devices can be accessed when running from CD. grml2hd installs
193         the running grml system to harddisk without the initial ramdisk.  Therefore
194         booting such a (non-CD-)system might not work anymore. To fix this issue
195         please install a kernel with SCSI-device support in the chroot after running
196         grml2hd:</p>
197
198 <pre class="rahmen">
199 sudo mount -o rw,dev,suid /mnt/hda1 # mount harddisk where grml is installed
200 sudo chroot /mnt/hda1               # chroot into the grml-system
201 apt-cache search linux-image        # search for an appropriate kernel
202 apt-get install linux-image....     # instal the kernel image (for example: linux-headers-2.6.13-1-686)
203 vim -X /etc/lilo.conf               # adjust lilo for use with initrd
204 lilo  # now run lilo again, leave chroot environment (exit) and reboot your system afterwards</pre>
205
206         <p>Please notice: devfs is deactivated starting with kernel 2.6.13, so there
207         might be issues left with initrd-tools/mkinitrd and kernel &gt;=2.6.13 (see
208         <a href="http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=315654">bug
209         #315654</a>). An alternative for initrd-tools is 'initramfs-tools' which is
210         available in Debian unstable and grml. It supports booting without devfs.
211         Take a look at mkinitrd.yaird and mkinitramfs to create an initramfs
212         yourself.</p>
213 -->
214
215       </div>
216
217 <?php include '../static_bottom.inc'; ?>