Update for 2014.03 release
[grml.org.git] / faq / index.html.tt2
1 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
2 <head>
3 <title>grml.org - FAQ</title>
4 <meta name="Title" content="grml.org - FAQ" />
5 <meta name="Author" content="the grml team [www.grml.org/team/]" />
6 <meta name="Keywords" content="grml.org, grml" />
7 <meta name="Description" content="FAQ of grml.org" />
8 <meta name="Abstract" content="grml, just another linux-distribution" />
9 <meta name="fdse-index-as" content="http://www.grml.org/faq/" />
10 <meta name="Robots" content="index,follow" />
11 <meta name="Language" content="english" />
12 <meta name="identifier-url" content="http://www.grml.org/" />
13 <meta name="MSSmartTagsPreventParsing" content="true" />
14 <meta http-equiv="imagetoolbar" content="no" />
15 <link rel="home" href="/" title="grml.org" />
16 <link rel="help" href="/features/" title="About" />
17 <link rel="author" href="/team/" title="Team" />
18 <link rel="icon" href="/favicon.png" type="image/png" />
19 <link rel="stylesheet" href="/style.css" type="text/css" />
20 </head>
21
22 <body>
23 [% INCLUDE static.inc %]
24
25       <div class="content">
26
27         <p><img style="float: right" src="/img/clanbomber.png" alt="*" /></p>
28
29         <h1 align="center">FAQ for grml</h1>
30
31         <p><strong>Up2date:</strong> applies to Grml version 2014.03</p>
32
33         <p><a name="toc"></a><strong>Index:</strong></p>
34
35         <p class="toc"><a href="#general">General:</a></p>
36         <ol>
37           <li><a href="#whatis">What is Grml?</a></li>
38           <li><a href="#flavours">What are grml32 / grml64 and grml96?</a></li>
39           <li><a href="#grmlsmall">What is the difference between grml-full and grml-small?</a></li>
40           <li><a href="#get">Where do I get Grml?</a></li>
41           <li><a href="#whatmeans">What does Grml mean?</a></li>
42           <li><a href="#releasename">What about the release name?</a></li>
43           <li><a href="#requirements">Requirements for running Grml</a></li>
44           <li><a href="#bootoptions">Which bootoptions does Grml support?</a></li>
45           <li><a href="#known_issues">Are there any known issues with this release? How about reporting bugs?</a></li>
46         </ol>
47
48         <p class="toc"><a href="#features">Features</a>:</p>
49         <ol>
50           <li><a href="#usbboot">How do I boot Grml from a USB stick?</a></li>
51           <li><a href="#persistency">Is it possible to store my settings?</a></li>
52           <li><a href="#password">What are the passwords of users on Grml?</a></li>
53           <li><a href="#version">How do I find out the version of Grml</a></li>
54           <li><a href="#language">How do I change the language/keyboard settings?</a></li>
55           <li><a href="#wms">Which window managers can I use?</a></li>
56           <li><a href="#lvm">Where are my LVM devices?</a></li>
57           <li><a href="#swraid">Where are my Software-RAID devices?</a></li>
58           <li><a href="#booting">Which ways exist to boot Grml?</a></li>
59           <li><a href="#timezone">How do I configure timezone on my Grml system?</a></li>
60           <li><a href="#hdinstall">Is it possible to install Grml to harddisk?</a></li>
61         </ol>
62
63         <p class="toc"><a href="#software">Software:</a></p>
64         <ol>
65           <li><a href="#sw_version">Which package(s) and which version is available?</a></li>
66           <li><a href="#zsh">Why is Zsh the default shell?</a></li>
67         </ol>
68         </ol>
69
70         <p class="toc"><a href="#stuff">Support / Unanswered stuff:</a></p>
71         <ol>
72           <li><a href="#questions">Further questions?</a></li>
73           <li><a href="#support">Commercial Support</a></li>
74         </ol>
75
76         <h2><a name="general"></a><a href="#toc">General</a></h2>
77
78         <h3><a name="whatis"></a><a href="#toc">What is Grml?</a></h3>
79
80         <p>Grml is a bootable live system (Live-CD) based
81         on <a href="http://www.debian.org/">Debian</a>. It is not
82         necessary to install anything to a harddisk. Grml includes a
83         collection of GNU/Linux software especially for system
84         administrators. It specializes on administrative tasks like
85         installation, deployment and system rescue.</p>
86
87         <h3><a name="flavours"></a><a href="#toc">What are grml32 / grml64 and grml96?</a></h3>
88
89         <ul>
90           <li>grml32-full: 32bit version (kernel and userspace), ~350MB</li>
91           <li>grml64-full: 64bit version (kernel and userspace), ~350MB</li>
92           <li>grml96-full: multi boot version (featuring the grml32-full and grml64-full ISOs combined on one ISO), ~700MB</li>
93         </ul>
94
95         <p>Unless you've a good reason to really choose the 32bit flavour we
96         strongly encourage you to use either the grml64 or the grml96
97         flavour.</p>
98
99         <p>Please notice that this schema was introduced starting with the
100         downsized Grml release 2011.12. Until then grml96 didn't exist and
101         grml32 was known as just 'grml'.</p>
102
103         <h3><a name="grmlsmall"></a><a href="#toc">What is the difference between grml-full and grml-small?</a></h3>
104
105         <p>grml-small provides a reduced set of available software compared to
106         grml-full.  It provides the same Linux kernel image as grml-full and is
107         fully binary compatible. Choose the grml-small flavour if size - for
108         whatever reason - really matters to you.</p>
109
110         <h3><a name="get"></a><a href="#toc">Where do I get Grml?</a></h3>
111
112         <p>Grml is open source, you can download it from the mirrors
113         listed at <a href="/download">grml.org/download/</a>.</p>
114
115         <h3><a name="whatmeans"></a><a href="#toc">What does Grml mean?</a></h3>
116
117         <p>Grml comes close to 'argl' or 'grrr' in English. People use
118         this when they want to express their dissatisfaction with
119         software (amongst other things).</p>
120
121         <h3><a name="releasename"></a><a href="#toc">What about the release name?</a></h3>
122
123         <p>Codename of Grml 2014.03 is "Ponywagon", which might be understood if a
124         carinthian talks about "Bahnübergang" (german for railroad crossing).</p>
125
126         <h3><a name="requirements"></a><a href="#toc">Requirements for running Grml</a></h3>
127
128         <ul>
129
130           <li>Intel-compatible CPU (i586 or later, preferably Pentium class or higher)</li>
131
132           <li>&gt;=256MB of RAM (&gt;=512MB recommended)</p>
133
134           <li>either a bootable CD-/DVD-ROM drive,
135           a <a href="#usbboot">USB-boot capable system</a> or a
136           network card for booting via network/PXE (check
137           out <a href="#terminalserver">grml-terminalserver</a>)</li>
138
139         </ul>
140
141         <h3><a name="accessibility"></a><a href="#toc">What does accessibility at Grml mean?</a></h3>
142
143         <p>The Grml kernel includes support for speakup. For software,
144         brltty and espeakup are included.</p>
145
146         <h3><a name="bootoptions"></a><a href="#toc">Which bootoptions does Grml support?</a></h3>
147
148         <p>Check out the <a
149         href="http://git.grml.org/?p=grml-live.git;a=blob_plain;f=templates/GRML/grml-cheatcodes.txt;hb=HEAD">grml-cheatcodes
150         file</a> (also available via <a href="http://grml.org/cheatcodes/">grml.org/cheatcodes/</a>). Of
151         course <a
152         href="http://www.kernel.org/doc/Documentation/kernel-parameters.txt">kernel-parameters.txt</a>
153         of the Linux kernel applies to Grml as well.</p>
154
155         <a name="release"></a> <!-- old anchor -->
156         <a name="bugreport"></a> <!-- old anchor -->
157         <h3><a name="known_issues"></a><a href="#toc">Are there any known issues? How about reporting bugs?</a></h3>
158
159         <p>Please visit the <a href="/bugs/">bug webpage</a>.</p>
160
161         <h2><a name="features"></a><a href="#toc">Features</a></h2>
162
163         <!-- TODO: needs to be improved! -->
164         <h3><a name="usbboot"></a><a href="#toc">How do I boot Grml from a USB stick?</a></h3>
165
166         <p>Check
167         out <a href="http://wiki.grml.org/doku.php?id=usb#grml2usb">grml2usb</a>
168         at the
169         <a href="http://wiki.grml.org/doku.php?id=usb">usb webpage in the
170         grml-wiki.</a></p>
171
172         <h3><a name="store"></a><a name="persistency"></a><a href="#toc">Is it possible to store my settings?</a></h3>
173
174         <p>Yes, using the
175         a <a href="http://wiki.grml.org/doku.php?id=persistency">persistency
176         feature</a>.</p>
177
178         <h3><a name="password"></a><a href="#toc">What are the passwords of users on Grml?</a></h3>
179
180         <p>There are no default passwords - all accounts are locked by
181         default for security reasons. Even local logins are not
182         possible (unless you set a password or create new user
183         accounts as root). You can create valid passwords using "sudo
184         passwd [username]" from the shell individually. To set a password
185         for users 'root' and 'grml' and enable SSH login you can use the 'ssh'
186         boot option, like 'ssh=yourpassword'.</p>
187
188         <h3><a name="version"></a><a href="#toc">How do I find out the version of Grml</a></h3>
189
190         <p>Run 'grml-version' or use the following command:</p>
191
192 <pre class="rahmen">
193 $ cat /etc/grml_version</pre>
194
195         <h3><a name="language"></a><a href="#toc">How do I change the language/keyboard settings?</a></h3>
196
197         <p>By default Grml uses english settings. But it is possible to
198         change the settings via using either the bootparam(s) lang,
199         keyboard and xkeyboard or via executing grml-lang when Grml is
200         already running. Usage examples:</p>
201
202 <pre class="rahmen">
203 grml lang=de      # enter this at the bootprompt and you will get
204                   # german keyboard layout and german $LANG, $LC_ALL,
205                   # $LANGUAGE...
206 grml keyboard=de xkeyboard=de lang=at # enter this at the bootprompt
207                   # and you will get german keyboard and austrian
208                   # language variables
209 % grml-lang de    # enter this in the shell to switch keyboard layout
210                   # and $LANG settings in a running Grml system
211 </pre>
212
213         <p>Note: run grml-setlang to get a dialog based frontend for
214         /etc/default/locale. Run grml-setkeyboard to get a dialog
215         based frontend for /etc/sysconfig/keyboard.</p>
216
217
218         <h3><a name="wms"></a><a href="#toc">Which window managers can I use?</a></h3>
219
220         <p>Starting with the 2011.12 release Grml provides <a
221         href="http://www.fluxbox.org/">Fluxbox</a> as window manager.</p>
222
223         <h3><a name="lvm"></a><a href="#toc">Where are my LVM devices?</a></h3>
224
225         <p>LVM (Logival Volumes) is <strong>not</strong> started by default to
226         avoid any possible damage to your data. To get access to present LVM
227         devices just execute:</p>
228
229 <pre class="rahmen">
230 # /etc/init.d/lvm2 start
231 </pre>
232
233         <p>If you want to enable LVM by default just boot using the 'lvm'
234         bootoption which automatically enables LVM.</p>
235
236         <h3><a name="swraid"></a><a href="#toc">Where are my Software-RAID devices?</a></h3>
237
238         <p>Software-RAID (usually known as the mdadm stuff) is
239         <strong>not</strong> started by default to avoid any possible damage to
240         your data. To get access to present SW-RAID devices just execute:</p>
241
242 <pre class="rahmen">
243 # /etc/init.d/mdadm-raid start
244 </pre>
245
246         <p>If you want to enable SW-RAID by default just boot using
247         the 'swraid' bootoption which enables automatic assembling of
248         software raid arrays.</p>
249
250         <a name="terminalserver"></a>
251         <h3><a name="booting"></a><a href="#toc">Which ways exist to boot Grml?</a></h3>
252
253         <!-- TODO: needs rework -->
254
255         <p>Of course running from CD/DVD is a common way to boot
256         Grml. But Grml provides many more ways to boot:</p>
257
258         <p>It is possible to boot Grml via USB (e.g. USB stick or
259         harddisk), firewire, or running from a Compact Flash disk. It
260         works out of the box; you don't need to modify anything. Check
261         out <a href="http://wiki.grml.org/doku.php?id=usb">the usb
262         webpage in the grml-wiki</a> for more details.</p>
263
264         <p>Your computer can not boot from CD-ROM but provides a
265         floppy disk? Take a look
266         at <a href="http://btmgr.sourceforge.net/">btmgr</a>, <a href="http://ubcd4win.com/faq.htm#floppy">ubcd4win</a>
267         or <a href="http://linux.simple.be/tools/sbm">sbm</a>. They
268         provide support for booting from CD-ROM via a special floppy
269         disk.</p>
270
271         <p>grml-terminalserver makes it possible to boot your system
272         via network
273         using <a href="http://en.wikipedia.org/wiki/Preboot_Execution_Environment">PXE</a>
274         (Preboot Execution Environment). If your network card does not
275         provide support for booting via PXE you can still boot it
276         either using the provided grub image by grml-terminalserver
277         (for example via floppy drive) or
278         using <a href="http://etherboot.org/wiki/index.php">gPXE</a>.
279         For more information, refer to
280         the <a href="/terminalserver/">grml-terminalserver
281         webpage</a>.</p>
282
283         <h3><a name="timezone"></a><a href="#toc">How do I configure
284         timezone on my Grml system?</a></h3>
285
286         <p>Available bootoptions relevant in live-cd mode:</p>
287
288         <ul>
289           <li>utc: set UTC, if your system clock is set to UTC (GMT)
290           <li>gmt: set UTC, if your system clock is set to UTC (GMT) [like bootoption utc]
291           <li>tz=$option: set timezone to corresponding $option, usage example:
292               tz=Europe/Vienna
293         </ul>
294
295         <p>Further information: manpages hwclock(8), tzselect(1) and tzconfig(8); <a
296         href="http://www.debian.org/doc/manuals/system-administrator/ch-sysadmin-time.html">Debian
297         GNU/Linux System Administrator's Manual Chapter 16 - Time</a> and <a
298         href="http://wiki.debian.org/TimeZoneChanges">TimeZoneChanges in the
299         Debian-Wiki</a>.</p>
300
301         <h3><a name="hdinstall"></a><a href="#toc">Is it possible to install Grml to harddisk?</a></h3>
302
303         <p>Short anwer: No.</p>
304
305         <p>If you want to get a plain Debian system take a look at <a
306         href="/grml-debootstrap/">grml-debootstrap</a>.</p>
307
308         <p>Long(er) answer: yes it's possible to install Grml. But it's not
309         supported and you'll be on your own. That's why we decided to make it
310         not-so-obvious. If you really know what you're doing you'll find out on
311         your own. Reminder: use <a
312         href="/grml-debootstrap/">grml-debootstrap</a> or <a
313         href="http://www.debian.org/">Debian Installer</a> instead.</p>
314
315         <h2><a name="software"></a><a href="#toc">Software</a></h2>
316
317         <h3><a name="sw_version"></a><a href="#toc">Which package(s) and which
318         version is available?</a></h3>
319
320         <p>If you want to get details about the provided packages and the
321         package versions without booting the Grml ISO check out the dpkg_...
322         files in the <a href="/files/#debian">Debian-Information section on
323         grml.org/files/</a>.</p>
324
325         <h3><a name="zsh"></a><a href="#toc">Why is Zsh the default shell?</a></h3>
326
327         <p>Short answer: because <a href="/zsh/">Zsh rocks</a>, really!</p>
328
329         <p>Long(er) answer: If you don't know Zsh take a look the <a
330         href="/zsh/">Grml Zsh reference card</a>.</p>
331
332         <p>If you are a Bash user and don't know Zsh yet, don't be
333         afraid. Bash is largely a subset of Zsh and you don't have to
334         throw away your knowledge about shell stuff.</p>
335
336         <h2><a name="stuff"></a><a href="#toc">Support / Unanswered stuff</a></h2>
337
338         <h3><a name="questions"></a><a href="#toc">Further questions</a></h3>
339
340         <p>Do you have a question which is not answered in the FAQ or
341         in the provided <a href="/docs/">documentation</a> (execute
342         &quot;grml-info&quot; on your Grml system for offline
343         documentation)?  Also check out 'grml-tips $KEYWORD' on your
344         Grml system. Take a look at
345         <a href="/">the Grml website</a> and <a href="http://wiki.grml.org/">the
346           grml-wiki</a>. A good place to become part of the community is the <a
347           href="/mailinglist/">Grml mailinglist</a>.</p>
348
349         <h3><a name="support"></a><a href="#toc">Commercial Support</a></h3>
350
351         <p>You want to deploy Grml in your data center, use it as part of your
352         business or have an emergency case? You're happy with Grml but would
353         like to get your very own live cd (providing your favourite software
354         selection, special configuration, setup and your bootsplash)?
355         Please get in <a href="/contact/">touch with us</a>.</p>
356
357       </div>
358
359 [% INCLUDE static_bottom.inc %]