Management Platform on exaviz encyclopedia

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

Accessing the Dashboard

Connect your computer or phone to the same network as your Exaviz board. Open a web browser and navigate to the board’s IP address:

https://<board-ip>

HTTPS Certificate Warning

The dashboard uses HTTPS with a self-signed certificate by default. Your browser will show a security warning on first visit. Click “Advanced” and “Proceed” (or equivalent) to continue. You can install your own certificate later. See Security and TLS for details.

PoE Port Management

Mon, 01 Jan 0001 00:00:00 +0000

PoE port tiles showing four ports on PSE 0. Port 3 (“Server Switch”) is delivering power with real-time metrics. Ports 0-2 are searching for devices.

Port Layout

PoE ports are displayed as tiles arranged to match the physical board layout:

Top row - Even-numbered ports (poe0, poe2, poe4, poe6)
Bottom row - Odd-numbered ports (poe1, poe3, poe5, poe7)

On Cruiser boards with 8 ports, there are two PSE controllers (PSE 0 and PSE 1), each managing 4 ports. The dashboard labels each section.

System Health

Mon, 01 Jan 0001 00:00:00 +0000

Health Metrics

The health bar shows CPU temperature, memory usage, load average, uptime, mDNS hostname, and total PoE power draw.

The dashboard displays a row of health cards below the board information panel:

Metric	What It Shows
CPU Temp	Current processor temperature in Celsius
Memory	RAM usage as a percentage (used / total)
Load	System load average (1-minute)
Uptime	Time since last reboot (days, hours, minutes)
mDNS	Board’s mDNS hostname for fleet discovery
PoE Draw	Total power being delivered across all PoE ports

These metrics update in real-time via the SSE connection (every 2 seconds).

Alerts

Mon, 01 Jan 0001 00:00:00 +0000

Alert Types

The management platform monitors board health and PoE port states, generating alerts when conditions need attention.

Alert Type	Trigger	Example
CPU temperature	Exceeds configured threshold	“CPU temperature 85C exceeds 80C threshold”
Memory usage	Exceeds configured percentage	“Memory usage 92% exceeds 90% threshold”
PoE fault	Port enters fault state	“Port 3 (Lobby Camera) entered fault state”

Viewing Alerts

Active alerts appear in two places:

Dashboard - An alerts section shows all unresolved alerts with severity, timestamp, and message
Fleet view - Fleet-wide alerts appear in the fleet status bar (e.g., “3 PoE faults across 2 boards”)

Each alert includes:

Fleet Management

Mon, 01 Jan 0001 00:00:00 +0000

Overview

Fleet management lets you monitor and control multiple Exaviz boards from a single dashboard. Boards on the same network discover each other automatically, and after a secure pairing process, you can view all your boards in one place.

How Discovery Works

Each board announces itself on the local network using mDNS (multicast DNS) on the _exaviz._tcp.local. service type. When you open the fleet view, any boards on the same network segment appear automatically in the discovery list.

Security and TLS

Mon, 01 Jan 0001 00:00:00 +0000

The management platform is penetration tested before every release. If your organization requires security evidence for procurement or compliance reviews, test reports are available on request.

Authentication

Password

The board uses a single shared password for dashboard and API access. On first boot, the default password is admin and must be changed before any features are accessible.

Password requirements:

Minimum 8 characters
Changing the password invalidates all active sessions (all users must log in again)

Sessions

Login returns a Bearer token valid for 24 hours
Tokens are invalidated on password change or logout
Login is rate-limited to 10 attempts per minute per IP address

Changing Your Password

Click Settings or the gear icon in the dashboard
Enter your current password
Enter and confirm your new password
Click Change Password

All existing sessions are invalidated. You will be redirected to the login page.

Backup and Restore

Mon, 01 Jan 0001 00:00:00 +0000

Creating a Backup

Export your board’s full configuration as a .tar.gz archive:

Open the dashboard settings
Click Download Backup

Or via the API:

curl -k -H "Authorization: Bearer <token>" \
 -o backup.tar.gz \
 https://<board-ip>/api/v1/system/backup

What’s Included

The backup contains everything in the board’s data directory (/var/lib/exaviz/):

Data	Description
Port labels	Custom names assigned to PoE ports
Port groups	Group definitions and port membership
Alert configuration	Threshold settings and alert history
Audit log	Complete history of all actions taken on the board
User preferences	Theme selection, view mode, fleet board order
Fleet trust state	Ed25519 key pair and list of trusted peers
TLS certificates	Current certificates and private keys
OEM branding	Branding configuration (if customized)

Restoring from a Backup

Upload a backup archive to restore a board’s configuration:

Advanced Features

Mon, 01 Jan 0001 00:00:00 +0000

Prometheus Metrics

The management platform exposes a Prometheus-compatible metrics endpoint at /metrics for integration with monitoring systems.

curl -k https://<board-ip>/metrics

Available Metrics

Category	Metrics
Board identity	Serial number, type, firmware version, board name
System health	CPU temperature, memory usage, uptime, load average
PoE ports	Total power draw, port count by state (delivering, searching, disabled, fault)
SSE clients	Number of connected dashboard sessions
Fleet	Total boards, online count
Go runtime	Goroutines, memory allocation, garbage collection

Grafana Integration

A pre-built Grafana dashboard is available for fleet-wide monitoring:

Troubleshooting

Mon, 01 Jan 0001 00:00:00 +0000

Cannot Access the Dashboard

Board IP not responding

Verify the board is powered on (check LEDs)
Confirm your computer is on the same network as the board
Try pinging the board: ping <board-ip>
If using the Cruiser’s DHCP server, check your router’s DHCP lease table for the board’s IP
Try connecting directly via Ethernet cable

Browser shows “connection refused”

The management service may not be running:

ssh user@<board-ip>
sudo systemctl status exaviz-mgmt
sudo journalctl -u exaviz-mgmt --no-pager -n 50

If the service is not running, start it: