Basic Administration

Requirements🔗

Ubuntu Server 24.04.3 LTS (or later). Development and testing are performed on the Ubuntu Server kernel. Other variants (for example, Desktop installations or HWE kernels) are not part of the supported development environment and may fail to load the project’s XDP/eBPF programs.
Linux kernel 6.8 (Ubuntu 24.04.2 ships with 6.8.0-57) with the following kernel configuration options enabled:
```
CONFIG_DEBUG_INFO_BTF=y
CONFIG_BPF_SYSCALL=y
CONFIG_BPF_JIT=y
CONFIG_HAVE_EBPF_JIT=y
CONFIG_SYN_COOKIES=y
```
ClickHouse 21.1 or later (required for observability), here you can find ClickHouse installation instructions.

To verify these requirements automatically, run:

sudo /opt/tempesta/bin/xfwctl --check-req

The following Ubuntu packages are required to install Tempesta Escudo:

apt install -y clang libboost-all-dev flatbuffers-compiler libflatbuffers-dev \
               libprotobuf-dev libgrpc++-dev linux-tools-common libspdlog-dev \
               libmaxminddb-dev libbpf-dev libbpf-tools libgtest-dev

Installation🔗

Download the Escudo package for Ubuntu.

Install the package:

dpkg -i tempesta-escudo_1.0.0_amd64.deb

Run & Stop🔗

# systemctl start tempesta-escudo

# systemctl stop tempesta-escudo