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

Updated -

Environment

  • Red Hat Enterprise Linux 8
  • Red Hat Enterprise Linux 9

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. Make sure you have the needed firmware files qat_4xxx.bin and qat_4xxx_mmp.bin. We already ship these with the linux-firmware package since versions 20230404-114.git2e92a49f.el8_8 or 20230310-133.el9_2. It is sufficient to just update this package and reboot if needed.

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

    $ modprobe qat_4xxx

    Verify that the qat_4xxx firmware was loaded correctly.

    $ dmesg -i -e | grep qat_4xxx

  7. 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

Additional resources about utilities from the QAT ecosystem:

For more information about installing QATlib, see the GitHub qatlib/INSTALL page.
For more information about the QATlib technology in general, see Intel® QuickAssist Technology Library (QATlib).
For introduction and description of the QAT OpenSSL Engine, see Intel® QuickAssist Technology(QAT) OpenSSL* Engine.
For introduction and description of the QATzip library, see Intel® QuickAssist Technology (QAT) QATzip Library.
For list if supported devices, see Supported Devices

Comments