Generic Module

'Generic modules' make it possible to introduce any files into the basic Linux system of the clients or to overwrite existing files. This is necessary if you require special iptables rules, printing configurations or similar adjustments within the basic system.

To create generic modules, the following steps are necessary:

1. Prepare Archive

Create an archive whose given directory structure is extracted one-to-one into the booted Linux - a file etc/example.conf contained in the archive will also appear under /etc/example.conf in the booted system.

Start with the necessary folder hierarchy for our example:

mkdir -p ~/generic_module/etc/
cd ~/generic_module/etc/

Put the following example file there

# I am an example :)

Then switch to the ~/generic_module directory you created:

cd ~/generic_module

and pack this file as a tar-gz-based archive (extension .tgz) so that the directory 'etc' appears at the root level of the archive:

tar czf example.tgz etc/

Double check the archive:

tar tvf example.tgz

This is how the archive should look (Click to expand)

This tgz archive can then be loaded onto the satellite server as a generic module in the next step.

The archive is unpacked in the MiniLinux in the root directory. Be sure to set the correct permissions for your folders and files.

2. Upload New Module

The archive must then be uploaded via the web interface of your satellite server. Go to the page 'Lokalisierung + Integration' and select 'Neues Modul'. There you can add a 'Generisches Modul' as the last item. Select your prepared archive and assign it a unique name. After uploading, the contents of the archive will be displayed.

Remember that you still need to assign the module to the active system configuration. Otherwise this will not be used!

3. Restart Client and Check

Start a bwLehrpool client, log in and select the 'Openbox' under 'Natives Linux'. If everything works, your file should now be available. Check this, e.g. as follows:

cat /etc/example.conf