Initial commit: BF Core-Switch-Prep + VLAN-Architektur + Delegations-Übergabe

- ALL-SG8316M auf FW 2.2.1.2956 geflasht; VLAN-DB 10/20/30/40/100 via Telnet-CLI (non-disruptiv)
- CLI-Tooling: run-cli.exp + .cli-Files + CLI-REFERENCE (FW 2.2.1, IOS-artig)
- Kanonisches Inventar: bf.csv/md + build.py (Doku-Motor), Core-Port-Map
- Finaler VLAN-/Adressplan (10.40.<vlanid>.0/24), Firmware-Runbooks, Recovery-Assets
- Secrets/Firmware/State/DS_Store via .gitignore ausgeschlossen

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Christoph Emsenhuber
2026-06-09 18:08:45 +02:00
commit 498fa06472
25 changed files with 1474 additions and 0 deletions

41
switch/recovery/README.md Normal file
View File

@@ -0,0 +1,41 @@
# Mac-mini Recovery-Anker für den Switch-Flash
**Zweck:** Der Mac mini (10.40.41.167, en0, L2-benachbart zum Switch) trägt dauerhaft eine
**Zweit-IP 192.168.1.2/24**. Nach einem Firmware-Flash kommt der Switch auf `192.168.1.1` hoch
(Werks-Default) — über die Zweit-IP erreicht Claude ihn **vom Mac mini aus** und setzt ihn
automatisch auf `10.40.41.239` zurück. Kein manuelles IP-Suchen, kein Laptop nötig.
## Variante A — nur für heute (transient, kein Reboot dazwischen)
Auf dem Mac mini (deine SSH-Session):
```
sudo ifconfig en0 alias 192.168.1.2 255.255.255.0
ifconfig en0 | grep 192.168.1 # prüfen
```
Entfernen: `sudo ifconfig en0 -alias 192.168.1.2`
## Variante B — persistent (übersteht Reboots, empfohlen wenn Dauer-Anker)
Auf dem Mac mini, aus diesem Repo-Ordner (`switch/recovery/`):
```
sudo cp switch-recovery-ip.sh /usr/local/sbin/switch-recovery-ip.sh
sudo chmod 755 /usr/local/sbin/switch-recovery-ip.sh
sudo cp com.bf.switchrecoveryip.plist /Library/LaunchDaemons/
sudo chown root:wheel /Library/LaunchDaemons/com.bf.switchrecoveryip.plist
sudo launchctl load -w /Library/LaunchDaemons/com.bf.switchrecoveryip.plist
ifconfig en0 | grep 192.168.1 # prüfen
```
Deinstallieren:
```
sudo launchctl unload -w /Library/LaunchDaemons/com.bf.switchrecoveryip.plist
sudo rm /Library/LaunchDaemons/com.bf.switchrecoveryip.plist /usr/local/sbin/switch-recovery-ip.sh
sudo ifconfig en0 -alias 192.168.1.2
```
## Recovery-Ablauf nach Flash (Claude führt aus, vom Mac mini)
```
ssh 10.40.41.167
cd ~/.../bf-network-r6/switch # Repo muss auf dem Mac mini liegen ODER Claude tunnelt
SW_HOST=192.168.1.1 SW_USER=admin SW_PASS=admin ./sg8316m.sh set-ip 10.40.41.239
# Switch nun wieder auf .239 → .secrets zurück, dann VLANs/Ports/save
```
> Hinweis: Claude erreicht den Switch nach Flash **nur** über den Mac mini (.1.1 ist L2-lokal am Mac mini).
> Der Treiber `sg8316m.sh` muss daher vom Mac mini aus laufen (Repo dorthin klonen/kopieren oder via SSH ausführen).