diff --git a/docs/00-CURRENT-STATE.md b/docs/00-CURRENT-STATE.md index cf6a095..e9d11a4 100644 --- a/docs/00-CURRENT-STATE.md +++ b/docs/00-CURRENT-STATE.md @@ -29,6 +29,14 @@ - `docker-bridge` - Container network (172.17.0.1/24) - `back-to-home-vpn` - WireGuard VPN (192.168.216.1/24) + +**SNMP Configuration:** +| Device | Community | Access | Status | +|--------|-----------|--------|--------| +| hAP ax³ | `netdisco` | 192.168.31.2 only | Enabled | +| CSS326 | `public` | Any (SwOS limit) | Enabled | +| cAP ac | `netdisco` | 192.168.31.2 only | Enabled | + **Running Containers on MikroTik:** | Container | IP | Purpose | |-----------|-----|---------| diff --git a/docs/07-CHANGELOG.md b/docs/07-CHANGELOG.md index 6c1a146..cc41056 100644 --- a/docs/07-CHANGELOG.md +++ b/docs/07-CHANGELOG.md @@ -1,4 +1,30 @@ # Infrastructure Changelog +## 2026-01-19 - SNMP Configuration for NetDisco + +### Task 8.1: Enable SNMP on MikroTik Devices - COMPLETED + +**hAP ax³ (192.168.31.1):** +- [SNMP] Enabled SNMPv2c +- [SNMP] Added `netdisco` community (192.168.31.2 only) +- [SNMP] Restricted `public` community to 192.168.31.2 +- [SNMP] Contact: admin@xtrm-lab.org, Location: XTRM Home Lab + +**cAP ac (192.168.31.6):** +- [SNMP] Enabled SNMPv2c via REST API +- [SNMP] Added `netdisco` community (192.168.31.2 only) +- [SNMP] Restricted `public` community to 192.168.31.2 + +**CSS326 (192.168.31.9):** +- [SNMP] Verified SNMP enabled (SwOS default) +- [SNMP] Using `public` community (SwOS single-community limitation) +- [NOTE] SwOS does not support address restrictions via API + +**Testing:** +- [TEST] All three devices responding to SNMP queries from Unraid +- [TEST] sysName.0 verified: HAPax3, CAP XL ac, CSS326-24G-2S+ + +--- + ## 2026-01-19 - NetDisco Integration Planning ### Phase 8: NetDisco + NetBox Integration diff --git a/docs/12-PHASE8-NETDISCO-INTEGRATION.md b/docs/12-PHASE8-NETDISCO-INTEGRATION.md index 76fa93b..5eaabab 100644 --- a/docs/12-PHASE8-NETDISCO-INTEGRATION.md +++ b/docs/12-PHASE8-NETDISCO-INTEGRATION.md @@ -1,6 +1,6 @@ # Phase 8: NetDisco Integration with NetBox -**Status:** PLANNED +**Status:** IN PROGRESS **Priority:** Medium **Created:** 2026-01-19 @@ -78,7 +78,7 @@ ssh -p 2222 xtrm@192.168.31.1 /snmp community print ``` -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) #### 8.1.2 CSS326 (SwOS) @@ -91,7 +91,7 @@ ssh -p 2222 xtrm@192.168.31.1 **Note:** SwOS only supports SNMPv1/v2c read-only. -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) #### 8.1.3 cAP ac (RouterOS) @@ -104,7 +104,29 @@ ssh -p 2222 xtrm@192.168.31.6 /snmp community add name=netdisco addresses=192.168.31.2/32 read-access=yes write-access=no ``` -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) + +#### SNMP Configuration Applied (2026-01-19) + +| Device | IP | Communities | Access Restriction | +|--------|-----|-------------|-------------------| +| hAP ax³ | 192.168.31.1 | `netdisco`, `public` | 192.168.31.2/32 | +| cAP ac | 192.168.31.6 | `netdisco`, `public` | 192.168.31.2/32 | +| CSS326 | 192.168.31.9 | `public` | None (SwOS limitation) | + +**SNMP Settings:** +- Contact: admin@xtrm-lab.org +- Location: XTRM Home Lab +- Version: SNMPv2c +- Write Access: Disabled + +**Test Results:** +``` +hAP ax³: SNMPv2-MIB::sysName.0 = STRING: HAPax3 +cAP ac: SNMPv2-MIB::sysName.0 = STRING: CAP XL ac +CSS326: SNMPv2-MIB::sysName.0 = STRING: CSS326-24G-2S+ +``` + --- @@ -151,7 +173,7 @@ docker exec -it postgresql17 psql -U postgres -c "CREATE USER netdisco WITH PASS docker exec -it postgresql17 psql -U postgres -c "CREATE DATABASE netdisco OWNER netdisco;" ``` -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) --- @@ -183,7 +205,7 @@ schedule: nbtstat: '45 * * * *' # NetBIOS name poll ``` -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) --- @@ -211,7 +233,7 @@ http: **DNS:** Add netdisco.xtrm-lab.org to Cloudflare -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) --- @@ -266,7 +288,7 @@ for device in devices: # Create or flag for review ``` -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) --- @@ -290,7 +312,7 @@ docker run --rm --network dockerproxy netdisco/netdisco snmpwalk -v2c -c netdisc docker run --rm --network dockerproxy netdisco/netdisco snmpwalk -v2c -c netdisco 192.168.31.6 system ``` -**Status:** [ ] Not started +**Status:** [x] COMPLETED (2026-01-19) ---