Troubleshooting System Verification Script
Description🔗
This script verifies the suitability of software and hardware for use with TFW. The list of checks includes:
- Kernel config
- Sysctl config
- RAM
- CPU flags
- Filesystem
- Kernel version
The script can be run as a standalone tool or as part of the TFW command-line. By default, it runs at Tempesta startup and displays system configuration issues.
Another feature is the ability to send information about the machine to the Tempesta Support Server. This data can be used by the TFW team to troubleshoot problems in case of an incident. It’s also possible to start Netconsole and connect it to the Troubleshooting Server.
The goal of Netconsole is to monitor crashes and bugs. All troubleshooting logs can be sent to TFW Support with proper Netconsole logging configuration.
./system_verification.py -nh=192.168.0.100 -nni=eth0 -th=192.168.0.101 -tm=00:00:00:00:00:00
Alternatively, you can configure environment variables for the Tempesta SystemD service. The full list of available parameters is:
| Name | ENV VAR | Short | Example | Description |
|---|---|---|---|---|
--netconsole-host |
TFW_NETCONSOLE_HOST | -nh |
192.168.0.100 | The IP address Netconsole will bind to |
--netconsole-port |
TFW_NETCONSOLE_PORT | -np |
5555 | The port Netconsole will bind to |
--netconsole-network-interface |
TFW_NETCONSOLE_NI | -nni |
eth0 | Network interface used by Netconsole |
--troubleshooting-host |
TFW_TROUBLESHOOTING_HOST | -th |
192.168.0.101 | IP address of the Troubleshooting Server |
--troubleshooting-port |
TFW_TROUBLESHOOTING_PORT | -tp |
5556 | Port of the Troubleshooting Server |
--troubleshooting-mac |
TFW_TROUBLESHOOTING_MAC | -tm |
aa:bb:cc:dd:ee:ff | MAC address of the Troubleshooting Server or NAT gateway |
In short, the Netconsole parameters describe the UDP socket binding settings, while the Troubleshooting parameters define the network location of the Troubleshooting Server.