Skip to content

Installation of the filtering node from DEB or RPM packages on AWS

This quick guide provides the steps to install the filtering node from the source packages on a separate Amazon EC2 instance. By following this guide, you will create an instance from the supported operating system image and install the Wallarm filtering node on this operating system.

The instructions limitations

These instructions do not cover the configuration of load balancing and node autoscaling. If setting up these components yourself, we recommend that you review the AWS instructions on the Elastic Load Balancing service.

Requirements

  • AWS account and user with the admin permissions

  • Access to the account with the Administrator or Deploy role and two‑factor authentication disabled in the Wallarm Console for the EU Cloud or US Cloud

Filtering node installation options

Since the filtering node operates as the web server or API gateway module, web server or API gateway packages should be installed on the operating system along with the filtering node packages.

You can select the web server or API gateway that is the most suitable for your application architecture from the following list:

Installing the filtering node as the NGINX Stable module

To install the filtering node as the NGINX Stable module in the Amazon EC2 instance:

  1. Create an Amazon EC2 instance from the operating system image supported by Wallarm following the AWS instructions:

    • Debian 10.x Buster
    • Ubuntu 18.04 Bionic
    • Ubuntu 20.04 Focal
    • CentOS 7.x
    • CentOS 8.x
    • Amazon Linux 2
  2. Connect to the created instance following the AWS instructions.

  3. In the instance, install the packages of NGINX Stable and Wallarm filtering node following the Wallarm instructions.

To install the postanalytics module in a separate instance, please repeat steps 1-2 and install the postanalytics module following the Wallarm instructions.

Installing the filtering node as the NGINX Plus module

To install the filtering node as the NGINX Plus module in the Amazon EC2 instance:

  1. Create an Amazon EC2 instance from the operating system image supported by Wallarm following the AWS instructions:

    • Debian 10.x Buster
    • Ubuntu 18.04 Bionic
    • Ubuntu 20.04 Focal
    • CentOS 7.x
    • CentOS 8.x
    • Amazon Linux 2
  2. Connect to the created instance following the AWS instructions.

  3. In the instance, install the packages of NGINX Plus and Wallarm filtering node following the Wallarm instructions.

To install the postanalytics module in a separate instance, please repeat steps 1-2 and install the postanalytics module following the Wallarm instructions.

Installing the filtering node as the Kong module

To install the filtering node as the Kong module in the Amazon EC2 instance:

  1. Create an Amazon EC2 instance from the operating system image supported by Wallarm following the AWS instructions:

    • Ubuntu 18.04 Bionic
    • CentOS 7.x
  2. Connect to the created instance following the AWS instructions.

  3. In the instance, install Kong of version 1.4.3 or lower following the Kong instructions.

  4. In the instance, install the packages of Wallarm filtering node following the Wallarm instructions.

To install the postanalytics module in a separate instance, please repeat steps 1-2 and install the postanalytics module following the Wallarm instructions.