Add docs and project files - force for Culurien

2026-03-28 20:46:24 -04:00
parent dc61797423
commit 484a7f77ce
343 changed files with 119530 additions and 0 deletions
--- a/docs/4_LOG/November_2025/implementation/Migrationtesting.md
+++ b/docs/4_LOG/November_2025/implementation/Migrationtesting.md
@@ -0,0 +1,98 @@
+# RedFlag Agent Migration Testing - v0.1.23 → v0.1.23.5
+
+## Test Environment
+- **Agent ID**: 2392dd78-70cf-49f7-b40e-673cf3afb944
+- **Previous Version**: 0.1.23
+- **New Version**: 0.1.23.5
+- **Platform**: Fedora Linux
+- **Migration Path**: In-place binary upgrade
+
+## Migration Results
+
+### ✅ SUCCESSFUL MIGRATION
+
+**1. Agent Version Update**
+- Agent successfully updated from v0.1.23 to v0.1.23.5
+- No re-registration required
+- Agent ID preserved: `2392dd78-70cf-49f7-b40e-673cf3afb944`
+
+**2. Token Preservation**
+- Access token automatically renewed using refresh token
+- Agent ID maintained during token renewal: "✅ Access token renewed successfully - agent ID maintained: 2392dddd78-70cf-49f7-b40e-673cf3afb944"
+- No credential loss during migration
+
+**3. Configuration Migration**
+- Config version updated successfully
+- Server configuration sync working: "📡 Server config update detected (version: 1762959150)"
+- Subsystem configurations applied:
+  - storage: 15 minutes
+  - system: 30 minutes → 5 minutes (after heartbeat)
+  - updates: 15 minutes
+
+**4. Heartbeat/Rapid Polling**
+- Heartbeat enable command received and processed successfully
+- Rapid polling activated for 30 minutes
+- Immediate check-in sent to update server status
+- Pending acknowledgments tracked and confirmed
+
+**5. Command Acknowledgment System**
+- Command acknowledgments working correctly
+- Pending acknowledgments persisted across restarts
+- Server confirmed receipt: "Server acknowledged 1 command result(s)"
+
+## Log Analysis
+
+### Key Events Timeline
+
+```
+09:52:30 - Agent check-in, token renewal
+09:52:30 - Server config update detected (v1762959150)
+09:52:30 - Subsystem intervals applied:
+           - storage: 15 minutes
+           - system: 30 minutes
+           - updates: 15 minutes
+
+09:57:52 - System information update
+09:57:54 - Heartbeat enable command received
+09:57:54 - Rapid polling activated (30 minutes)
+09:57:54 - Server config update detected (v1762959474)
+09:57:54 - System interval changed to 5 minutes
+
+09:58:09 - Command acknowledgment confirmed
+09:58:09 - Check-in with pending acknowledgment
+09:58:09 - Server acknowledged command result
+```
+
+## Issues Identified
+
+### 🔍 Potential Issue: Scanner Interval Application
+
+**Observation**: User changed "all agent_scanners toggles to 5 minutes" on server, but logs show different intervals being applied:
+- storage: 15 minutes
+- system: 30 minutes → 5 minutes (after heartbeat)
+- updates: 15 minutes
+
+**Expected**: All scanners should be 5 minutes
+
+**Possible Causes**:
+1. Server not sending 5-minute intervals for all subsystems
+2. Agent not correctly applying intervals from server config
+3. Only "system" subsystem responding to interval changes
+
+**Investigation Needed**:
+- Check server-side agent scanner configuration
+- Verify all subsystem intervals in server database
+- Review `syncServerConfig` function in agent main.go
+
+## Conclusion
+
+**Migration Status**: ✅ **SUCCESSFUL**
+
+The migration from v0.1.23 to v0.1.23.5 worked perfectly:
+- Tokens preserved
+- Agent ID maintained
+- Configuration migrated
+- Heartbeat system functional
+- Command acknowledgment working
+
+**Remaining Issue**: Scanner interval configuration may not be applying uniformly across all subsystems. Requires investigation of server-side scanner settings and agent config sync logic.