Diagnostic Health Check Tool¶

Section: Operations | Article 63
Audience: System Administrators
Last Updated: 2026-04-08

Overview¶

The RP-PAM diagnostic tool runs a comprehensive health check of all system components and reports pass/warning/fail for each. Use it to:

Verify installation — runs automatically at the end of the Setup Wizard
Troubleshoot issues — before opening a support ticket, run diagnostics and include the report
Routine monitoring — schedule periodic health checks to catch problems early

The tool ships with the RP-PAM installer. No additional installation required.

Running Diagnostics¶

Windows GUI: Launch from the Start Menu → RP-PAM Health Check. Visual green/red display for each check. Also runs automatically at the end of the Setup Wizard.

Windows (PowerShell):

rppam-diag

Linux:

sudo /opt/rppam/tools/rppam-diag

JSON output (for support tickets or automation):

rppam-diag --json > diagnostic-report.json

What It Checks¶

Check	What It Tests	Pass	Warning	Fail
RP-PAM gRPC (7100)	Service port reachable	Port responds	—	Port unreachable
RP-PAM REST (7101)	API port reachable	Port responds	—	Port unreachable
RP-PAM Mgmt (7102)	Management port reachable	Port responds	—	Port unreachable
Database	Connection string configured, DB reachable	Connected	—	No connection
Redis	Redis reachable (HA only)	Connected	—	Unreachable
LVS	License check-in endpoint reachable	Healthy	Non-200 response	Unreachable
Encryption Keys	CEK/KEK files exist in key directory	Keys found	—	No keys found
guacd	Browser session daemon binary exists	Binary found	Binary missing	—
guacd Port (4822)	guacd process listening	Port responds	—	Not listening
Recording Storage	Disk space on recording drive	>10 GB free	<10 GB	<1 GB
Backup Storage	Disk space on backup drive	>10 GB free	<10 GB	<1 GB
Certificates	TLS certificate files present	Certs found	No certs	—

Example Output¶

╔══════════════════════════════════════════════════════════╗
║              RP-PAM Health Check Diagnostic             ║
╚══════════════════════════════════════════════════════════╝

  Node:     node1
  Host:     PAM-SERVER-01
  Platform: Windows
  Time:     2026-04-08 14:30:00 UTC

  [PASS]  RP-PAM gRPC (7100)        127.0.0.1:7100 reachable
  [PASS]  RP-PAM REST API (7101)    127.0.0.1:7101 reachable
  [PASS]  RP-PAM Management (7102)  127.0.0.1:7102 reachable
  [PASS]  Database                   mssql connection string configured (142 chars)
  [PASS]  Redis                      redis.corp.local:6379 reachable
  [PASS]  LVS                        LVS healthy at https://lvs.ravenphyre.net
  [PASS]  Encryption Keys            3 key file(s) found
  [PASS]  guacd                      Binary found at C:\Program Files\Ravenphyre\RP-PAM\bin\guacd.exe
  [PASS]  guacd (4822)              127.0.0.1:4822 reachable
  [PASS]  Recording Storage          D:\RpPamRecordings — 89 GB free
  [WARN]  Backup Storage             C:\ProgramData\...\Backups — 8 GB free (low)
  [PASS]  Certificates               2 certificate file(s) found

  ────────────────────────────────────────────────────
  Overall: WARNING  (11 pass, 1 warn, 0 fail)

  Warnings detected: review WARN items. System is functional.

Including Diagnostics in Support Tickets¶

When contacting Ravenphyre support, include the JSON diagnostic report:

rppam-diag --json > diagnostic-report.json

Attach diagnostic-report.json to your support ticket. This helps the support team immediately identify which components are affected.

Next Steps¶

Log Collection — Collect logs for support tickets
General Troubleshooting — Common issues and solutions
Support Contact — How to reach Ravenphyre support