Add Slurp'it network discovery setup and agent service accounts
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
All checks were successful
ci/woodpecker/push/woodpecker Pipeline was successful
- Enable SNMP on MikroTik router - Configure SNMP v2c credentials (public, netdisco) - Create agent service account on Unraid, router, AP - Document network discovery stack (Slurp'it, NetDisco, NetBox) - Update changelog with configuration changes
This commit is contained in:
@@ -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)
|
||||
|
||||
|
||||
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user