Skip to main content

IoT Monitoring Device Overview

Integrated monitoring and management platform for your EDC.

⏱️ Time Required: 5 minutes (initial access) | 30 minutes (full configuration)


Overview

Your EDC includes an integrated IoT monitoring device for system management, monitoring, and automation:

IoT Device Specifications:

  • Hardware: Raspberry Pi 5 (8GB RAM)
  • Platform: Docker container-based system
  • Access: Local LAN web UI
  • Power: PoE from switch (connected to port 8)
  • Location: Integrated in EDC (exact location TBD)

[IMAGE: IoT device location and connections]

Key Features:

  • System dashboard and monitoring
  • Power monitoring (UPS/battery integration)
  • HCI cluster monitoring (Scale Computing support)
  • StorMagic witness hosting (HR01-2 edition)
  • Optional zero-trust agent support
  • Extensible via Docker containers

What the IoT Device Does

Primary Functions

1. Dashboard & Monitoring

  • Real-time EDC status display
  • Temperature monitoring
  • Power consumption tracking
  • Network status
  • Component health

2. UPS/Battery Integration

  • UPS monitoring via NUT (Network UPS Tools)
  • Connect to HiveRadar portable battery backups
  • Support for other UPS systems (may not be fully tested)
  • Automated shutdown coordination during power loss

3. HCI Cluster Monitoring

  • Monitor Scale Computing Hypercore HCI clusters
  • Currently supports: Scale Computing Hypercore
  • Dashboard widgets for cluster health
  • Storage and VM status tracking

4. StorMagic Witness (HR01-2 Edition)

  • Hosts StorMagic SvHCI witness service
  • Required for 2-node HCI configurations
  • Participates in quorum decisions
  • Does NOT store data (witness role only)

5. Switch & PDU Integration

  • Connects to EnGenius switch API
  • Connects to EnGenius PDU API
  • Display power and network metrics
  • Unified monitoring interface

6. Optional Services

  • Zero-trust agent container (optional)
  • Custom docker containers
  • Extensible platform for future features

[IMAGE: IoT dashboard screenshot showing various monitoring widgets]


Docker Container Architecture

The IoT device runs services as Docker containers for modularity and flexibility:

Container-Based Services:

1. Dashboard Container

  • Web UI for monitoring and management
  • Primary user interface
  • Real-time data visualization

2. UPS NUT Container

  • Network UPS Tools integration
  • Monitors connected UPS systems
  • Triggers automated shutdown sequences

3. StorMagic Witness Container (HR01-2 only)

  • Witness service for 2-node StorMagic clusters
  • Lightweight quorum participant
  • No data storage (witness only)

4. Zero-Trust Agent Container (optional)

  • Optional security agent
  • Depends on customer requirements
  • May not be included by default

5. Additional Containers (future/custom)

  • Platform supports additional containers
  • Custom monitoring or management tools
  • Expandable based on needs

Why containers?

  • Easy to add/remove services
  • Isolated environments for each function
  • Simple updates and management
  • Flexible and extensible

For Most Users: Initial Access

Accessing the IoT Web Interface

Default access information:

  • IP Address: TBD (will be documented in welcome letter)
  • Hostname: TBD (may support mDNS hostname)
  • Default credentials: TBD (will be in welcome letter)
  • Web interface: http://[ip-address]

To access:

  1. Connect laptop to EDC switch

    • Any available port (1-8)
    • Laptop should get IP address via DHCP (if enabled)
  2. Open web browser

    • Navigate to IoT device IP address
    • Example: http://192.168.1.x (exact IP TBD)
  3. Log in with default credentials

    • Username: TBD
    • Password: (provided in welcome letter)
  4. Dashboard loads

    • View EDC status and metrics
    • Access configuration options

[IMAGE: IoT login screen]


Initial Setup Required

The IoT device requires initial configuration before full functionality:

Setup Steps (General)

Note: Full workflow still being finalized. General steps:

  1. Change default password

    • For security, change from default password
    • Use strong password
    • Document new password securely
  2. Connect to switch and PDU APIs

    • Configure connection to EnGenius switch
    • Configure connection to EnGenius PDU
    • Enable power and network monitoring
  3. Connect to HCI cluster (if applicable)

    • Configure connection to Scale Computing Hypercore (if using Scale)
    • Enable cluster monitoring dashboard widgets
    • Currently supports Scale Computing only
  4. Configure UPS monitoring (if applicable)

    • Connect to UPS via NUT
    • Set battery low thresholds
    • Configure automated shutdown behavior
  5. Configure StorMagic witness (HR01-2 only)

    • Set up witness connection to StorMagic nodes
    • Verify witness participation in quorum
    • Required for 2-node StorMagic HCI
  6. Configure other services

    • Enable/disable optional containers
    • Set up additional monitoring
    • Customize dashboard

Detailed setup instructions: TBD (will be provided in welcome letter and IoT device documentation)


StorMagic Witness (HR01-2 Edition)

What is a Witness?

For HR01-2 edition with 2-node StorMagic SvHCI:

The witness is required for 2-node HCI configurations:

What it does:

  • Participates in quorum decisions
  • Breaks tie votes in cluster
  • Ensures data consistency
  • Critical for 2-node high-availability

What it does NOT do:

  • Does NOT store any customer data
  • Does NOT run VMs or applications
  • Lightweight service only

