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 libxxhash-dev \
libbenchmark-dev
RSS and network IRQ affinity🔗
Correct RSS and network IRQ affinity configuration is required for good performance
and correct operation of features using per-CPU state, such as TCP SYN Drop.
RSS must consistently direct packets from each connection to the same receive queue,
and that queue’s IRQ must remain assigned to the same CPU. xFW configures IRQ affinity
automatically by default. If you set "auto-irq-affinity": false in xfw.json, configure it manually.
Installation🔗
-
Download a Tempesta xFW release 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