General Linux agent service troubleshooting tips

Use these tips if you encounter initialization errors, application errors, or application crashes.

Important: Stop the agent service before you run any other agent commands.

Stopping the agent service

Procedure

  • On a system that uses systemd, type the following command.
    sudo systemctl stop keeperx
  • Requires Linux® agent 0.70.0 or later On a system that uses init, type the following command.
    sudo service keeperx stop

Starting the agent service

Procedure

  • On a system that uses systemd, type the following command.
    sudo systemctl start keeperx
  • Requires Linux agent 0.70.0 or later On a system that uses init, type the following command.
    sudo service keeperx start

Restarting the agent service

Procedure

  • On a system that uses systemd, type the following command.
    sudo systemctl restart keeperx
  • Requires Linux agent 0.70.0 or later On a system that uses init, type the following command.
    sudo service keeperx restart

Reset the agent failure counter

Procedure

On a system that uses systemd, type the following command.
sudo systemctl reset-failed keeperx

Viewing the status of the agent

Procedure

  • On a system that uses systemd, type the following command.
    sudo systemctl status keeperx
  • Requires Linux agent 0.70.0 or later On a system that uses init, type the following command.
    sudo service keeperx status

Inspecting the service logs for error details

Procedure

  • On a system that uses systemd, type the following command.
    journalctl –xu keeperx
  • Requires Linux agent 0.70.0 or later On a system that uses init, type the following command.
    cat /tmp/rqt_keeperx.txt

Sending service logs to Customer Support

Procedure

  1. Gather the service logs in a .txt file.
    • On a system that uses systemd, type the following command to export the agent systemd service logs to a .txt file.
      journalctl –xu keeperx > /tmp/agent_logs.txt
    • Requires Linux agent 0.70.0 or later On a system that uses init, the service logs are stored in the /tmp/rqt_keeperx.txt file.
  2. Go to Customer Support (www.ibm.com/support/) and add the service logs to a new or existing case.

Cleaning up the Falco drivers

Procedure

Clean up the Falco drivers by typing the following command.
sudo /etc/reaqtahive.d/keeperx-loader.sh --clean-only

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

  1. Install the agent on the endpoint that you will clone by following the instructions in Installing the QRadar EDR Agent on Linux endpoints.
  2. Remove the /etc/reaqta-hive-machine-id file.
  3. Uninstall the agent from the endpoint by following the instructions in Uninstalling the QRadar EDR Agent from an endpoint remotely.
  4. 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

  1. Install the agent on the endpoint that you will clone by following the instructions in Installing the QRadar EDR Agent on Linux endpoints. Make sure you use the command to install the agent without registering the endpoint.
  2. Clone the endpoint.
  3. On the endpoints that you create by cloning, register the endpoint, then restart the agent service.
    1. Register the endpoint by typing the following command.
      Table 1. QRadar EDR Dashboard parameters
      Parameter Description
      URL Your QRadar EDR server domain name or IP address, including the port.
      Group IDs A comma-separated list of group IDs. At least one group ID is required in MSSP deployments.
      Proxy If you are using a proxy to access QRadar EDR Dashboard, enter the proxy URL and port. It must be a nonauthenticated proxy.
      sudo /etc/reaqtahive.d/keeperx --register "https://<URL> --gids <group_IDs> --proxy <proxy_URI>"
    2. Restart the agent service by typing one of the following commands.
      • On a system that uses systemd, type the following command.
        sudo systemctl restart keeperx
      • On a system that uses init, type the following command.
        sudo service keeperx restart

High resource consumption

Requires Linux agent 0.70.0 or later

Use these tips if you encounter high CPU, RAM, or disk space consumption.