diff --git a/docs/00-CURRENT-STATE.md b/docs/00-CURRENT-STATE.md index 3a967e3..da7e9e8 100644 --- a/docs/00-CURRENT-STATE.md +++ b/docs/00-CURRENT-STATE.md @@ -293,3 +293,65 @@ flowchart TB - [Phase 1: DNS Portability](./01-PHASE1-DNS-PORTABILITY.md) - [Phase 7: Gitea GitOps](./08-PHASE7-GITEA-GITOPS.md) - [Changelog](./06-CHANGELOG.md) + +--- + +## Network Discovery & Management + +### Slurp'it Stack + +| Container | IP | Purpose | +|-----------|-----|---------| +| slurpit-portal | 172.18.0.129 | Web UI (slurpit.xtrm-lab.org) | +| slurpit-scanner | 172.25.0.5 | SNMP network scanner | +| slurpit-scraper | 172.25.0.3 | Device data collector | +| slurpit-warehouse | 172.25.0.4 | Data storage API | +| slurpit-mariadb | 172.25.0.2 | Portal database | +| slurpit-mongodb | 172.25.0.6 | Discovery database | + +**Status:** Operational +**Discovered Devices:** 1 (MikroTik Router) +**SNMP Communities:** public, netdisco + +**Configuration:** +- SNMP v2c credentials configured +- Scan target: 192.168.31.0/24 +- NetBox integration: Enabled (plugin_online: 1) + +**Pending Tasks:** +- Add SSH credentials to Vault for device scraping +- Troubleshoot SNMP discovery of switch and AP + +### NetDisco + +| Container | IP | Purpose | +|-----------|-----|---------| +| netdisco-web | 172.18.0.41 | Web UI (netdisco.xtrm-lab.org) | +| netdisco-backend | 172.18.0.42 | SNMP poller | + +### NetBox (IPAM/DCIM) + +| Container | IP | Purpose | +|-----------|-----|---------| +| netbox | 172.24.0.5 | Web UI (netbox.xtrm-lab.org) | +| netbox-postgres | 172.24.0.4 | Database | +| netbox-redis | 172.24.0.2 | Cache | +| netbox-worker | 172.24.0.6 | Background tasks | + +**NetBox Slurp'it Plugin:** Installed and configured + +--- + +## Agent Service Account + +A dedicated service account `agent` was created for automated tools: + +| Device | Username | Auth Method | Port | +|--------|----------|-------------|------| +| Unraid | agent | SSH Key + Password | 422 | +| MikroTik Router | agent | SSH Key | 2222 | +| MikroTik AP | agent | Password | 2222 | +| MikroTik Switch | N/A | No SSH (SwOS) | - | + +**Credentials:** See docs/AGENT-CREDENTIALS.md (gitignored, local only) + diff --git a/docs/06-CHANGELOG.md b/docs/06-CHANGELOG.md index 357dc01..1fd3a65 100644 --- a/docs/06-CHANGELOG.md +++ b/docs/06-CHANGELOG.md @@ -1,3 +1,28 @@ +## 2026-01-22 - Slurp'it Network Discovery Setup + +### SNMP Configuration +- [MIKROTIK] Enabled SNMP on router (192.168.31.1) +- [SNMP] Communities configured: public, netdisco +- [DISCOVERY] MikroTik router discovered via SNMP + +### Agent Service Account +- [UNRAID] Created agent user with SSH key access (port 422) +- [MIKROTIK-ROUTER] Created agent user with SSH key (port 2222) +- [MIKROTIK-AP] Created agent user with password auth (port 2222) +- [SWITCH] CSS326 uses SwOS - no SSH support + +### Slurp'it Configuration +- [SNMP] Added SNMP v2c credentials to vault (public, netdisco) +- [NETBOX] Enabled NetBox integration plugin +- [SCAN] Configured scan target: 192.168.31.0/24 + +### Documentation +- [DOCS] Added Network Discovery section to 00-CURRENT-STATE.md +- [DOCS] Created AGENT-CREDENTIALS.md (gitignored) +- [DIAGRAM] Added INFRASTRUCTURE-DIAGRAM.md with complete topology + +--- + ## 2026-01-22 - MikroTik DNS Migration to AdGuard Home ### Pi-hole Removal from MikroTik