bf-infra/memory/project_tp2_topology.md

name, description, metadata

name	description	metadata
project-tp2-topology	TP2 Omada Switch + Controller — finale IPs, Portplan, API-Gotchas, offene TP3-Abhängigkeiten	type project

TP2 ✅ abgeschlossen 2026-06-15. Omada ES208G (sw2) adopted, VLANs + Port-Profiles aktiv.

Finale IPs:

• omada-controller: 10.40.41.175 (DS923/macvlan, mbentley 6.2.10.17)
• omada-mcp: 10.40.41.176 (pve-LXC endpointId=2, ipvlan, Stack 200)
• pve-mcp: 10.40.41.173 (SSE)
• sw2 (ES208G): 10.40.41.12 (adopted, FW 1.0.2 Build 20260329)

Omada Open API Gotcha:

• Token-Request: POST /openapi/authorize/token?grant_type=client_credentials (query param!), JSON body: {client_id, client_secret, omadacId}
• Auth-Header: Authorization: AccessToken=<token> (NICHT Bearer)
• URL-Format: {base}/openapi/v1/{omadacId}/sites/{siteId}/...
• omada-mcp Settings-Bug war: doppelter "omada-mcp"-Eintrag in ~/.claude/settings.json (zweiter überschreibt ersten — fixed)

Omada-MCP Tools:

• 84 read-only Tools, OMADA_TOOL_CATEGORIES=all
• Write (VLAN/Ports) NICHT im MCP implementiert — direkte Open API oder Controller-UI nötig
• ES-Switch-Pfad: /sites/{siteId}/switches/es/{mac} (nicht /esSwitches/)

Port-Plan ES208G (final):

• Port 1 (uplink) → Trunk-ALL → ALLNET GE8
• Port 2 (ap2) → Trunk-ALL → hAP ax² #2
• Port 3 → Access-MAIN
• Port 4 (dock/monitor) → Access-INFRA
• Port 5 (drucker) → Access-MAIN
• Port 6 → Access-MAIN
• Port 7 (macmini) → Access-INFRA
• Port 8 (ds923+) → Access-MAIN (2. NAS-Port, absichtlich MAIN)

VLANs im Controller: VLAN 1 (Default, status=true/mgmt), 10 MAIN, 20 INFRA, 30 IOT, 40 MEDIA, 50 UNTRUSTED, 90 GUEST, 99 MGMT, 100 WAN Alle status=false (kein Mgmt-IP konfiguriert) → normal, L3 kommt in TP4.

Why: Traffic noch auf VLAN 1, weil TP4 (Router-Cutover, L3-Interfaces auf hAP) aussteht.

How to apply: Bei TP3/TP4 Arbeiten: omada-mcp read-only für Status; Writes via Open API (curl mit AccessToken= Header) oder Controller-UI .175:8043.