Misc changes for 2017.05-rc1 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 2017.05</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="#systemd">Why is Grml using systemd?</a></li>
46           <li><a href="#known_issues">Are there any known issues with this release? How about reporting bugs?</a></li>
47         </ol>
48
49         <p class="toc"><a href="#features">Features</a>:</p>
50         <ol>
51           <li><a href="#usbboot">How do I boot Grml from a USB stick?</a></li>
52           <li><a href="#persistency">Is it possible to store my settings?</a></li>
53           <li><a href="#password">What are the passwords of users on Grml?</a></li>
54           <li><a href="#version">How do I find out the version of Grml</a></li>
55           <li><a href="#language">How do I change the language/keyboard settings?</a></li>
56           <li><a href="#wms">Which window managers can I use?</a></li>
57           <li><a href="#lvm">Where are my LVM devices?</a></li>
58           <li><a href="#swraid">Where are my Software-RAID devices?</a></li>
59           <li><a href="#booting">Which ways exist to boot Grml?</a></li>
60           <li><a href="#timezone">How do I configure timezone on my Grml system?</a></li>
61           <li><a href="#hdinstall">Is it possible to install Grml to harddisk?</a></li>
62         </ol>
63
64         <p class="toc"><a href="#software">Software:</a></p>
65         <ol>
66           <li><a href="#sw_version">Which package(s) and which version is available?</a></li>
67           <li><a href="#zsh">Why is Zsh the default shell?</a></li>
68         </ol>
69         </ol>
70
71         <p class="toc"><a href="#stuff">Support / Unanswered stuff:</a></p>
72         <ol>
73           <li><a href="#questions">Further questions?</a></li>
74           <li><a href="#support">Commercial Support</a></li>
75         </ol>
76
77         <h2><a name="general"></a><a href="#toc">General</a></h2>
78
79         <h3><a name="whatis"></a><a href="#toc">What is Grml?</a></h3>
80
81         <p>Grml is a bootable live system (Live-CD) based
82         on <a href="http://www.debian.org/">Debian</a>. It is not
83         necessary to install anything to a harddisk. Grml includes a
84         collection of GNU/Linux software especially for system
85         administrators. It specializes on administrative tasks like
86         installation, deployment and system rescue.</p>
87
88         <h3><a name="flavours"></a><a href="#toc">What are grml32 / grml64 and grml96?</a></h3>
89
90         <ul>
91           <li>grml32-full: 32bit version (kernel and userspace), ~350MB</li>
92           <li>grml64-full: 64bit version (kernel and userspace), ~350MB</li>
93           <li>grml96-full: multi boot version (featuring the grml32-full and grml64-full ISOs combined on one ISO), ~700MB</li>
94         </ul>
95
96         <p>Unless you've a good reason to really choose the 32bit flavour we
97         strongly encourage you to use either the grml64 or the grml96
98         flavour.</p>
99
100         <p>Please notice that this schema was introduced starting with the
101         downsized Grml release 2011.12. Until then grml96 didn't exist and
102         grml32 was known as just 'grml'.</p>
103
104         <h3><a name="grmlsmall"></a><a href="#toc">What is the difference between grml-full and grml-small?</a></h3>
105
106         <p>grml-small provides a reduced set of available software compared to
107         grml-full.  It provides the same Linux kernel image as grml-full and is
108         fully binary compatible. Choose the grml-small flavour if size - for
109         whatever reason - really matters to you.</p>
110
111         <h3><a name="get"></a><a href="#toc">Where do I get Grml?</a></h3>
112
113         <p>Grml is open source, you can download it from the mirrors
114         listed at <a href="/download">grml.org/download/</a>.</p>
115
116         <h3><a name="whatmeans"></a><a href="#toc">What does Grml mean?</a></h3>
117
118         <p>Grml comes close to 'argl' or 'grrr' in English. People use
119         this when they want to express their dissatisfaction with
120         software (amongst other things).</p>
121
122         <h3><a name="releasename"></a><a href="#toc">What about the release name?</a></h3>
123
124         <p>Codename of Grml 2017.05 is "Freedatensuppe", which is
125         a wordplay (free data soup) on an austrian dish called <a href="https://de.wikipedia.org/wiki/Frittatensuppe">Frittatensuppe</a>.
126         (We stumbled upon this wordplay through <a href="https://twitter.com/shroombab/status/715650750689517568">a tweet from Barbara Wimmer</a>,
127         referencing a flyer based on a <a href="https://zwerkstatt.at/index.php/produkt/freedaten_h_indiaink/">shirt by zwerkstatt</a>.</p>
128
129         <h3><a name="requirements"></a><a href="#toc">Requirements for running Grml</a></h3>
130
131         <ul>
132
133           <li>Intel-compatible CPU (i586 or later, preferably Pentium class or higher)</li>
134
135           <li>&gt;=256MB of RAM (&gt;=512MB recommended)</p>
136
137           <li>either a bootable CD-/DVD-ROM drive,
138           a <a href="#usbboot">USB-boot capable system</a> or a
139           network card for booting via network/PXE (check
140           out <a href="#terminalserver">grml-terminalserver</a>)</li>
141
142         </ul>
143
144         <h3><a name="accessibility"></a><a href="#toc">What does accessibility at Grml mean?</a></h3>
145
146         <p>The Grml kernel includes support for speakup. For software,
147         brltty and espeakup are included.</p>
148
149         <h3><a name="bootoptions"></a><a href="#toc">Which bootoptions does Grml support?</a></h3>
150
151         <p>Check out the <a
152         href="http://git.grml.org/?p=grml-live.git;a=blob_plain;f=templates/GRML/grml-cheatcodes.txt;hb=HEAD">grml-cheatcodes
153         file</a> (also available via <a href="http://grml.org/cheatcodes/">grml.org/cheatcodes/</a>). Of
154         course <a
155         href="http://www.kernel.org/doc/Documentation/kernel-parameters.txt">kernel-parameters.txt</a>
156         of the Linux kernel applies to Grml as well.</p>
157
158         <h3><a name="systemd"></a><a href="#toc">Why is Grml using systemd?</a></h3>
159
160         <p>The switch from file-rc to systemd happened for various reasons.
161         Grml used file-rc for many years, mainly because it provided a better
162         way to control startup behavior via its /etc/runlevel.conf configuration
163         than with using sysvinit. Though for us Grml developers this also meant
164         that whenever there have been any changes in Debian's startup
165         configuration we had to compare our /etc/runlevel.conf setup with what a
166         normal Debian system would give us. Users who wanted to remaster Grml
167         with a custom startup procedure as well had to practically fork
168         maintenance of the /etc/runlevel.conf file. This didn't only mean
169         tracking new features/services, but also solve any possible issues
170         around it - duplicating efforts and wasting developers time
171         unnecessarily. Lately we also started to see problems that no one else
172         seemed to have (or care about enough), for example with multiple network
173         cards we ran into race-conditions with resolvconf. Problems like that
174         turned out to be release stoppers for us.</p>
175
176         <p>systemd on the other hand provides great documentation, service
177         supervision, takes care of parallel service startup and is the default
178         init system on most Linux distributions nowadays. This means more users,
179         better testing and integration. Logging, startup time investigation (to
180         get a fast boot procedure) and identifying failed service startups with
181         sysvinit/file-rc was always hard, unreliable or even impossible under
182         certain conditions. bootlogd was unreliable (while `journalctl -b` is
183         available out-of-the-box with systemd), bootchart not nicely integrated
184         (while systemd-analyze blame/critical-chain works out-of-the-box) and we
185         aren't aware of any equivalence for e.g. `systemctl --failed`.</p>
186
187         <p>While migrating our stack to systemd is <em>not</em> fully finished
188         yet, its switch - at least so far - was easier than expected. It also
189         turns out that it gives users who want to remaster Grml (or build their
190         very own ISOs from scratch using grml-live) more flexibility and control
191         over the startup process. systemd's override.conf mechanism and preset
192         feature provides the flexibility to overwrite unwanted behavior, without
193         losing the option to use existing defaults.</p>
194
195         <p>Last but not least we think it's good that systemd is actively
196         maintained and receives attention. The sysvinit/file-rc ecosystem was
197         stagnating/non-existend for too many years. Grml used its own initrd
198         implementation in its very beginnings, until a more broadly available
199         initramfs-tools/ live-boot solution appeared, broadening the user base,
200         sharing goals amongst different (live) distributions. Back in the days
201         Grml - like many other live distributions - had to implement hardware
202         recognition on its own.  While udev received lots of complaints back
203         then, its integration actually solved all the hardware recognition for
204         the good. systemd's vision of stateless systems is something which helps
205         building live systems like Grml.</p>
206
207         <p>While we don't claim that systemd is perfect and doesn't have its
208         issues and drawbacks (like any software), we're happy about its
209         existence and more than happy about development and support by Debian's
210         systemd folks.</p>
211
212         <a name="release"></a> <!-- old anchor -->
213         <a name="bugreport"></a> <!-- old anchor -->
214         <h3><a name="known_issues"></a><a href="#toc">Are there any known issues? How about reporting bugs?</a></h3>
215
216         <p>Please visit the <a href="/bugs/">bug webpage</a>.</p>
217
218         <h2><a name="features"></a><a href="#toc">Features</a></h2>
219
220         <!-- TODO: needs to be improved! -->
221         <h3><a name="usbboot"></a><a href="#toc">How do I boot Grml from a USB stick?</a></h3>
222
223         <p>Check
224         out <a href="http://wiki.grml.org/doku.php?id=usb#grml2usb">grml2usb</a>
225         at the
226         <a href="http://wiki.grml.org/doku.php?id=usb">usb webpage in the
227         grml-wiki.</a></p>
228
229         <h3><a name="store"></a><a name="persistency"></a><a href="#toc">Is it possible to store my settings?</a></h3>
230
231         <p>Yes, using the
232         a <a href="http://wiki.grml.org/doku.php?id=persistency">persistency
233         feature</a>.</p>
234
235         <h3><a name="password"></a><a href="#toc">What are the passwords of users on Grml?</a></h3>
236
237         <p>There are no default passwords - all accounts are locked by
238         default for security reasons. Even local logins are not
239         possible (unless you set a password or create new user
240         accounts as root). You can create valid passwords using "sudo
241         passwd [username]" from the shell individually. To set a password
242         for users 'root' and 'grml' and enable SSH login you can use the 'ssh'
243         boot option, like 'ssh=yourpassword'.</p>
244
245         <h3><a name="version"></a><a href="#toc">How do I find out the version of Grml</a></h3>
246
247         <p>Run 'grml-version' or use the following command:</p>
248
249 <pre class="rahmen">
250 $ cat /etc/grml_version</pre>
251
252         <h3><a name="language"></a><a href="#toc">How do I change the language/keyboard settings?</a></h3>
253
254         <p>By default Grml uses english settings. But it is possible to
255         change the settings via using either the bootparam(s) lang,
256         keyboard and xkeyboard or via executing grml-lang when Grml is
257         already running. Usage examples:</p>
258
259 <pre class="rahmen">
260 grml lang=de      # enter this at the bootprompt and you will get
261                   # german keyboard layout and german $LANG, $LC_ALL,
262                   # $LANGUAGE...
263 grml keyboard=de xkeyboard=de lang=at # enter this at the bootprompt
264                   # and you will get german keyboard and austrian
265                   # language variables
266 % grml-lang de    # enter this in the shell to switch keyboard layout
267                   # and $LANG settings in a running Grml system
268 </pre>
269
270         <p>Note: run grml-setlang to get a dialog based frontend for
271         /etc/default/locale. Run grml-setkeyboard to get a dialog
272         based frontend for /etc/sysconfig/keyboard.</p>
273
274
275         <h3><a name="wms"></a><a href="#toc">Which window managers can I use?</a></h3>
276
277         <p>Starting with the 2011.12 release Grml provides <a
278         href="http://www.fluxbox.org/">Fluxbox</a> as window manager.</p>
279
280         <h3><a name="lvm"></a><a href="#toc">Where are my LVM devices?</a></h3>
281
282         <p>LVM (Logival Volumes) is <strong>not</strong> started by default to
283         avoid any possible damage to your data. To get access to present LVM
284         devices just execute:</p>
285
286 <pre class="rahmen">
287 # /etc/init.d/lvm2 start
288 </pre>
289
290         <p>If you want to enable LVM by default just boot using the 'lvm'
291         bootoption which automatically enables LVM.</p>
292
293         <h3><a name="swraid"></a><a href="#toc">Where are my Software-RAID devices?</a></h3>
294
295         <p>Software-RAID (usually known as the mdadm stuff) is
296         <strong>not</strong> started by default to avoid any possible damage to
297         your data. To get access to present SW-RAID devices just execute:</p>
298
299 <pre class="rahmen">
300 # /etc/init.d/mdadm-raid start
301 </pre>
302
303         <p>If you want to enable SW-RAID by default just boot using
304         the 'swraid' bootoption which enables automatic assembling of
305         software raid arrays.</p>
306
307         <a name="terminalserver"></a>
308         <h3><a name="booting"></a><a href="#toc">Which ways exist to boot Grml?</a></h3>
309
310         <!-- TODO: needs rework -->
311
312         <p>Of course running from CD/DVD is a common way to boot
313         Grml. But Grml provides many more ways to boot:</p>
314
315         <p>It is possible to boot Grml via USB (e.g. USB stick or
316         harddisk), firewire, or running from a Compact Flash disk. It
317         works out of the box; you don't need to modify anything. Check
318         out <a href="http://wiki.grml.org/doku.php?id=usb">the usb
319         webpage in the grml-wiki</a> for more details.</p>
320
321         <p>Your computer can not boot from CD-ROM but provides a
322         floppy disk? Take a look
323         at <a href="http://btmgr.sourceforge.net/">btmgr</a>, <a href="http://ubcd4win.com/faq.htm#floppy">ubcd4win</a>
324         or <a href="http://linux.simple.be/tools/sbm">sbm</a>. They
325         provide support for booting from CD-ROM via a special floppy
326         disk.</p>
327
328         <p>grml-terminalserver makes it possible to boot your system
329         via network
330         using <a href="http://en.wikipedia.org/wiki/Preboot_Execution_Environment">PXE</a>
331         (Preboot Execution Environment). If your network card does not
332         provide support for booting via PXE you can still boot it
333         either using the provided grub image by grml-terminalserver
334         (for example via floppy drive) or
335         using <a href="http://etherboot.org/wiki/index.php">gPXE</a>.
336         For more information, refer to
337         the <a href="/terminalserver/">grml-terminalserver
338         webpage</a>.</p>
339
340         <h3><a name="timezone"></a><a href="#toc">How do I configure
341         timezone on my Grml system?</a></h3>
342
343         <p>Available bootoptions relevant in live-cd mode:</p>
344
345         <ul>
346           <li>utc: set UTC, if your system clock is set to UTC (GMT)
347           <li>gmt: set UTC, if your system clock is set to UTC (GMT) [like bootoption utc]
348           <li>tz=$option: set timezone to corresponding $option, usage example:
349               tz=Europe/Vienna
350         </ul>
351
352         <p>Further information: manpages hwclock(8), tzselect(1) and tzconfig(8); <a
353         href="http://www.debian.org/doc/manuals/system-administrator/ch-sysadmin-time.html">Debian
354         GNU/Linux System Administrator's Manual Chapter 16 - Time</a> and <a
355         href="http://wiki.debian.org/TimeZoneChanges">TimeZoneChanges in the
356         Debian-Wiki</a>.</p>
357
358         <h3><a name="hdinstall"></a><a href="#toc">Is it possible to install Grml to harddisk?</a></h3>
359
360         <p>Short anwer: No.</p>
361
362         <p>If you want to get a plain Debian system take a look at <a
363         href="/grml-debootstrap/">grml-debootstrap</a>.</p>
364
365         <p>Long(er) answer: yes it's possible to install Grml. But it's not
366         supported and you'll be on your own. That's why we decided to make it
367         not-so-obvious. If you really know what you're doing you'll find out on
368         your own. Reminder: use <a
369         href="/grml-debootstrap/">grml-debootstrap</a> or <a
370         href="http://www.debian.org/">Debian Installer</a> instead.</p>
371
372         <h2><a name="software"></a><a href="#toc">Software</a></h2>
373
374         <h3><a name="sw_version"></a><a href="#toc">Which package(s) and which
375         version is available?</a></h3>
376
377         <p>If you want to get details about the provided packages and the
378         package versions without booting the Grml ISO check out the dpkg_...
379         files in the <a href="/files/#debian">Debian-Information section on
380         grml.org/files/</a>.</p>
381
382         <h3><a name="zsh"></a><a href="#toc">Why is Zsh the default shell?</a></h3>
383
384         <p>Short answer: because <a href="/zsh/">Zsh rocks</a>, really!</p>
385
386         <p>Long(er) answer: If you don't know Zsh take a look the <a
387         href="/zsh/">Grml Zsh reference card</a>.</p>
388
389         <p>If you are a Bash user and don't know Zsh yet, don't be
390         afraid. Bash is largely a subset of Zsh and you don't have to
391         throw away your knowledge about shell stuff.</p>
392
393         <h2><a name="stuff"></a><a href="#toc">Support / Unanswered stuff</a></h2>
394
395         <h3><a name="questions"></a><a href="#toc">Further questions</a></h3>
396
397         <p>Do you have a question which is not answered in the FAQ or
398         in the provided <a href="/docs/">documentation</a> (execute
399         &quot;grml-info&quot; on your Grml system for offline
400         documentation)?  Also check out 'grml-tips $KEYWORD' on your
401         Grml system. Take a look at
402         <a href="/">the Grml website</a> and <a href="http://wiki.grml.org/">the
403           grml-wiki</a>. A good place to become part of the community is the <a
404           href="/mailinglist/">Grml mailinglist</a>.</p>
405
406         <h3><a name="support"></a><a href="#toc">Commercial Support</a></h3>
407
408         <p>You want to deploy Grml in your data center, use it as part of your
409         business or have an emergency case? You're happy with Grml but would
410         like to get your very own live cd (providing your favourite software
411         selection, special configuration, setup and your bootsplash)?
412         Please get in <a href="/contact/">touch with us</a>.</p>
413
414       </div>
415
416 [% INCLUDE static_bottom.inc %]