Readme where old documentation files can be found
[rrq/maintain_lilo.git] / debian / README.Debian
1 README for lilo in Debian
2 -------------------------
3
4
5 ** Distribution upgrade **
6
7 If you are upgrading or dist-upgrading, it is recommended to run 
8 /sbin/lilo after that. Usually this work will be done by the (new)
9 hook scripts for kernel and initramfs.
10
11
12 ** Other installed bootloader **
13
14 Please pay attention to the hook scripts for kernel and initrd, if  you
15 have also installed another bootloader. With every update of kernel or
16 initrd these hook scripts will be executed and then Lilo rewrite the MBR.
17 They don't check whether another bootloader is activated. 
18
19 Grub and Grub2 have its own hook scripts which will be executed, too, but
20 don't rewrite the MBR every time. If you have installed and configured 
21 other bootloader, then be aware, that they work differently and have its
22 own hook scripts, which could give you accidental situations. Please read
23 the package information about other installed bootloader for correct
24 configuration.
25
26
27 ** Large initrd files **
28
29 Usually LILO loads the initrd file into the first 15MB of memory to
30 avoid a BIOS limitation with older systems (earlier than 2001 and
31 few systems until 2004).
32
33 With newer kernels the combination of kernel and initrd may not fit
34 into the first 15MB of memory. LILO compute the needed size of memory
35 and will automatically use the memory above 15MB, too, if there is
36 enough physical memory. Then lilo give you information about this
37 while running lilo.
38
39 If this machine has a recent BIOS without a 15MB limitation and you
40 want to use memory above 15MB for all kernels, set the 'large-memory'
41 option. You will need to re-run the 'lilo' command to make this 
42 option take effect.
43
44
45 ** Solve the 15MB problem **
46
47 If the machine has an older BIOS which don't can use any memory above
48 15MB you should use the newer option 'small-memory' in /etc/lilo.conf 
49 to instruct LILO to use only the memory below the 15MB line. You may 
50 need to reduce the size of the initrd *before* rebooting.
51
52 If you are using initramfs-tools, you should replace MODULES=most with
53 MODULES=dep in your configuration and regenerate your initrd file:
54
55   sed -i -e s/MODULES=most/MODULES=dep/ /etc/initramfs-tools/initramfs.conf
56   update-initramfs -u
57
58
59 ** Inaccessible devices **
60
61 The old patch for better support for inaccessible disks based on
62 problems with usb sticks. But this option 'inaccessible' is only 
63 usable, if hard disks can not be accessed by the BIOS, but can always 
64 be accessed by linux. This option is not sensible for usb sticks, 
65 which will always bring failures if they are named in the lilo.conf. 
66 So please don't use the option 'inaccessible' with USB sticks or other
67 removable devices.
68
69
70 ** Inactive disks of MD RAID-1 array **
71
72 RAID-1 devices are supported as boot device. If not all RAID-1 disks
73 are activated use '-H' to install only to active disks. This option 
74 override fatal halt while found an inactive disk of an RAID-1 array.
75
76 Warning: Booting with partial RAID-1 installation only on active disks
77 is not failsafe!
78
79
80 ** Very old documentation **
81
82 The following very old documentation can be found in lilo-doc package:
83
84   - user.pdf
85   - tech.pdf
86   - INCOMPAT
87   - README
88   - README.disk
89   - README.common.problems
90   - README.volumeID
91   - README.pseudo
92   - README.bitmaps
93   - README.raid1