How to check whether the Safenix agent is working

Check the dashboard first: it shows the overall Safenix status for each server. Then verify the service and recent backup activity on the server.

1. Check the server status in the dashboard

Each server has a status label. The possible values are:

• Protected: the latest backup was completed within the account objective. Files and the database are evaluated separately, and the worse result determines the label.
• Waiting for first backup: the server is registered but has not completed a backup yet.
• Not restorable — no full backup: data is arriving, but there is no full copy from which to start a restore.
• Database not backed up: a database is configured but has never been copied.
• Backup overdue: the server has not completed a backup within the expected objective.
• Disconnected: the server has been disconnected and is no longer uploading.

The dashboard also shows the size of the protected data, the time of the latest file and database backups, and the number of available restore points. A completed backup appears in the dashboard within a few seconds.

2. Confirm that the agent service is running

On the server, run the following command as root:

systemctl status safenix-agent

This confirms whether the agent service is running. It does not, by itself, confirm that backups are reaching storage.

3. Watch the agent activity

To see what the agent is doing in real time, run:

journalctl -u safenix-agent -f

The log lines are in JSON format. They report each backup that starts and completes, including its size and duration.

4. Confirm that restore points are arriving

To verify that backups have reached storage, rather than only confirming that the service is running, run:

safenix-agent snapshots

This command queries storage and lists the available restore points. It requires a recovery credential issued by the dashboard. The token used by the agent to upload backups can only write and cannot be used for this check.

5. Check database protection separately

For database protection, run:

safenix-agent check-mysql

This check reports whether the database configuration is correct and whether a restore would be applicable with the current permissions.

There is no single agent status command that summarizes all of these checks. Use the dashboard for the overall status, and use the server commands to inspect the service, activity, restore points, and database protection separately.