Table of contents

I. Introduction

II. Building and installing the kernel module

III. FAQ


	I. INTRODUCTION

In some cases, the setup program cannot compile the required kernel modules
or prepare the execution environment for the product. When this happens, the
setup program displays an error message and points you to this file.

Also, read section I (Building and installing the kernel module) if you  use
a custom kernel or if the kernel source files are in a nonstandard location.

	II. BUILDING AND INSTALLING THE KERNEL MODULE

Check the supported Linux distributions and versions at
https://dl.managed-protection.com/u/cyberprotect/help/17/user/en-US/index.html#cshid=36985.


In most  supported distributions, the installer automatically compiles the
kernel module required for the product to work.


If the installer cannot compile the module, you must manually install the
kernel source files, the appropriate configuration file, and all packages
needed to build the kernel. These packages include gcc, make, and
kernel-devel.


When you install the kernel source files, the system prompts you to install
any missing packages.

You can usually build and install the snapapi kernel module by using DKMS
commands:

    # dkms build -m <MODULE_NAME> -v <MODULE_VERSION> \
     --config <CONFIG_FILE> --arch <KERNEL_ARCH> \
     --kernelsourcedir <PATH_TO_KERNEL_SOURCES>

    # dkms install -m <MODULE_NAME> -v <MODULE_VERSION> \
     --config <CONFIG_FILE> --arch <KERNEL_ARCH> \
     --kernelsourcedir <PATH_TO_KERNEL_SOURCES>

In these commands:


    <MODULE_NAME>
        For 3.x kernels, the name is snapapi26.

    <MODULE_VERSION>
        This is the version of the snapapi26 module. To find the version,
        run the following command:

            # ls /usr/src | grep snapapi

        For example, if the directory name is snapapi26-0.7.64, then
        <MODULE_VERSION> is 0.7.64.


    <CONFIG_FILE>
        The name of your kernel configuration file, usually in the /boot
        directory.

        Specify the full file name. For example:

            /boot/config-5.15.0-73-generic



    <KERNEL_ARCH>
        The kernel architecture type (for example, i686).
        To find the architecture type, run the following command:

        For RPM-based distributions (such as Red Hat, CentOS, Fedora):

            # rpm -q --queryformat "%{ARCH}\n" kernel

        For non-RPM distributions (such as Ubuntu):

            # uname -m



For details about using DKMS, see the dkms man page.

After you successfully build and install the kernel module, run the product
to verify functionality. The required kernel modules will load automatically.

	III. FAQ

Q: How do I run the .i686 or .x86_64 installation file?

   A: These files are standard Linux binaries. To start the installation,
      run the following command:

          # chmod +x <FILE_NAME>

          # ./<FILE_NAME>

      Here, <FILE_NAME> is the name of your .i686 or .x86_64 installation
      file.

      The setup program uses the RPM Package Manager. If your system does
      not use RPM (for example, Ubuntu), install it first, by running the
      following command as the root user:


          #apt-get install -y rpm

Q: Is the .i686 installation file compatible with my x86_64 architecture?

   A: No. You must download and install the .x86_64 installation file. The
      installation steps are the same.

Q: Can I install the product on an IA64 system?

   A: No. IA64 architecture is not supported.

Q: The setup program cannot find the kernel source files in
   /lib/modules/<MY_KERNEL>/build or /lib/modules/<MY_KERNEL>/source. What
   should I do?

   A: This usually means that you need to install the kernel source files
      for your current kernel version.

      On systems such as Debian and Ubuntu, run the following commands:

          $ sudo apt-get update
          $ sudo apt-get install linux-headers-`uname -r`
          $ sudo apt-get install linux-image-`uname -r`


      On systems such as Red Hat Enterprise Linux and Fedora, run the
      following command:

          # yum install kernel-devel-`uname -r`