General Linux agent service troubleshooting tips
Use these tips if you encounter initialization errors, application errors, or application crashes.
Stopping the agent service
Procedure
Starting the agent service
Procedure
Restarting the agent service
Procedure
Reset the agent failure counter
Procedure
sudo systemctl reset-failed keeperx
Viewing the status of the agent
Procedure
Inspecting the service logs for error details
Procedure
Sending service logs to Customer Support
Procedure
Cleaning up the Falco drivers
Procedure
sudo /etc/reaqtahive.d/keeperx-loader.sh --clean-only
Installing the agent when kernel module signing is set to
recommended
When the agent is installed on a Linux system that uses
kernel modules rather than an eBPF probe, it includes an unsigned Falco kernel module. The Falco
kernel module does not load if kernel module signing is set to recommended
and the
kernel version is 3.7 or later. You can force the module to load in this case.
Procedure
Installing the agent on cloned endpoints
If you install the agent on an endpoint, and then clone that endpoint, more than one endpoint has the same machine-id in QRadar® EDR. You can fix this issue by removing the /etc/reaqta-hive-machine-id file before cloning the endpoint, or by installing the agent without registering the endpoint.
Removing the /etc/reaqta-hive-machine-id file before cloning the endpoint
Procedure
- Install the agent on the endpoint that you will clone by following the instructions in Installing the QRadar EDR Agent on Linux endpoints.
- Remove the /etc/reaqta-hive-machine-id file.
- Uninstall the agent from the endpoint by following the instructions in Uninstalling the QRadar EDR Agent from an endpoint remotely.
- Clone the endpoint. An endpoint that you create by cloning automatically register in QRadar EDR Dashboard if it has an internet connection.
Installing the agent without registering the endpoint
Procedure
High resource consumption
Requires Linux agent 0.70.0 or later
Use these tips if you encounter high CPU, RAM, or disk space consumption.