Chapter 6. Installation - step 3: Add/remove the (un)needed packages and modules

Table of Contents

Removing unneeded packages
Edit the syslinux.cfg file
Removing unneeded modules
Adding a new package
Adding extra modules in /lib/modules
Adding extra modules in /boot/lib/modules

The LEAF "Bering" floppy disk is provided with package(s) and/or module(s) you won't necessary need. Get rid of them to begin with.

Check the list of packages provided above to see if you need them. Some examples follow:

Removing unneeded packages

To remove a given package (say unneeded.lrp) from the LEAF disk, insert it in your floppy drive and boot it. When you will see the LEAF configuration menu, type q (quit) to get access to the linux shell. Then execute the following commands:

mount -t msdos /dev/fd0u1680 /mnt
cd /mnt
rm unneeded.lrp
cd /
umount /mnt

Edit the syslinux.cfg file

Make sure the list of packages that you want to load when the LEAF firewall floppy is booted correspond to those packages you want to load:

By default the syslinux.cfg file looks like:

display syslinux.dpy
timeout 0
default linux initrd=initrd.lrp init=/linuxrc rw root=/dev/ram0 boot=/dev/fd0u1680:msdos PKGPATH=/dev/fd0u1680 LRP=root,etc,local,modules,iptables,pump,keyboard,shorwall,ulogd,dnscache,weblet

You can also write the list of packages to a file with the name lrpkg.cfg in the floppy root, i.e. in the same directory as syslinux.cfg. If that file is present, the packages listed in the file will be loaded instead of those listed in the LRP= list.

Thus you get the same effect as in the default syslinux.cfg file by writing:

display syslinux.dpy
timeout 0
default linux initrd=initrd.lrp init=/linuxrc rw root=/dev/ram0 boot=/dev/fd0u1680:msdos PKGPATH=/dev/fd0u1680

to syslinux.cfg and:

root,etc,local,modules,iptables,pump,keyboard,shorwall,ulogd,dnscache,weblet

to lrpkg.cfg. This can help you get around the 255 character limit of the kernel command line. For a complete description of lrpkg.cfg and its syntax, see this section of the user's guide.

To edit the syslinux.cfg file:

mount -t msdos /dev/fd0u1680 /mnt
cd /mnt
ae syslinux.cfg
	(edit the LRP= list to fit your needs)
	(then save and exit)
cd /
umount /mnt

Other syslinux parameters:

  • log_size= Defines the size of the /var/log directory. Default= 2M

  • syst_size= Defines the size of the TMPFS filesystem. Default= 6M.

  • tmp_size= Defines the size of the /tmp directory. Default= remaining available memory

  • PKGPATH= Defines location of packages defined in the LRP= list. I.E. if they are stored on two different floppies, one will have something like:

display syslinux.dpy
timeout 0
default linux initrd=initrd.lrp log_size=4M init=/linuxrc rw root=/dev/ram0 boot=/dev/fd0u1680:msdos PKGPATH=/dev/fd0u1680,/dev/fd1u1680 LRP=root,etc,local,modules,iptables,pump,keyboard,libz,sshd,shorwall,ulogd,dnscache,weblet

In the example above packages not available on the first floppy drive (e.g. libz.lrp and sshd.lrp) will be loaded from a 1680K formatted floppy inserted in the second drive. On the top of that 4M are allocated to /var/log files.

Note

The LEAF editor is e3. The documentation is here. Different emulations are available: vi, ae or e3ws are the most common one.

Removing unneeded modules

Once you have removed the unneeded packages, you can remove the unneeded.o module(s) as follow:

cd /lib/modules
rm unneeded.o
lrcfg

Once you are back with the LEAF configuration menu select the LEAF packages backup entry and backup the modules package.

Adding a new package

To add a new package just copy it to the LEAF floppy and declare the name in the syslinux.cfg LRP= list.

Adding extra modules in /lib/modules

You can add many features to your LEAF "Bering" distribution by adding extra kernel modules. Once you know which modules you need, download them from the LEAF Bering modules directory to a standard (1,44M formatted) floppy disk. Boot the LEAF "Bering" floppy. Once you see the LEAF menu, remove the LEAF floppy and replace it with the modules floppy. Then issue the following commands:

mount -t msdos /dev/fd0 /mnt
cd /mnt
cp needed1.o needed2.o ... /lib/modules
cd /
umount /mnt
lrcfg

Through the LEAF Packages configuration menu select "modules" and declare those modules you need to load in /etc/modules.

Remember to save and backup modules.lrp !

Important

The LEAF "Bering" /etc/modules file contains templates to setup a bridge, to access to an IDE Hard-disk or CD-ROM and to activate USB.

Adding extra modules in /boot/lib/modules

You can choose to load those extra kernel modules at the early stage of the boot process right after initrd filesystem is mounted. This is typically used to get access to a storage device where the remaining LEAF packages are stored. Once you know which modules you need, download them from the LEAF Bering modules directory to a standard (1,44M formatted) floppy disk. Boot the LEAF "Bering" floppy. Once you see the LEAF menu, remove the LEAF floppy and replace it with the modules floppy. Then issue the following commands:

mount -t msdos /dev/fd0 /mnt
cd /mnt
cp needed1.o needed2.o ... /boot/lib/modules
cd /
umount /mnt
lrcfg

Through the LEAF Packages configuration menu select "initrd" and declare those modules you need to load in /boot/etc/modules.

Remember to save and backup initrd.lrp !