← Back to branch summary

~qbalazs/installation-guide/lp1030336

« back to all changes in this revision

Viewing changes to da/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:
da/install-methods/automatic-install.xml
 
1
<!-- retain these comments for translator revision tracking -->
 
2
<!-- original version: 22580 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>
 
19
<title>Automatic installation using the Debian Installer</title>
 
20
 
 
21
<para>
 
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
The preconfiguration file is in the format used by the
 
30
debconf-set-selections command. A well documented and working example that
 
31
you can edit is in <xref linkend="example-preseed"/>.
 
32
 
 
33
</para><para>
 
34
 
 
35
The preconfiguration file is in the format used by the
 
36
debconf-set-selections command, and one way to get a complete file listing
 
37
all the values that can be preseeded is to do a manual install,
 
38
and then use <filename>debconf-get-selections</filename>,
 
39
from the <classname>debconf-utils</classname> package,
 
40
to dump both the debconf database and the cdebconf
 
41
database in /var/log/debian-installer/cdebconf to a single file:
 
42
 
 
43
<informalexample><screen>
 
44
debconf-get-selections --installer > file
 
45
debconf-get-selections >> file
 
46
</screen></informalexample>
 
47
 
 
48
</para><para>
 
49
 
 
50
However, a file generated in this manner will have some items that should
 
51
not be preseeded, and the file in <xref linkend="example-preseed"/> is a
 
52
better starting place for most users.
 
53
 
 
54
</para><para>
 
55
 
 
56
Once you have a preconfiguation file, you can edit it if necessary, and
 
57
place it on a web server, or copy it onto the installer's boot media. Wherever
 
58
you place the file, you need to pass a parameter to the installer at boot
 
59
time to tell it to use the file.
 
60
 
 
61
</para><para>
 
62
 
 
63
To make the installer use a preconfiguration file downloaded from the
 
64
network, add preseed/url=http://url/to/preseed.cfg to the kernel boot
 
65
parameters. Of course the preconfiguration will not take effect until the
 
66
installer manages to set up the network to download the file, so this is
 
67
most useful if the installer can set up the network via DHCP without asking
 
68
any questions. You may want to set the installation priority to critical to
 
69
avoid any questions while the network is being configured. See 
 
70
<xref linkend="installer-args"/>.
 
71
 
 
72
</para><para>
 
73
 
 
74
To place a preconfiguration file on a CD, you would need to remaster the
 
75
ISO image to include your preconfiguraton file. See the manual page for
 
76
mkisofs for details. Alternatively, put the preseed file on a floppy, and
 
77
use preseed/file=/floppy/preseed.cfg
 
78
 
 
79
</para><para arch="i386">
 
80
 
 
81
If you'll be booting from a USB memory stick, then you can simply copy your
 
82
preconfiguration file onto the memory stick's filesystem, and edit the
 
83
syslinux.cfg file to add preseed/file=/hd-media/preseed.cfg to the kernel boot
 
84
parameters.
 
85
 
 
86
</para>
 
87
</sect2>
 
88
 </sect1>