🛡️ SeekRight RMM Agent — Client Deployment Guide

AnyDesk Remote Access Workflow

📋 Prerequisites (before you connect)

What you need	Where to get it
AnyDesk installed on your machine	anydesk.com
AnyDesk installed on the client machine	Ask client to install from anydesk.com
Client's AnyDesk ID / address	Ask client to share it with you
`deploy_agent.sh` file	In your workspace: `RMM-BE/rmm-backend/deploy_agent.sh`
Client ID to register with	Agreed upon name (e.g. `NH-8`, `BS-13`)

🔗 Step 1 — Connect to the Client via AnyDesk

Open AnyDesk on your machine.
Enter the client's AnyDesk ID in the address bar.
Click Connect → client approves the session.
Once inside: right-click the desktop or press Ctrl+Alt+T to open a Terminal.

Tip: Ask the client to set up unattended access in AnyDesk settings so you don't need them to approve each connection.

📤 Step 2 — Transfer the Deploy Script

Option A — AnyDesk File Transfer (easiest, recommended)

In AnyDesk, click the File Manager icon in the top toolbar.
Drag deploy_agent.sh from your machine to the client's Desktop or ~/Downloads.

Option B — Download directly on the client machine

curl -O http://rmm-backend.seekright.com/deploy_agent.sh
# OR if curl is not available:
wget http://rmm-backend.seekright.com/deploy_agent.sh

⚙️ Step 3 — Run the Deployment Script

In the client's terminal, navigate to where you placed the script and run it:

# Make the script executable (only needed the first time)
chmod +x deploy_agent.sh

# Run with the agreed Client ID (replace NH-8 with the actual ID)
sudo ./deploy_agent.sh NH-8

The script MUST be run with sudo — it installs a systemd service and writes to /opt/seekright-agent/.

What you'll see during deployment:

🚀 Preparing SeekRight RMM Agent installation...
📍 Target Client ID: NH-8
🌐 Central Server URL: http://rmm-backend.seekright.com
🔄 Updating system package indexes...
📁 Creating installation workspace...
📝 Generating client agent file...
⚙️ Configuring background systemd daemon service...
🔄 Reloading system daemons and starting agent service...

✨ ============================================= ✨
✅ SeekRight RMM Agent successfully deployed!
📍 Location: /opt/seekright-agent/client_agent_prototype.py
📋 System Service: seekright-agent.service
✨ ============================================= ✨

✅ Step 4 — Verify the Agent is Running

After deployment, the script shows live logs automatically. Confirm you see:

seekright-agent[XXXXX]: Starting Agent for NH-8...
seekright-agent[XXXXX]: [*] Telemetry pushed successfully.
seekright-agent[XXXXX]: [*] Checking for commands...
seekright-agent[XXXXX]:     -> No pending commands.

✅ Telemetry pushed successfully → agent is live and sending data.
❌ SyntaxError or exit-code → redeploy with the latest version of the script.

Press Ctrl+C to exit the log view. The agent continues running in the background as a system service.

🔍 Step 5 — Confirm in the RMM Dashboard

Open the SeekRight Pulse RMM dashboard in your browser.
Within ~30 seconds the new client node appears with a 🟢 Online status.
Verify that disk drives, CPU, and memory telemetry are loading correctly.

🛠️ Useful Troubleshooting Commands (run on the client machine)

Task	Command
Check agent status	`sudo systemctl status seekright-agent`
View live logs	`sudo journalctl -u seekright-agent -f`
Restart the agent	`sudo systemctl restart seekright-agent`
Stop the agent	`sudo systemctl stop seekright-agent`
View installed agent file	`cat /opt/seekright-agent/client_agent_prototype.py`
Re-run full deployment	`sudo ./deploy_agent.sh <CLIENT_ID>`

🆔 Client ID Naming Convention

Use a consistent, short identifier. No spaces.

✅ Good	❌ Avoid
`NH-8`	`New HP Workstation 8`
`BS-13`	`bs 13 machine`
`SHOWROOM-PC-01`	`showroom pc`

If no Client ID is provided, the script defaults to the machine's hostname (e.g. nh8gglamsrv01).

🔄 Re-deploying / Updating the Agent

Whenever you push a bug fix or new version of deploy_agent.sh, simply re-run on the client:

sudo ./deploy_agent.sh NH-8

The script is idempotent — safely overwrites the previous installation and restarts the service.

SeekRight Pulse RMM · Internal Documentation · v1.0

4.6 KiB Raw Blame History