Skip to end of metadata
Go to start of metadata

Working With Custom Kernels

Installing Custom Kernels

The Custom Kernel Installer allows you to retrieve the Kernel module required for the CDP Agent to work properly on Linux with custom kernel. Normally, the Custom Kernel Installer is executed automatically during the CDP Agent installation. However, you can also run the Custom Kernel Installer manually if your Linux configuration has changed (See the examples below). The r1soft-cki tool will automatically build a module suitable for your Kernel version.

Follow the instructions below to run the Custom Kernel Installer.

1. Use the r1soft-cki command to execute the Custom Kernel Installer. The r1soft-cki tool connects to the server (specified by -s option or default), sends the information about the Kernel, and then downloads the binary module from the server.

If you run the r1soft-cki tool without parameters, it will start downloading the Kernel module based on the parameters from the config file and default values. Do not run the r1soft-cki tool unless you have to. All parameters are listed in r1soft-cki.

Use -k and -d options to get the module for non-default Kernel and place it to non-default location:

# r1soft-cki -k /lib/modules/2.6.9-42.ELhugemem/build -d /tmp


gathering required information... tar: Removing leading `/' from member names sending request for kernel module... completed successfully. Retrieved backup driver (backupdriver-cki- size(469776)

Default path to the CKI program:


2. The next screen will display some debugging messages from the Custom Kernel Installer, followed by a message informing you that the Backup driver has been retrieved.

The Custom Kernel Installer should be able to connect to the Internet via HTTP. Make sure that the server has Internet connection and that the firewall does not block outgoing HTTP connections.

See also r1soft-cki.


You do not need to reinstall the CDP Agent after upgrading the Kernel. CKI will do all of the work for you.

Option A

1) Install new Kernel.

2) Install new Kernel-devel (Kernel headers).

3) Run r1soft-cki with the -k option pointing to the new Kernel headers.

4) Reboot the server.

Option B

1) Install new Kernel.

2) Install new Kernel-devel (Kernel headers).

3) Reboot server.

4) Run r1soft-cki with no options.

5) Restart buagent:

/etc/init.d/buagent restart

Option C

1) Install new Kernel.

2) Install new Kernel-devel (Kernel headers).

3) Reboot server.

4) Re-run the original Linux Agent installer.

5) Select "yes" to allow CKI to retrieve a Kernel module for you.

6) Continue installation as normal.

The major requirement is that the Kernel headers are installed. Copy the file it downloads to /lib/modules/buagent on the Host without internet access, that is using the Kernel source/headers you built against.
Enter labels to add to this page:
Please wait 
Looking for a label? Just start typing.