sync: auto-sync from HOWARD-HOME at 2026-07-21 13:14:31

Author: Howard Enos
Machine: HOWARD-HOME
Timestamp: 2026-07-21 13:14:31

clients/ironwood-pig-sanctuary/session-logs/2026-07/2026-07-21-howard-onboarding-rmm-diag.md

@@ -0,0 +1,99 @@
+# Ironwood Pig Sanctuary - RMM Onboarding + Diagnostic Attempt
+
+## User
+- **User:** Howard Enos (howard)
+- **Machine:** Howard-Home
+- **Role:** tech
+
+## Session Summary
+
+Howard brought a new client machine (DESKTOP-1NIIDOT, Dell Inspiron 3670, i3-8100, 8GB RAM, Win 11 Home) for Ironwood Pig Sanctuary. The machine was already in ScreenConnect tagged under "Ironwood Pig Sanctuarty" (typo in SC -- missing 'u' in Sanctuary).
+
+Onboarded Ironwood Pig Sanctuary as a new client in GuruRMM: created the client record and a "Main" site (site code BRONZE-TIGER-1901). The one-time enrollment API key was captured and vaulted at `clients/ironwood-pig-sanctuary/gururmm-site-main.sops.yaml`, committed and pushed to the vault repo.
+
+Pushed the GuruRMM agent installer to DESKTOP-1NIIDOT via ScreenConnect `send-command`. The agent enrolled successfully and appeared in the RMM fleet list. However, the agent was not maintaining its WebSocket connection -- all dispatched commands queued as `pending` with `is_connected=null`. The onboarding diagnostic probe failed on the first chunk upload (stayed pending). A simple test command (`hostname; Get-Date`) also stayed pending indefinitely.
+
+Howard indicated the client will be dropping the machine off for an HDD-to-SSD clone/replacement. All pending commands were cancelled. The onboarding diagnostic will be re-run after the hardware swap when the machine is back online and the agent is actively connected.
+
+## Key Decisions
+
+- Created the RMM client as "Ironwood Pig Sanctuary" (correcting the SC typo "Sanctuarty") for the canonical name in GuruRMM.
+- Vaulted the enrollment key immediately after site creation -- the API key is shown only once in the create response.
+- Cancelled all pending RMM commands rather than leaving them queued, since the machine is going offline for hardware work and commands would execute in an unknown state on reconnect.
+
+## Problems Encountered
+
+- **Agent enrolled but not connecting:** The GuruRMM agent registered in the fleet (appeared in `GET /api/agents`) but never established a live WebSocket connection (`is_connected=null`). All commands stayed `pending`. Likely caused by the machine being rebooted shortly after install, before the agent fully initialized. The SSD swap will require a re-check of the agent service after the clone.
+- **SC API output limitation:** ScreenConnect's API does not return command output -- `send-command` queues the command but results are only visible in the SC console UI. This prevented remote troubleshooting of the agent connectivity issue through the API alone.
+
+## Configuration Changes
+
+- **Created:** `clients/ironwood-pig-sanctuary/gururmm-site-main.sops.yaml` (vault) -- RMM enrollment credentials
+- **Created:** Ironwood Pig Sanctuary client in GuruRMM (id: `c2efbc46-6e30-4ae8-b335-b54fe9d51db1`)
+- **Created:** Main site in GuruRMM (id: `50668805-3428-4b01-b3c2-3f4ed2c96da7`, code: `BRONZE-TIGER-1901`)
+
+## Credentials & Secrets
+
+- **GuruRMM site enrollment key:** vaulted at `clients/ironwood-pig-sanctuary/gururmm-site-main.sops.yaml`
+  - client_id: `c2efbc46-6e30-4ae8-b335-b54fe9d51db1`
+  - site_id: `50668805-3428-4b01-b3c2-3f4ed2c96da7`
+  - site_code: `BRONZE-TIGER-1901`
+  - api_key: `grmm_kGWKIUPrvOy4ruB7EHwEXOPXOm33x1pq`
+  - installer_url: `https://rmm.azcomputerguru.com/install/BRONZE-TIGER-1901`
+
+## Infrastructure & Servers
+
+- **DESKTOP-1NIIDOT** (Ironwood Pig Sanctuary)
+  - Dell Inspiron 3670, Serial: H7MFR33
+  - Intel i3-8100 @ 3.60GHz, 8GB RAM
+  - Windows 11 Home 10.0.26200
+  - LAN IP: 192.168.0.103, WAN IP: 76.159.202.97
+  - MAC: 70:B5:E8:21:E2:78
+  - Timezone: UTC-7 (Arizona)
+  - Logged-on user: benwa
+  - SC session: `b6fb1a9a-3994-4d76-be11-cfb84425bbfa`
+  - RMM agent: `a98b0cf4-1d40-4181-afa7-b764f2c317e8`
+
+## Commands & Outputs
+
+```
+# SC session lookup
+$SC sessions --like "1NIIDOT"
+-> 1 session found, CP1="Ironwood Pig Sanctuarty"
+
+# RMM client create
+POST /api/clients {"name":"Ironwood Pig Sanctuary"}
+-> id=c2efbc46-6e30-4ae8-b335-b54fe9d51db1
+
+# RMM site create
+POST /api/sites {"client_id":"...","name":"Main"}
+-> site_code=BRONZE-TIGER-1901, api_key=grmm_kGWKIUPrvOy4ruB7EHwEXOPXOm33x1pq
+
+# Agent push via SC
+$SC send-command --session <id> --command "powershell ... iex (irm '.../install/BRONZE-TIGER-1901/windows')" --confirm
+-> {} (queued)
+
+# Agent appeared in RMM after ~25s
+rmm-search.sh 1NIIDOT -> DESKTOP-1NIIDOT, online, id=a98b0cf4...
+
+# Test command stayed pending
+POST /api/agents/<id>/command {"command_type":"powershell","command":"hostname; Get-Date"}
+-> status=pending (agent offline per WebSocket)
+
+# Cancelled pending commands
+POST /api/commands/<id>/cancel -> cancelled x2
+```
+
+## Pending / Incomplete Tasks
+
+- **Run onboarding diagnostic** on DESKTOP-1NIIDOT after the HDD-to-SSD swap is complete and the agent is actively connecting. Use: `bash .claude/scripts/run-onboarding-diagnostic.sh DESKTOP-1NIIDOT ironwood-pig-sanctuary`
+- **Verify agent connectivity** post-swap: confirm `GuruRMMAgent` service is running and WebSocket is connected (`is_connected=true`).
+- **Fix SC typo:** CP1 on the SC session reads "Ironwood Pig Sanctuarty" -- should be corrected to "Ironwood Pig Sanctuary" via `$SC set-properties`.
+- **Hardware swap:** Client dropping off machine for HDD-to-SSD clone. After clone, agent should persist but connectivity needs verification.
+
+## Reference Information
+
+- SC instance: `https://computerguru.screenconnect.com`
+- RMM server: `http://172.16.3.30:3001`
+- Vault path: `clients/ironwood-pig-sanctuary/gururmm-site-main.sops.yaml`
+- Bot alert posted: `[RMM] Howard onboarded client 'Ironwood Pig Sanctuary'...` (msg id: 1529176432587309157)