Ensuring that Intel® QuickAssist Technology stack is working correctly on RHEL 8

Updated -

Intel® QuickAssist Technology Library (QATlib) contains user space libraries that allow access for Intel® QAT devices. The libraries also expose Intel® QAT APIs and sample code. To get QATlib up and running:

  1. Create the qat user group.

    $ sudo groupadd qat
    
  2. Add your user to the qat group to use QATlib functionalities as non-root user.

    $ sudo usermod -a -G qat <YOUR_USER>
    
  3. Set the maximum amount of locked memory for your user to 200MB.

    # echo `whoami` - memlock 200000 >> /etc/security/limits.conf
    
  4. Add the intel_iommu=on parameter to the kernel command-line.

    $ sudo grubby --update-kernel=ALL --args="intel_iommu=on"
    
  5. Obtain firmware from Intel®, which is only available at the moment through early-access agreements. The firmware will be included in RHEL once finalized.

  6. Install the firmware to the /lib/firmware/ directory.

    • Install both the qat_4xxx.bin and qat_4xxx_mmp.bin file.
  7. Reboot your system so that the changes take effect.

  8. Verify that the qat_4xxx firmware was loaded correctly.

    $ dmesg -i -e | grep qat_4xxx
    

    If the driver did not load automatically after reboot, load it manually.

    $ modprobe qat_4xxx
    
  9. Enable and start the qat service and verify the service is running correctly.

    $ sudo systemctl enable --now qat
    $ systemctl is-enabled qat && systemctl is-active qat
    enabled
    active
    

For more information see the GitHub qatlib/INSTALL page.