How to Resolve Module Error in R1 Soft Backup?

March 22, 2020 / R1Soft Backups

When installing or updating the R1Soft/Idera CDP Agent, you may encounter module build failures due to missing kernel headers or development packages. These components are required for compiling the kernel driver (hcpdriver) that the CDP agent depends on. If the agent cannot automatically download or build the module, manual intervention is required.

This guide provides a clear, step‑by‑step approach to diagnosing the issue, manually installing the required kernel packages, rebuilding the module, and ensuring the CDP Agent functions correctly.

1. Check Whether the Module Builds Successfully

Run the following command to test if the kernel module builds properly:

serverbackup-setup --get-module
  • If kernel headers and development packages installed, the module should build automatically.
  • After a successful build, restart the CDP Agent service.

2. If the Module Build Fails

If you receive an output similar to this:

Building header archive.
Failed to get a suitable module for this system:
Failed to connect to a remote server.
Get module failed.
Falling back to the old get-module.

It means the system could not download a matching module, and you must build it manually.

3. Install Kernel Headers and Kernel Devel Packages Manually

a) Find the Correct RPM Packages

Use the following URL to locate the RPM packages that match your server’s installed kernel version:

http://rpm.pbone.net/index.php3/

Search using the kernel version returned by:

uname -r

b) Download the RPM Packages

Once you identify the kernel-devel and kernel-headers RPMs:

Copy the download link from the website.

Use wget to download:

wget <paste_header_rpm_url>

wget <paste_devel_rpm_url
Install the packages with:
rpm -ivh <package-name>.rpm
 
4. Restart the CDP Agent
 
After installing headers and devel packages:
service cdp-agent restart
or
systemctl restart cdp-agent
5. Verify the Module Build
 
Check whether the module has loaded successfully:
lsmod | grep hcp
If you see output, the module is built and loaded.
 

6. If the Module Still Fails

If the module does not load even after installation and agent restart:

Reboot the server

A reboot clears kernel-module mismatches and often resolves the issue.

Read more tutorial: How to Run Backup via Command Line