Pulse/docs/PBS-AGENT.md

PBS Agent (Push Mode)

For PBS servers behind firewalls or in isolated networks that can't be reached by Pulse directly.

Installation

The PBS agent needs to be manually installed on your PBS server. Build from source or download from releases.

Configuration

Edit /etc/pulse-pbs-agent/config.json:

{
  "pulse_url": "http://your-pulse-server:7655",
  "api_key": "your-api-key-from-pulse-settings",
  "poll_interval": 30,
  "pbs_url": "https://localhost:8007",
  "pbs_username": "apiuser@pbs",
  "pbs_token_name": "pulse",
  "pbs_token_value": "uuid-from-pbs"
}

Start Agent

sudo systemctl enable --now pulse-pbs-agent
sudo systemctl status pulse-pbs-agent

Get API Key

In Pulse web UI: Settings → General → API Key → Generate

Create PBS Token

In PBS web UI:

1. Configuration → Access Control → API Tokens
2. Add Token
3. User: Choose user with Datastore.Audit permission
4. Copy token ID (username@pbs!tokenname) and secret

Verify

Check agent logs:

journalctl -u pulse-pbs-agent -f

In Pulse UI, PBS data should appear within 1 minute.

Uninstall

sudo systemctl stop pulse-pbs-agent
sudo systemctl disable pulse-pbs-agent
sudo rm -rf /etc/pulse-pbs-agent
sudo rm /usr/local/bin/pulse-pbs-agent
sudo rm /etc/systemd/system/pulse-pbs-agent.service