Why on the IoT device?

  • StorMagic witness is lightweight (perfect for Raspberry Pi 5)
  • Always available within EDC
  • No external witness server needed
  • Optimized configuration for EDC

[IMAGE: Diagram showing 2 HR-01 nodes + IoT witness forming StorMagic cluster]

Witness Configuration

Setup process:

  1. IoT device hosts witness container

    • Docker container runs witness service
    • Automatically configured (or minimal setup)
  2. StorMagic nodes connect to witness

    • Configure witness IP in StorMagic console
    • Both nodes communicate with witness
    • Witness participates in quorum
  3. Verify witness operation

    • Check witness status in StorMagic console
    • Ensure healthy quorum
    • Monitor witness connectivity

For detailed StorMagic witness setup:


UPS Monitoring and Automated Shutdown

Network UPS Tools (NUT) Integration

If using battery backup or UPS:

NUT container monitors UPS via network:

  1. Connect UPS to network (or via USB to IoT device)

    • HiveRadar portable battery backups supported
    • Other UPS may work (not all tested)
  2. Configure NUT to monitor UPS

    • Set UPS IP address or connection
    • Configure battery low thresholds
    • Test communication
  3. Configure automated shutdown

    • When battery reaches low threshold (e.g., 20%)
    • IoT device triggers graceful shutdown of:
      • HCI cluster (VMs shut down gracefully)
      • Compute nodes
      • Switch and PDU
    • Prevents data loss and corruption

[IMAGE: UPS monitoring dashboard widget]

For off-grid deployments:


Default Credentials & Welcome Letter

What's in the Welcome Letter?

Included with your EDC shipment:

Welcome letter contents:

  • Thank you note from HiveRadar
  • Link to this end-user manual
  • Link to IoT device section
  • Default IoT device credentials:
    • Default IP address
    • Default username
    • Default password
  • Quick start checklist
  • Support contact information
  • Possibly other deployment-specific information

⚠️ Keep the welcome letter secure! It contains default passwords.


Current Status & Development

Note: The IoT monitoring device is actively being developed.

Current status:

  • Hardware: Raspberry Pi 5 8GB (finalized)
  • Platform: Docker containers (finalized)
  • Access: Local LAN web UI (finalized)

Still being finalized:

  • Default IP addressing scheme
  • Default credentials
  • Full setup workflow steps
  • Dashboard UI details
  • Container configuration specifics
  • Some sensor specifications

When available:

  • Detailed setup guides will be added to this documentation
  • Welcome letter will include all access information
  • Screenshots and UI walkthroughs will be added

Future development:

  • Integrated touchscreen display (in development)
  • Additional monitoring capabilities
  • More HCI platform support (beyond Scale Computing)
  • Enhanced automation features

Troubleshooting

🔧 Can't access IoT web interface

Problem: Browser can't reach IoT device

Solutions:

  1. Check network connection:

    • Verify laptop connected to EDC switch
    • Check for link light on switch port
    • Try different switch port
  2. Verify IP address:

    • Check welcome letter for correct IP
    • IP may be different than expected
    • Try pinging IoT device IP
  3. Check IoT device power:

    • IoT device powered via PoE from switch port 8
    • Verify switch port 8 has link light
    • Check PoE enabled on port 8 (in switch interface)
  4. Check PoE power budget:

    • IoT device draws PoE power
    • If PoE budget exceeded, IoT may not power on
    • Check total PoE usage in switch interface
  5. Try direct connection:

    • Connect laptop directly to switch port 8
    • Set laptop static IP on same subnet
    • Try accessing IoT device
🔧 Default credentials not working

Problem: Can't log in with credentials from welcome letter

Possible causes:

  1. Credentials already changed:

    • Previous user or partner may have changed password
    • Contact whoever configured EDC before you
    • May need password reset
  2. Typing error:

    • Double-check username and password
    • Watch for case sensitivity
    • Copy/paste from welcome letter if possible
  3. Browser auto-fill issue:

    • Disable browser auto-fill
    • Try private/incognito mode
    • Clear browser cache
  4. Need password reset:

    • May require physical access to IoT device
    • Contact HiveRadar support for reset procedure
    • Or contact your reseller/partner
🔧 Dashboard shows no data or errors

Problem: Dashboard loads but shows blank widgets or errors

Solutions:

  1. Initial setup not complete:

    • Dashboard needs configuration to display data
    • Connect to switch/PDU APIs
    • Connect to HCI cluster (if applicable)
    • Configure monitoring sources
  2. Check API connections:

    • Verify switch IP and credentials configured
    • Verify PDU IP and credentials configured
    • Test connectivity from IoT device to switch/PDU
  3. Check HCI cluster connection:

    • If using Scale Computing: Verify cluster IP and credentials
    • Ensure network connectivity to cluster
    • Check firewall rules (if any)
  4. Docker containers not running:

    • Dashboard container may have stopped
    • May need to restart containers
    • Contact support if containers won't start

What's Next?

After understanding the IoT device basics:

👉 IoT Dashboard - Using the dashboard and widgets (TBD)

👉 IoT Firmware Updates - Updating containers and firmware (TBD)

👉 Network Configuration - Configure switch and PDU connections


Note: This page covers the overview and architecture of the IoT device. Detailed configuration guides and dashboard usage will be added as the IoT platform development is finalized.