Red Hat Apache Module Install

  Last updated 2024-08-02

IMPORTANT

This guide only applies to Next-Gen WAF customers with access to the Next-Gen WAF control panel. If you have access to the Next-Gen WAF product in the Fastly control panel, you can only deploy the Next-Gen WAF with the Edge WAF deployment method.

Prerequisites

If you haven't already, add the Red Hat package repository on the host that will contain the module.

Install the Apache module

  1. Install the Next-Gen WAF Apache module.

    • Red Hat CentOS 9 / RHEL 9

      $ sudo yum install sigsci-module-apache

    • Red Hat CentOS 8 / RHEL 8

      $ sudo yum install sigsci-module-apache

    • Red Hat CentOS 7 / RHEL 7

      $ sudo yum install sigsci-module-apache

    • Red Hat CentOS 6 / RHEL 6 with Apache 2.4

      $ sudo yum install sigsci-module-apache24

    • Red Hat CentOS 6 / RHEL 6 with Apache 2.2 64-bit

      $ sudo yum install sigsci-module-apache

    • Red Hat CentOS 6 / RHEL 6 with Apache 2.2 32-bit

      $ sudo yum install sigsci-module-apache22

  2. Add the following line to your Apache configuration file (apache2.conf or httpd.conf) after the Dynamic Shared Object (DSO) Support section to enable the Next-Gen WAF Apache module:

    LoadModule signalsciences_module /etc/httpd/modules/mod_signalsciences.so

  3. Restart Apache.

    • Red Hat CentOS 9 / RHEL 9

      $ sudo systemctl restart httpd

    • Red Hat CentOS 8 / RHEL 8

      $ sudo systemctl restart httpd

    • Red Hat CentOS 7 / RHEL 7

      $ sudo systemctl restart httpd

    • Red Hat CentOS 6 / RHEL 6

      $ sudo service httpd restart

  4. Verify the agent and module installation.

Apache module fails to load

NOTE

The following information has been confirmed for RHEL/CentOS deployments using the default yum module installation.

The default install location for the SigSci Apache module is /etc/httpd/modules but some systems may have Apache loading it's config from a non-standard directory. When this happens the yum installer will not install mod_signalsciences.so to /etc/httpd/modules but instead to the following path:

/usr/lib64/httpd/modules/mod_signalsciences.so

If Apache fails to restart after the module installation because it cannot locate mod_signalsciences.so change the LoadModules line in httpd.conf to reflect the correct location on the target system.

Next steps

Once you've installed the Apache module, you can explore different module configuration options.

Was this guide helpful?

Do not use this form to send sensitive information. If you need assistance, contact support. This form is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.

Fastly
© Fastly 2024