| 1 |
ley |
3981 |
How to install sarge with the new debian-installer |
| 2 |
|
|
-------------------------------------------------- |
| 3 |
|
|
|
| 4 |
|
|
This documents describes how to perform an installation with the new |
| 5 |
|
|
debian-installer, which will be released together with the upcoming |
| 6 |
|
|
Debian release, codename: sarge. |
| 7 |
|
|
|
| 8 |
ley |
4023 |
Find a recent revision of this document in the debian-installer cvs |
| 9 |
|
|
repository, browsable via web: |
| 10 |
|
|
http://cvs.debian.org/debian-installer/doc/INSTALLATION-HOWTO?rev=HEAD&content-type=text/vnd.viewcvs-markup |
| 11 |
ley |
3981 |
|
| 12 |
ley |
4585 |
Last change to this document: 06.10.2003 |
| 13 |
|
|
|
| 14 |
ley |
3981 |
1. Preliminaries |
| 15 |
|
|
|
| 16 |
ley |
4585 |
Debian-installer images are currently only available for the i386, |
| 17 |
|
|
alpha and powerpc architectures. Ports to other architectures are of |
| 18 |
|
|
course welcome. Please see section 6 if you want to help developing. |
| 19 |
ley |
3981 |
|
| 20 |
joeyh |
3984 |
The debian-installer is still in its alpha state. If you encounter |
| 21 |
ley |
3981 |
bugs during your install, please refer to section 5 on how to report |
| 22 |
|
|
them. If you have questions which cannot be answered by this document, |
| 23 |
joeyh |
3984 |
please direct them to the debian-boot mailing list |
| 24 |
ley |
3981 |
(debian-boot@lists.debian.org) or ask on irc (#debian-boot on the |
| 25 |
|
|
freenode network). |
| 26 |
|
|
|
| 27 |
ley |
4585 |
Recently the debian-installer has switched to ask only the important |
| 28 |
|
|
questions and confugure the rest automatically. This also involves |
| 29 |
|
|
that you won't get to see the main menu anymore, except when something |
| 30 |
|
|
goes wrong. If you want to restore the old configuration with more |
| 31 |
|
|
questions asked, set DEBCONF_PRIORITY=medium at the boot prompt. If |
| 32 |
|
|
you do so, refer to section 3.1. for installing rather than section 3. |
| 33 |
|
|
|
| 34 |
ley |
3981 |
|
| 35 |
|
|
2. Getting images |
| 36 |
|
|
|
| 37 |
|
|
The installer team provides different types of images for the |
| 38 |
|
|
debian-installer. They are described below, choose whatever image |
| 39 |
|
|
suits you best. However note: This document only covers the |
| 40 |
|
|
installation from CD! |
| 41 |
|
|
|
| 42 |
|
|
2.1. Install from CD |
| 43 |
|
|
|
| 44 |
|
|
The debian-cd team provides two netinst images which can be used to |
| 45 |
|
|
install sarge with the debian-installer. They can be obtained here: |
| 46 |
|
|
http://gluck.debian.org/cdimage/testing/netinst/i386/ |
| 47 |
|
|
|
| 48 |
|
|
These images are intended to boot from CD and install additional |
| 49 |
|
|
packages over a network, hence the name 'netinst'. The difference |
| 50 |
|
|
between the two images is, that on the full netinst image the base |
| 51 |
|
|
packages are included, whereas you have to download these from the web |
| 52 |
joeyh |
3984 |
if you are using the business card image. |
| 53 |
ley |
3981 |
|
| 54 |
|
|
2.2. Install from floppy |
| 55 |
|
|
|
| 56 |
|
|
If you can't boot from CD, you can download floppy images to install |
| 57 |
|
|
Debian. Daily built images can be found here: |
| 58 |
|
|
http://people.debian.org/~sjogren/d-i/images/daily/ |
| 59 |
|
|
|
| 60 |
|
|
You need the floppy-image.img and one of the drivers disks |
| 61 |
|
|
net_drivers-image.img or cd_drivers-image.img. The drivers disks |
| 62 |
|
|
contain the necessary modules to do the actual installation from CD or |
| 63 |
|
|
over the network. |
| 64 |
|
|
|
| 65 |
|
|
|
| 66 |
|
|
3. Installation |
| 67 |
|
|
|
| 68 |
|
|
From here on, I assume you have downloaded and burnt the 'netinst' |
| 69 |
|
|
CD. Put it into your CD-drive and make your system boot from CD. |
| 70 |
|
|
|
| 71 |
|
|
You will be greeted by a welcome screen. Hit ENTER to boot. After a |
| 72 |
ley |
4585 |
while you will be asked to select your language. This will affect |
| 73 |
|
|
translation of debian-installer (if already available for your |
| 74 |
|
|
language) as well as the choice of a keyboard layout. Select your |
| 75 |
|
|
language and press ENTER to continue. |
| 76 |
ley |
3981 |
|
| 77 |
ley |
4585 |
Sit back while debian-installer detects some of your hardware, and |
| 78 |
|
|
loads additional installer modules from the cd. |
| 79 |
|
|
|
| 80 |
|
|
The next thing you will be confronted with is a note, that |
| 81 |
|
|
debian-installer could not find a network interface. This is a known |
| 82 |
|
|
bug but can be easily worked around. Select continue and watch the |
| 83 |
|
|
main menu which will appear everytime if something went wrong, so you |
| 84 |
|
|
have more control over the situation. Select "Detect network hardware |
| 85 |
|
|
and load kernel drivers for it" and debian-installer will continue |
| 86 |
|
|
gracefully. If you have a pcmcia network card try using the menu entry |
| 87 |
|
|
"Start PC card services (PCMCIA)". |
| 88 |
|
|
|
| 89 |
|
|
The next questions will help you to configure your mirror. First |
| 90 |
|
|
select the protocol to access your mirror. If unsure use "http" as the |
| 91 |
|
|
help text suggests. If you know a mirror which will be fast for you, |
| 92 |
|
|
you can enter it by selecting the last entry "enter information |
| 93 |
|
|
manually" on the next screen. If not, just select the country where |
| 94 |
|
|
you are located. After selecting the mirror you will be asked for your |
| 95 |
|
|
proxy configuration. If unsure just hit ENTER. To complete your mirror |
| 96 |
|
|
setup you have to select the distribution you wish to install. You |
| 97 |
|
|
have to select "sarge" here, "woody" and "sid" won't work (if you want |
| 98 |
|
|
to install sid directly, you may want to try the businesscard image, |
| 99 |
|
|
where selecting "sid" actually works). |
| 100 |
|
|
|
| 101 |
|
|
Now it is time to partition your harddisks. Select the disk you want |
| 102 |
|
|
to partition and a partitioning program suitable for your architecture |
| 103 |
|
|
will be started. Partition the harddisk to your needs and quit the |
| 104 |
|
|
program. Select "Finish" to proceed. |
| 105 |
|
|
|
| 106 |
|
|
On the next screens you have to configure and mount your |
| 107 |
|
|
partitions. Select the partitions you want to use in the system you |
| 108 |
|
|
wish to install and select a filesystem and a mount point for |
| 109 |
|
|
them. Remember to assign at least one partition for swap space and to |
| 110 |
|
|
mount a partition on "/". Please note the debian-installer will do no |
| 111 |
|
|
changes to your harddisks until you select "Finish". Do this when you |
| 112 |
|
|
are sure that you have found a suitable setup for your partitions and |
| 113 |
|
|
answer the next question with "Yes". |
| 114 |
|
|
|
| 115 |
|
|
Now debian-installer starts to install the base system which can take |
| 116 |
|
|
a while. |
| 117 |
|
|
|
| 118 |
|
|
The next thing you will see, is a little oddity which we will |
| 119 |
|
|
hopefully get rid of soon. Answer the question if you want to |
| 120 |
|
|
automatically partition your harddrives with "No", and you will see |
| 121 |
|
|
the main menu again. Select "Install the kernel" and answer the |
| 122 |
|
|
following question about how you want to generate you fstab with |
| 123 |
|
|
"debian-installer utility for creating fstab file". You will be |
| 124 |
|
|
prompted for the kernel to install which will leave you most probably |
| 125 |
|
|
with only one choice. Select it and wait until the kernel is installed |
| 126 |
|
|
on your harddisk. |
| 127 |
|
|
|
| 128 |
|
|
The last step is to install a boot loader. You will be prompted for |
| 129 |
|
|
the bootblock, where LILO should be installed. It defaults to the |
| 130 |
|
|
bootrecord of the first harddrive which is generally a good |
| 131 |
|
|
choice. Hit ENTER and ignore the following warning that |
| 132 |
|
|
/proc/partitions does not exist. |
| 133 |
|
|
|
| 134 |
|
|
Debian-installer will now tell you that the installation has |
| 135 |
|
|
finished. Remove the cdrom from your drive and hit ENTER to reboot |
| 136 |
|
|
your machine. Make sure it boots from harddisk, cross your fingers and |
| 137 |
|
|
wait until base-config is started. |
| 138 |
|
|
|
| 139 |
|
|
Stepping through base-config is not within the scope of this document |
| 140 |
|
|
as it is not part of debian-installer. |
| 141 |
|
|
|
| 142 |
|
|
|
| 143 |
|
|
3.1. Installation with DEBCONF_PRIORITY=medium |
| 144 |
|
|
|
| 145 |
|
|
From here on, I assume you have downloaded and burnt the 'netinst' |
| 146 |
|
|
CD. Put it into your CD-drive and make your system boot from CD. |
| 147 |
|
|
|
| 148 |
|
|
You will be greeted by a welcome screen. Type "linux |
| 149 |
|
|
DEBCONF_PRIORITY=medium" and hit ENTER to boot. After a while you will |
| 150 |
|
|
be presented with the main-menu of the debian-installer. Some general |
| 151 |
|
|
remarks: |
| 152 |
|
|
|
| 153 |
ley |
3981 |
The main-menu is not static. New entries are added when new installer |
| 154 |
|
|
modules are loaded. However main-menu tries to resolve the next best |
| 155 |
joeyh |
3984 |
choice and presents that as default selection. If that selection does |
| 156 |
ley |
3985 |
not suit your needs just select another entry. If you select an entry |
| 157 |
|
|
that requires the configuration of an entry you did not yet choose, |
| 158 |
|
|
the main-menu will try to resolve these dependencies automatically. |
| 159 |
ley |
4586 |
This can be used to automate the install process, by selecting always |
| 160 |
|
|
the last visible step and. |
| 161 |
ley |
3981 |
|
| 162 |
|
|
When main-menu first is shown, the default will be "Choose language". |
| 163 |
|
|
Hit return and choose your language from the list that now is |
| 164 |
|
|
presented. You will be taken back to main-menu and the next item will |
| 165 |
|
|
be the default, which is "Detect a keyboard and select layout". |
| 166 |
|
|
|
| 167 |
|
|
Select that entry and observe that the installer tries to set a |
| 168 |
|
|
reasonable default based upon your language selection. Select your |
| 169 |
|
|
preferred keymap and continue. |
| 170 |
|
|
|
| 171 |
|
|
The next step is "Detect CDROM devices and mount the CD in |
| 172 |
|
|
/cdrom". This step does not require user interaction, everything |
| 173 |
|
|
happens automatically. |
| 174 |
|
|
|
| 175 |
|
|
Now we are able to access additional modules. Select the corresponding |
| 176 |
|
|
entry "Load installer modules". Since the modules we want to access |
| 177 |
|
|
are on the CD, select "cdrom-retriever". The floppy-retriever can be |
| 178 |
|
|
used to load additional modules from a floppy, e.g. if you have exotic |
| 179 |
|
|
hardware. |
| 180 |
|
|
|
| 181 |
|
|
You are presented a long list with optional modules to install. We |
| 182 |
|
|
only want to install the standard modules, which are selected |
| 183 |
|
|
automatically, so just hit "Continue". Wait and watch until all |
| 184 |
|
|
modules have been installed. |
| 185 |
|
|
|
| 186 |
|
|
Main-menu appears again, but with the additional modules there are new |
| 187 |
|
|
entries. The next default step would be to configure a network. We are |
| 188 |
|
|
breaking out of the default route, because we do not need networking |
| 189 |
|
|
since the base debs are on the CD. |
| 190 |
|
|
|
| 191 |
|
|
Select "Detect hardware and load kernel drivers for it (full |
| 192 |
|
|
version)". This step again involves no user interaction. |
| 193 |
|
|
|
| 194 |
ley |
4172 |
Now it is time to partition your disk. There are basically two ways to |
| 195 |
|
|
do that. The first one is to use cfdisk, which will be started upon |
| 196 |
|
|
selecting the menu entry "Partition a harddrive". Be sure to create at |
| 197 |
|
|
least two partitions, one for swap and one for the root filesystem. |
| 198 |
ley |
3981 |
|
| 199 |
ley |
4172 |
The other possibility is to use the autopartitioner. Select |
| 200 |
|
|
"Automatically partition harddrives" which tries to determine a sane |
| 201 |
|
|
partitioning. WARNING: Use this option ONLY if you have no or |
| 202 |
|
|
unimportant data on your harddrives. |
| 203 |
ley |
3981 |
|
| 204 |
|
|
After finishing partitioning, select the entry "Configure and mount |
| 205 |
|
|
partitions". Since autopartkit creates filesystems and mounts them |
| 206 |
|
|
automatically you can skip this step if you used autopartkit to |
| 207 |
|
|
partition your harddrive. |
| 208 |
|
|
|
| 209 |
|
|
Configuring the partitions is pretty straightforward. You are |
| 210 |
joeyh |
3984 |
presented with a list with all partitions, their sizes and a filesystem |
| 211 |
|
|
if one was detected on that partition. Selecting a partition lets you |
| 212 |
ley |
3981 |
choose which filesystem to create on that partition. If you select a |
| 213 |
|
|
non-swap filesystem, you are also asked for a mount point. |
| 214 |
|
|
|
| 215 |
|
|
Configure the partitions to your need, and remember to specify a |
| 216 |
joeyh |
3984 |
partition with mount point "/". When you've made your choices, select |
| 217 |
ley |
3981 |
"Finish" and confirm that the filesystems should be created as |
| 218 |
|
|
requested. |
| 219 |
|
|
|
| 220 |
|
|
Now we are ready to install the base system. Select the corresponding |
| 221 |
|
|
entry ("Install the base system") and lean back. The packages are |
| 222 |
|
|
retrieved from the CD and installed in the /target area. |
| 223 |
|
|
|
| 224 |
|
|
Next step will be to install the kernel ("Install the kernel"). If you |
| 225 |
|
|
did not use autopartkit to partition your harddrive you will be asked |
| 226 |
|
|
how your fstab file should be created. Select "debian-installer |
| 227 |
|
|
utility for creating fstab file" to do that. |
| 228 |
|
|
|
| 229 |
|
|
Next you will presented a list of all available kernel images on the |
| 230 |
|
|
CD. Select the most suitable for your system and wait until the |
| 231 |
|
|
installation has finished. |
| 232 |
|
|
|
| 233 |
ley |
3985 |
Now we are almost done. Select "Install LILO on a hard disk" or |
| 234 |
|
|
"Install GRUB on a hard disk" to make your harddisk bootable. You will |
| 235 |
|
|
be asked where LILO/GRUB shall install the bootblock. A good idea is |
| 236 |
|
|
your first harddrive in your system which should be in fact the |
| 237 |
|
|
default selection. |
| 238 |
ley |
3981 |
|
| 239 |
|
|
If that last step has completed successfully select "Finish the |
| 240 |
joeyh |
3984 |
installation and reboot", eject your CD and wait until your computer |
| 241 |
ley |
3981 |
restarts. Make sure it boots from harddisk, cross your fingers and |
| 242 |
|
|
wait until base-config is started. |
| 243 |
|
|
|
| 244 |
|
|
Stepping through base-config is not within the scope of this document |
| 245 |
|
|
as it is not part of debian-installer. |
| 246 |
|
|
|
| 247 |
|
|
4. Installation Report |
| 248 |
|
|
|
| 249 |
|
|
If you successfully managed an installation with debian-installer, |
| 250 |
|
|
please take you time to provide us with a report. There is a template |
| 251 |
|
|
named "install-report.template" in the /root directory of a freshly |
| 252 |
|
|
installed system. Please fill it out and file it as a bug against the |
| 253 |
|
|
package "installation-reports". See section 5 on how to file bugs. |
| 254 |
|
|
|
| 255 |
|
|
|
| 256 |
|
|
5. Reporting bugs |
| 257 |
|
|
|
| 258 |
|
|
If you did not reach base-config or ran into other trouble, you |
| 259 |
|
|
probably found a bug in debian-installer. To improve the installer it |
| 260 |
|
|
is necessary that we know about them, so please take your time and |
| 261 |
|
|
report them. |
| 262 |
|
|
|
| 263 |
joeyh |
3984 |
First, look here to see if your bug has already been reported: |
| 264 |
ley |
3981 |
http://bugs.qa.debian.org/cgi-bin/debian-installer.cgi?full=yes |
| 265 |
|
|
|
| 266 |
|
|
The page is sorted by packages which represent the individual |
| 267 |
joeyh |
3984 |
subsystems of debian-installer. File your bug against the respective |
| 268 |
ley |
3981 |
subsystem or, if you do not know which it is, against the package |
| 269 |
|
|
"install". Look here for an explanation of how to file bugs: |
| 270 |
|
|
http://www.debian.org/Bugs/Reporting |
| 271 |
|
|
|
| 272 |
|
|
|
| 273 |
|
|
6. Get involved |
| 274 |
|
|
|
| 275 |
|
|
The Debian-Installer Team always welcomes people who would like to |
| 276 |
|
|
work on the installer. We have plenty of work to do: fixing bugs, |
| 277 |
|
|
improve usability, create new modules and of course extensive |
| 278 |
|
|
testing. If you are interested to help, check out this page: |
| 279 |
ley |
4023 |
http://www.debian.org/devel/debian-installer/ |
| 280 |
|
|
|
| 281 |
|
|
An overview of the status of d-i related packages can be obtained here: |
| 282 |
|
|
http://qa.debian.org/developer.php?login=debian-boot@lists.debian.org |
Parent Directory
| 
Revision Log