Node Management¶
The Node Management page handles MAGK Node devices — the physical hardware used during events for objective capture, status tracking, and field interactions. From this page, manage firmware, configuration templates, device provisioning, and provisioning logs.
Firmware Management¶
Firmware List¶
The firmware list displays all uploaded firmware versions in a table.
| Column | Description |
|---|---|
| Version | Firmware version identifier |
| Filename | Original upload filename |
| Upload Date | When the firmware was uploaded |
| Size | File size |
| Status | Active or Archived |
Uploading Firmware¶
Click Upload Firmware to add a new firmware version.
| Field | Type | Required | Description |
|---|---|---|---|
| Version | Text | Yes | Semantic version identifier (e.g., 1.2.0) |
| File | File Upload | Yes | Firmware binary file |
| Release Notes | Textarea | No | Description of changes in this version |
After upload, the firmware is available for selection during device provisioning.
Configuration Templates¶
Configuration templates define the settings applied to nodes during provisioning. Templates allow you to configure multiple devices with consistent settings.
Template List¶
| Column | Description |
|---|---|
| Name | Template display name |
| Description | Brief description of the template's purpose |
| Created | Creation date |
| Last Modified | Most recent edit date |
| Devices | Number of nodes using this template |
Creating a Template¶
Click Create Template to define a new configuration template.
| Field | Type | Required | Description |
|---|---|---|---|
| Name | Text | Yes | Template name |
| Description | Textarea | No | Template purpose and notes |
| WiFi SSID | Text | No | Network SSID for the node to connect to |
| WiFi Password | Password | No | Network password |
| Server URL | Text | Yes | MAGK server URL the node reports to |
| UDP Port | Number | No | UDP communication port (default: 5683) |
| Report Interval | Number | No | Status report interval in seconds |
| LED Behavior | Select | No | LED indicator mode (standard, stealth, custom) |
Templates can be edited after creation. Changes apply to newly provisioned devices — already-provisioned devices retain their existing configuration until re-provisioned.
Device Provisioning¶
Provisioning assigns a firmware version and configuration template to a physical node device.
Provisioning Workflow¶
- Connect the node device to the provisioning network
- The device appears in the Unprovisioned Devices list
- Select the device and click Provision
- Choose a firmware version and configuration template
- Click Start Provisioning to begin the process
- Monitor progress in the provisioning status panel
Provisioning Status¶
| Status | Description |
|---|---|
| Pending | Device detected, awaiting provisioning |
| Configuring | Firmware and configuration being applied |
| Online | Device provisioned and communicating with the server |
| Error | Provisioning failed — check logs for details |
| Offline | Device was provisioned but is not currently communicating |
Provisioning Logs¶
The provisioning logs provide a detailed record of all provisioning operations.
| Column | Description |
|---|---|
| Timestamp | When the operation occurred |
| Device ID | Node device identifier |
| Action | Operation type (provision, re-provision, firmware update) |
| Status | Success or failure |
| Details | Additional context or error messages |
Use the date range filter and device ID search to find specific log entries. Logs are retained according to the platform's log retention policy.
Troubleshooting
If a device fails to provision, check the provisioning logs for error details. Common issues include network connectivity problems, incompatible firmware versions, and configuration template errors. See Troubleshooting for solutions.
Related Pages¶
- Dashboard — Node status summary widget
- Events — Nodes are used during active events
- Objectives — Nodes are placed at objective locations
- Infrastructure — Network and service health
- Logs — System-wide log viewer