--- titel: Server 05 (Buttons/Meet) lokal nachgebaut — Stand, Weg, Fallstricke erstellt: 2026-10-29 status: laeuft und ist von aussen erreichbar betrifft: Server 05 (178.104.71.84, ID 169594541), Steuerserver steuer127, gateway2 tags: [server05, meeting, livekit, lokal-statt-cloud, nginx, wireguard] --- # Server 05 lokal nachgebaut **Ergebnis:** Die Meeting-/Buttons-Anwendung von Server 05 läuft vollständig auf dem lokalen Steuerserver `steuer127` und ist über **https://buttons-test.unsere-ki-runde.xyz** erreichbar. Server 05 wurde dabei **nicht angefasst** — er bleibt als Vergleich und Rückfallweg. Damit ist der Beweis erbracht, dass der Umzug „erst lokal bauen, prüfen, dann Erreichbarkeit nach aussen schalten" für diesen Server funktioniert. --- ## 1. Was auf steuer127 läuft (10 systemd-Einheiten) | Einheit | Dienst | Port | |---|---|---| | `meeting-web-buttons` | Next.js-Frontend (LiveKit Meet, angepasst) | 127.0.0.1:3100 | | `meeting-mia-buttons` | LiveKit-Agent „Mia" | 8094 | | `meeting-ben-buttons` | LiveKit-Agent „Ben" | 8095 | | `meeting-fischer-guenstig-buttons` | Agent | 8096 | | `meeting-fischer-profi-buttons` | Agent | 8097 | | `meeting-makler-buttons` | Agent | 8098 | | `meeting-investor-buttons` | Agent | 8099 | | `meeting-sekretariat-buttons` | Sekretariatsdienst | 3113 | | `meeting-admin-buttons` | Admin-Oberfläche (`admin.py`, System-Python) | 3111 | | `meeting-mp3-buttons` | MP3-Erzeugung (`mp3.py`, System-Python) | 3112 | Die Agenten verbinden sich als Worker zu `wss://voiceserver2.unsere-ki-runde.xyz` (Server 01) — LiveKit selbst läuft also **noch** auf Server 01. Einrichtungsskript (auf dem Steuerserver, idempotent): `C:\vms\steuer127\05-dienste-alle.sh` — beendet lose Prozesse, schreibt alle Einheiten, `daemon-reload`, `enable --now`, dann Abnahme (Zustand + offene Ports). --- ## 2. Weg von aussen ``` Browser └─ https://buttons-test.unsere-ki-runde.xyz (Let's Encrypt, gültig bis 2027-01-26) └─ gateway2 2.31.79.124 nginx :443 └─ WireGuard-Tunnel wg-meetneu 10.204.24.1 → 10.204.24.2 └─ steuer127 nginx 10.204.24.2:3005 └─ Next.js 127.0.0.1:3100 ``` | Baustein | Datei / Wert | |---|---| | DNS | neuer A-Eintrag `buttons-test` → `2.31.79.124`, TTL 300 (Zone jetzt **15** Einträge) | | Zertifikat | `certbot certonly --webroot -w /var/www/certbot -d buttons-test.unsere-ki-runde.xyz` | | gateway2-Site | `/etc/nginx/sites-available/buttons-test` (Vorlage: `C:\vms\steuer127\gateway2-buttons-test.conf`) | | steuer127-Site | `/etc/nginx/sites-available/buttons-lokal` (Vorlage: `C:\vms\steuer127\buttons-lokal.conf`), lauscht auf `10.204.24.2:3005` | | Tunnel | `wg-quick@wg-meetneu`, 51823, `PersistentKeepalive 25`, beide Seiten `enabled` | Prüfung von aussen (funktioniert, geprüft am 29.10.2026): ```bash curl https://buttons-test.unsere-ki-runde.xyz/ # 200 curl "https://buttons-test.unsere-ki-runde.xyz/api/connection-details?\ roomName=meeting-buttons169594541-pruef02&participantName=Franz" # 200 + Token ``` Der Agent meldet danach selbst: `Meeting advisor ready: mia meeting-buttons169594541-pruef02` — d. h. Frontend, API, Server 01 und die lokalen Agenten spielen zusammen. --- ## 3. Die fünf Fallstricke (alle gelöst, alle teuer bezahlt) ### 3.1 Die Auto-Install-ISO blieb im Laufwerk `steuer127.vmx` stand auf `bios.bootOrder = "cdrom,hdd"` und `ide1:0.fileName = C:\iso-build\debian12-steuer-auto.iso`. **Folge:** Jeder Neustart bootete den Debian-Installer statt der Festplatte. Der Gast zeigte „Loading additional components / Retrieving nic-modules-…-di", hatte kein sshd, keine VMware-Tools, kein Netz — sah aus wie ein hängendes System. **Lösung:** ``` ide1:0.present = "FALSE" bios.bootOrder = "hdd" ``` Merksatz: **Nach jeder Installationsrunde das ISO abhängen.** Sonst installiert der nächste Neustart neu. ### 3.2 2 GB RAM sind zu wenig für 10 Dienste Mit 2048 MB und sechs LiveKit-Agenten (onnxruntime, av, Silero) ging die VM in Swap-Thrashing: `ping` antwortete noch, ssh kam nicht mehr durch (`Connection timed out during banner exchange`). **Jetzt:** `memsize = "6144"`, `numvcpus = "4"`. Belegung im Betrieb: ~3,3 GB von 5,9 GB. ### 3.3 Snapshot mit Speicherzustand blockiert RAM-Änderung Jeder Snapshot hat einen gesicherten RAM. Nach dem Ändern der Speichergröße verweigert VMware das Fortsetzen: „The memory size of the checkpointed virtual machine does not match the configured size". **Zwei Wege:** - Im Dialog **„Stand der Momentaufnahme verwerfen und ausschalten"** (Discard) wählen — Snapshots und Festplatte bleiben unberührt. - Oder ohne Dialog: im `.vmx` `checkpoint.vmState = ""` setzen. Dann bootet die VM frisch von der Platte des Snapshots. ### 3.4 nginx startet vor dem WireGuard-Interface `nginx` bindet auf `10.204.24.2:3005`. Beim Boot war die Tunnel-Adresse noch nicht da: `bind() to 10.204.24.2:3005 failed (99: Cannot assign requested address)` → `nginx.service: failed`. **Lösung** (`/etc/systemd/system/nginx.service.d/wg-tunnel.conf`): ```ini [Unit] Wants=wg-quick@wg-meetneu.service After=wg-quick@wg-meetneu.service ``` Danach `daemon-reload` + `restart nginx`. Gilt für jede Site, die an eine Tunnel-Adresse bindet. ### 3.5 Die Web-Einheit braucht die Environment-Datei `app/api/connection-details/route.ts` liest `process.env.LIVEKIT_URL`. Ohne `EnvironmentFile=/root/meeting-test-agents/.env` in `meeting-web-buttons.service` bricht die Route ab — Antwort `503 {"error":"KI-Beitritt fehlgeschlagen…"}`. Die Agenten-Einheiten hatten die Datei, die Web-Einheit nicht. ### 3.6 `/meeting-config` fehlte — deshalb gab es keine Berater zum Anklicken **Das war der eigentliche Grund, warum im Browser „keiner da" war.** Die Seite holt ihre Beraterliste per `fetch('/meeting-config')`. Auf Server 05 ist das **keine Datei, sondern ein nginx-Weg auf `admin.py` (Port 3111)**: ```nginx location = /meeting-config { proxy_pass http://127.0.0.1:3111; } location = /meeting-options { proxy_pass http://127.0.0.1:3111; } location ~ ^/meeting-admin(/|$) { proxy_pass http://127.0.0.1:3111; } location /meeting-mp3 { client_max_body_size 25m; proxy_read_timeout 150s; proxy_pass http://127.0.0.1:3112; } ``` Fehlt der Weg, antwortet die Next.js-App mit `404` und HTML. Folge in der Oberfläche: **keine Beraterknöpfe** → man kann niemanden auswählen → kein Agent schaltet sein Hör-Eingangssignal ein → es kommt nur die Begrüßung und sonst nichts. Genau das Symptom „alle Berater zur Auswahl, aber keiner da". Die vier Wege stehen jetzt in `C:\vms\steuer127\buttons-lokal.conf` und sind auf `10.204.24.2:3005` aktiv (geprüft: `/meeting-config` = 200, `/meeting-admin` = 200, Beraterknöpfe zeigen „bereit", Auswahl meldet „Jetzt hört Mia deine Frage."). **Prüfbefehl, wenn wieder etwas fehlt:** ```bash curl -s -o /dev/null -w '%{http_code}\n' https://buttons-test.unsere-ki-runde.xyz/meeting-config ``` `200` = gut, `404` = der nginx-Weg fehlt. --- ## 4. DNS-Änderung ohne Zonenverlust Namecheaps `setHosts` **ersetzt die ganze Zone**. Deshalb läuft jede Änderung über `C:\vms\steuer127\dnseintrag.py` (auf dem Mailserver ausführen, weil nur dessen IP bei Namecheap freigegeben ist): ```bash U= K= NEU_NAME=buttons-test NEU_IP=2.31.79.124 \ python3 /tmp/dnseintrag.py ``` Das Skript prüft **vor** dem Schreiben: mindestens 13 Einträge, `voice.avatarneu` weiterhin auf `2.28.228.136`, SPF/DMARC/DKIM vorhanden, Name noch nicht vergeben. Nach dem Schreiben liest es die Zone erneut und meldet fehlende Einträge. Zugangsdaten stehen nur im Vault (`/root/mailonly1_vault.yml`), nie in einer Datei. --- ## 5. Wiederherstellung in Kurzform Wenn die lokale Nachbildung neu aufgebaut werden muss: ```bash # 1. VM-Einstellungen prüfen (ISO abgehängt, RAM ausreichend, Boot von Platte) grep -E 'ide1:0.present|bios.bootOrder|memsize|numvcpus' C:\vms\steuer127\steuer127.vmx # 2. Nachbau der Dienste scp C:\vms\steuer127\05-dienste-alle.sh steueruser1@192.168.0.127:/home/steueruser1/da.sh ssh steueruser1@192.168.0.127 'sudo bash /home/steueruser1/da.sh' # 3. nginx-Sites (beide Seiten) und Tunnel prüfen sudo nginx -t && sudo systemctl status nginx wg-quick@wg-meetneu # 4. Abnahme curl -s -o /dev/null -w '%{http_code}\n' https://buttons-test.unsere-ki-runde.xyz/ ``` --- ## 6. Selbsttest ohne Menschen (wichtig für jede Fehlersuche) `C:\vms\steuer127\selbsttest.py` (auf dem Steuerserver unter `/root/meeting-test-agents/selbsttest.py`) macht den ganzen Weg automatisch: tritt als Gast in einen Buttons-Raum, sendet `{"selected":"mia"}` auf Topic `meeting-control`, erzeugt einen gesprochenen Satz über OpenAI-TTS und veröffentlicht ihn als **Mikrofon**spur — dann schreibt es mit, was zurückkommt. Ergebnis vom 29.10.2026, 09:2x: ``` TRANSKRIPT (Gast): Hallo Mia, kannst du mich hören? → erkannt DATA meeting-transcript: {"speaker":"Besucher", ...} TRANSKRIPT (Mia): Hallo, ich kann dich hören! Wobei kann ich dir helfen? AUDIO von allen sechs Agenten empfangen (je ~1,9 MB) ``` **Damit ist bewiesen: Agenten, Spracherkennung, Antwort und Sprachausgabe funktionieren lokal.** Wenn ein Mensch im Browser nur die Begrüßung hört und danach nichts, liegt es **nicht** am Server, sondern am Mikrofon im Browser (Berechtigung verweigert, stummer Kanal, alter Zwischenspeicher) oder an der fehlenden Berater-Auswahl. Wichtige Regel des Aufbaus: **Ein Agent hört nur, wenn die Seite ihn auswählt.** `sessions.input.set_audio_enabled(False)` ist der Ausgangszustand; erst die Auswahl (`select()` → `publishData({selected}, topic:'meeting-control')`) schaltet das Hör-Eingangssignal dieses einen Beraters ein. „Alle pausieren" schaltet alle ab. Zweiter Helfer: `rauminfo.py` zeigt für einen Raum Teilnehmer und Tonspuren, `raumwache.py` beobachtet alle Buttons-Räume mehrere Minuten lang live. --- ## 7. Offene Punkte | Punkt | Warum offen | |---|---| | LiveKit lokal betreiben | Agenten hängen noch an Server 01 (`wss://voiceserver2…`). Erst wenn LiveKit auf steuer127 läuft, ist Server 01 verzichtbar. | | Enter-Taste im Chat | Server 09 hat einen Patch, die lokale Kopie nicht — nachziehen, damit beide gleich sind. | | Server 05 stilllegen | Erst wenn die lokale Variante einige Tage stabil lief **und** ein Testgespräch mit Ton und Protokoll geklappt hat. | | Alte VM-Reste | `C:\vms\steuer127\*.bak-*` (vmx-Sicherungen) und `konsole*.png` können nach der Abnahme weg. |