Backup Server Setup

The macOS agent supports multiple backup servers for event transmission and updates. If the primary server goes down, the agent will automatically switch to a backup. If that one is also unavailable, it moves to the next in line.

You can set up backup servers in two ways:

  • Via terminal

  • Manually in the configuration file

If you need a quick solution, use the terminal. If you prefer manual control over settings, edit the configuration file.

Terminal Setup

  1. To add backup servers, run the command:

sudo /Library/Application\ Support/.AtomSec/StaffAgent.app/Contents/MacOS/StaffAgent add_servers 1.1.1.1 555 https://2.2.2.2:888

This example adds two backup servers:

  • 1.1.1.1 on port 555

  • 2.2.2.2 om port 888.

  1. Once added, restart the agent to apply the changes:

sudo /Library/Application\ Support/.AtomSec/StaffAgent.app/Contents/MacOS/StaffAgent restart

Manual Setup

  1. Open the configuration file at /Library/Caches/com.atomsec.staff/config.

  2. Add the new server address and port:

server2 = 1.1.1.1
port2 = 555

  1. To set 1.1.1.1 (port 555) as the primary server, use this command:

sudo /Library/Application\ Support/.AtomSec/StaffAgent.app/Contents/MacOS/StaffAgent 1.1.1.1 555 restart