9766: Compiling SNAPAPI module for Citrix XenServer

use Google Translate

Operating Systems: 

SNAPAPI kernel module cannot be compiled on Citrix XenServer following the standard procedure because the repositories do not provide kernel headers

This article applies to:

  • Acronis Backup & Recovery 11.5 Advanced Server Multi-platform
  • Acronis Backup & Recovery 11.5 Advanced Server for Linux
  • Acronis Backup & Recovery 11.5 Virtual Edition Multi-hypervisor
  • Acronis Backup & Recovery 11.5 Virtual Edition for Hyper-V
  • Acronis Backup & Recovery 11.5 Virtual Edition for VMware vSphere
  • Acronis Backup & Recovery 11.5 Virtual Edition for RHEV
  • Acronis Backup & Recovery 11.5 Virtual Edition for Citrix XenServer
  • Acronis Backup & Recovery 11.5 Virtual Edition for Parallels
  • Acronis Backup & Recovery 11.5 Server for Linux
  • Acronis Backup & Recovery 10 Advanced Server (Agent for Linux)
  • Acronis Backup & Recovery 10 Server for Linux (Standalone)
  • Acronis Backup & Recovery 10 Advanced Server - Virtual Edition (Agent for Linux)

Introduction

It is not possible to compile SnapAPI kernel module on Citrix XenServer because the kernel headers are not available from the package repository. There is a special procedure to compile and insert the kernel module, described in the Citrix Knowledge Base.

(!) If you have XenServer 6.0.2, then you do not need to compile the driver. Please download and unpack precompiled SnapAPI for XenServer 6.0.2. Then follow the Steps 9 through 11 of this article.

Solution

  1. Download the Driver Development Kit (DDK) from the Citrix web site. The DDK comes as an ISO file, with RPM source packages and one XML file containing the information of the contents of the ISO image. For Citrix XenServer 5.5 Update 1 the file name is XenServer-5.5.0-Update1-DDK.iso
  2. In Citrix XenCenter, select the Host Server to import VM onto:
  3. Select File IMPORT VM:

  4. Browse to the mounted DDK ISO image and select the ova.xml file;
  5. After the import is completed connect to the newly created Virtual Machine;
  6. Copy the driver sources to the DDK VM, and unpack them:

    # tar -xzf snapapi26-0.7.51-all.tar.gz

  7. Copy the sources to the /usr/src directory:

    # cp dkms_source_tree /usr/src/snapapi26

  8. Compile the driver:

    # make –C /usr/src/kernels/`uname -r`-`uname -m` M=/usr/src/snapapi26

  9. Copy the created file snapapi26.ko to /lib/modules/`uname -r`/kernel/drivers/block directory of the host machine;
  10. Recreate the list of module dependencies:

    # depmod

  11. Make sure the driver can load:

    # modprobe snapapi26 && lsmod | grep snapapi26

More information

Feel free to contact Acronis Customer Central if you have further questions or need assistance.

Tags: 

You are reporting a typo in the following text:
Simply click the "Send typo report" button to complete the report. You can also include a comment.
CAPTCHA
This question is for testing whether or not you are a human visitor and to prevent automated spam submissions.
3 + 7 =
Solve this simple math problem and enter the result. E.g. for 1+3, enter 4.