Add readme snippet about defragmenting problems
[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 hook
9 scripts for kernel and initramfs (see /etc/kernel, /etc/initramfs).
10
11
12 ** Other installed bootloader **
13
14 Please pay attention to the hook scripts for kernel and initramfs, if  you
15 have also installed another bootloader. With every update of kernel or
16 initramfs 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 ** XFS defragmenting /boot **
28
29 On the XFS filesystem (or others too?), there could growing problems with
30 kernel files (vmlinuz*) in /boot directory while someone defragmenting
31 partitions. To protect vmlinuz* files from moving to other addresses on the
32 disk, which would lead to an unbootable system, it is recommended to use
33 'chattr' if the /boot directory have a XFS filesystem.
34
35 Lilo 24.1 comes with some hook scripts for this case. Go into directory
36 /usr/lib/lilo/hook and start the Makefile as root with 'make install'. Then
37 these scripts will ensure that lilo survives when xfs defragments files.
38
39
40 ** Large initrd files **
41
42 Usually LILO loads the initrd file into the first 15MB of memory to
43 avoid a BIOS limitation with older systems (earlier than 2001 and
44 few systems until 2004).
45
46 With newer kernels the combination of kernel and initrd may not fit
47 into the first 15MB of memory. LILO compute the needed size of memory
48 and will automatically use the memory above 15MB, too, if there is
49 enough physical memory. Then lilo give you information about this
50 while running lilo.
51
52 If this machine has a recent BIOS without a 15MB limitation and you
53 want to use memory above 15MB for all kernels, set the 'large-memory'
54 option. You will need to re-run the 'lilo' command to make this 
55 option take effect.
56
57
58 ** Solve the 15MB problem **
59
60 If the machine has an older BIOS which don't can use any memory above
61 15MB you should use the newer option 'small-memory' in /etc/lilo.conf 
62 to instruct LILO to use only the memory below the 15MB line. You may 
63 need to reduce the size of the initrd *before* rebooting.
64
65 If you are using initramfs-tools, you should replace MODULES=most with
66 MODULES=dep in your configuration and regenerate your initrd file:
67
68   sed -i -e s/MODULES=most/MODULES=dep/ /etc/initramfs-tools/initramfs.conf
69   update-initramfs -u
70
71
72 ** Inaccessible devices **
73
74 The old patch for better support for inaccessible disks based on
75 problems with usb sticks. But this option 'inaccessible' is only 
76 usable, if hard disks can not be accessed by the BIOS, but can always 
77 be accessed by linux. This option is not sensible for usb sticks, 
78 which will always bring failures if they are named in the lilo.conf. 
79 So please don't use the option 'inaccessible' with USB sticks or other
80 removable devices.
81
82
83 ** Inactive disks of MD RAID-1 array **
84
85 RAID-1 devices are supported as boot device. If not all RAID-1 disks
86 are activated use '-H' to install only to active disks. This option 
87 override fatal halt while found an inactive disk of an RAID-1 array.
88
89 Warning: Booting with partial RAID-1 installation only on active disks
90 is not failsafe!
91
92
93 ** Very old documentation **
94
95 The following very old documentation can be found in lilo-doc package:
96
97   - html/user_21-5.html
98   - html/tech_21-5.html
99   - INCOMPAT
100   - README
101   - README.disk
102   - README.common.problems
103   - README.volumeID
104   - README.pseudo
105   - README.bitmaps
106   - README.raid1