← Back to branch summary

~qbalazs/installation-guide/lp1030336

« back to all changes in this revision

Viewing changes to nl/install-methods/automatic-install.xml

  • Committer: joeyh
  • Date: 2005-10-07 19:51:38 UTC
  • Revision ID: vcs-imports@canonical.com-20051007195138-c3d57b2617a79a4f
move manual to top-level directory, split out of debian-installer package

Show diffs side-by-side

added added

removed removed

Lines of Context:
nl/install-methods/automatic-install.xml
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- original version: 28672 untranslated -->
 
3
 
 
4
 <sect1 id="automatic-install">
 
5
 <title>Automatic Installation</title>
 
6
<para>
 
7
 
 
8
For installing on multiple computers it's possible to do fully
 
9
automatic installations. Debian packages intended for this include
 
10
<classname>fai</classname> (which uses an install server),
 
11
<classname>replicator</classname>,
 
12
<classname>systemimager</classname>,
 
13
<classname>autoinstall</classname>, and
 
14
the Debian Installer itself.
 
15
 
 
16
</para>
 
17
 
 
18
  <sect2 id="preseed">
 
19
  <title>Automatic Installation Using the Debian Installer</title>
 
20
<para>
 
21
 
 
22
The Debian Installer supports automating installs via preconfiguration
 
23
files. A preconfiguration file can be loaded from the network or from
 
24
removable media, and used to fill in answers to question asked during the
 
25
installation process.
 
26
 
 
27
</para><para>
 
28
 
 
29
Although most dialogs used by &d-i; can be preseeded using this method,
 
30
there are some notable exceptions. You can (re)partition an entire disk
 
31
or use available free space on a disk; it is not possible to use existing
 
32
partitions. You currently cannot use preseeding to set up RAID and LVM.
 
33
<phrase condition="sarge">Also, with the exception of network driver modules,
 
34
it is not possible to preconfigure kernel module parameters.</phrase>
 
35
 
 
36
</para><para>
 
37
 
 
38
The preconfiguration file is in the format used by the
 
39
debconf-set-selections command. A well documented and working example that
 
40
you can edit is in <xref linkend="example-preseed"/>.
 
41
 
 
42
</para><para>
 
43
 
 
44
Alternatively, one way to get a complete file listing
 
45
all the values that can be preseeded is to do a manual install,
 
46
and then use <filename>debconf-get-selections</filename>,
 
47
from the <classname>debconf-utils</classname> package,
 
48
to dump both the debconf database and the cdebconf
 
49
database in /var/log/debian-installer/cdebconf to a single file:
 
50
 
 
51
<informalexample><screen>
 
52
$ debconf-get-selections --installer &gt; <replaceable>file</replaceable>
 
53
$ debconf-get-selections &gt;&gt; <replaceable>file</replaceable>
 
54
</screen></informalexample>
 
55
 
 
56
However, a file generated in this manner will have some items that should
 
57
not be preseeded, and the file in <xref linkend="example-preseed"/> is a
 
58
better starting place for most users.
 
59
 
 
60
</para><para>
 
61
 
 
62
Once you have a preconfiguration file, you can edit it if necessary, and
 
63
place it on a web server, or copy it onto the installer's boot media. Wherever
 
64
you place the file, you need to pass a parameter to the installer at boot
 
65
time to tell it to use the file.
 
66
 
 
67
</para><para>
 
68
 
 
69
To make the installer use a preconfiguration file downloaded from the
 
70
network, add preseed/url=http://url/to/preseed.cfg to the kernel boot
 
71
parameters. Of course the preconfiguration will not take effect until the
 
72
installer manages to set up the network to download the file, so this is
 
73
most useful if the installer can set up the network via DHCP without asking
 
74
any questions. You may want to set the installation priority to critical to
 
75
avoid any questions while the network is being configured. See
 
76
<xref linkend="installer-args"/>.
 
77
 
 
78
</para><para>
 
79
 
 
80
To place a preconfiguration file on a CD, you would need to remaster the
 
81
ISO image to include your preconfiguration file. See the manual page for
 
82
mkisofs for details. Alternatively, put the preseed file on a floppy, and
 
83
use preseed/file=/floppy/preseed.cfg
 
84
 
 
85
</para><para arch="i386">
 
86
 
 
87
If you'll be booting from a USB memory stick, then you can simply copy your
 
88
preconfiguration file onto the memory stick's filesystem, and edit the
 
89
syslinux.cfg file to add preseed/file=/hd-media/preseed.cfg to the kernel boot
 
90
parameters.
 
91
 
 
92
</para>
 
93
 
 
94
   <sect3 condition="etch">
 
95
   <title>Using Preseeding to Change Default Values</title>
 
96
<para>
 
97
 
 
98
It is also possible to use preseeding to change the default answer for a
 
99
question, but still have the question asked. To do this the
 
100
<firstterm>seen</firstterm> flag must be reset to <quote>false</quote> after
 
101
setting the value for a template.
 
102
 
 
103
<informalexample><screen>
 
104
d-i foo/bar string value
 
105
d-i foo/bar seen false
 
106
</screen></informalexample>
 
107
 
 
108
</para>
 
109
   </sect3>
 
110
  </sect2>
 
111
 </sect1>