Install from packages

Ubuntu 22.04 is the only officially supported Linux distribution for the moment. Prebuilt packages are available for both patched kernel and Tempesta FW. Kernel package is build with patches from Ubuntu maintainers and kernel configuration.

Since Tempesta FW is implemented as in-kernel module and it is under development, issues in it can affect stability of the kernel and may lead to a kernel crush. As a solution kdump is set as dependency for Tempesta FW. It allows to save crash dump information to /var/crash/%Date% and reboot system after the crash. It is highly recommended to enable kdump during install of kdump-tools package. kdump requires system reboot after installation.

Using Installer script

Installer script allows to install latest Tempesta FW release by single command. It installs all the required packages, downloads latest Tempesta FW and patched kernel releases (~50MB) to the working directory into tfw_downloads directory and installs them.

Run the next commands to automatically install or update Tempesta FW:

wget https://raw.githubusercontent.com/tempesta-tech/tempesta/master/pkg/scripts/tempesta_installer.sh
chmod +x tempesta_installer.sh
sudo ./tempesta_installer.sh --install

Once installation is completed reboot to a freshly installed kernel is required. Choose entry Ubuntu, with Linux 5.10.35+ in Advanced options for Ubuntu submenu to load the patched kernel. See section Running Tempesta FW for further instructions.

The same script can be used to remove Tempesta FW. --remove option will hold configuration file on server, while --purge completely removes Tempesta FW and all configuration files:

sudo ./tempesta_installer.sh --remove
sudo ./tempesta_installer.sh --purge

Running Tempesta FW

First, reboot to tempesta-patched kernel.

Then, edit Tempesta FW configuration file:

sudo vim /etc/tempesta/tempesta_fw.conf

More information about configuration is available in Readme.

Finally, systemd unit files can be used for convenient management of Tempesta FW. To start and stop Tempesta FW use the next commands:

systemctl start tempesta-fw
systemctl stop tempesta-fw

To add or remove Tempesta FW from bootup process, use:

systemctl enable tempesta-fw
systemctl disable tempesta-fw

See also Run & stop for more systemd calls.