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:
-
Connect laptop to EDC switch
- Any available port (1-8)
- Laptop should get IP address via DHCP (if enabled)
-
Open web browser
- Navigate to IoT device IP address
- Example:
http://192.168.1.x(exact IP TBD)
-
Log in with default credentials
- Username: TBD
- Password: (provided in welcome letter)
-
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:
-
Change default password
- For security, change from default password
- Use strong password
- Document new password securely
-
Connect to switch and PDU APIs
- Configure connection to EnGenius switch
- Configure connection to EnGenius PDU
- Enable power and network monitoring
-
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
-
Configure UPS monitoring (if applicable)
- Connect to UPS via NUT
- Set battery low thresholds
- Configure automated shutdown behavior
-
Configure StorMagic witness (HR01-2 only)
- Set up witness connection to StorMagic nodes
- Verify witness participation in quorum
- Required for 2-node StorMagic HCI
-
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:
-
IoT device hosts witness container
- Docker container runs witness service
- Automatically configured (or minimal setup)
-
StorMagic nodes connect to witness
- Configure witness IP in StorMagic console
- Both nodes communicate with witness
- Witness participates in quorum
-
Verify witness operation
- Check witness status in StorMagic console
- Ensure healthy quorum
- Monitor witness connectivity
For detailed StorMagic witness setup:
- See StorMagic documentation
- Or HCI Software section when available
UPS Monitoring and Automated Shutdown
Network UPS Tools (NUT) Integration
If using battery backup or UPS:
NUT container monitors UPS via network:
-
Connect UPS to network (or via USB to IoT device)
- HiveRadar portable battery backups supported
- Other UPS may work (not all tested)
-
Configure NUT to monitor UPS
- Set UPS IP address or connection
- Configure battery low thresholds
- Test communication
-
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:
-
Check network connection:
- Verify laptop connected to EDC switch
- Check for link light on switch port
- Try different switch port
-
Verify IP address:
- Check welcome letter for correct IP
- IP may be different than expected
- Try pinging IoT device IP
-
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)
-
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
-
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:
-
Credentials already changed:
- Previous user or partner may have changed password
- Contact whoever configured EDC before you
- May need password reset
-
Typing error:
- Double-check username and password
- Watch for case sensitivity
- Copy/paste from welcome letter if possible
-
Browser auto-fill issue:
- Disable browser auto-fill
- Try private/incognito mode
- Clear browser cache
-
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:
-
Initial setup not complete:
- Dashboard needs configuration to display data
- Connect to switch/PDU APIs
- Connect to HCI cluster (if applicable)
- Configure monitoring sources
-
Check API connections:
- Verify switch IP and credentials configured
- Verify PDU IP and credentials configured
- Test connectivity from IoT device to switch/PDU
-
Check HCI cluster connection:
- If using Scale Computing: Verify cluster IP and credentials
- Ensure network connectivity to cluster
- Check firewall rules (if any)
-
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.