--- titel: Maschinen-Seite im Dashboard — starten, prüfen, nachsehen stand: 01.11.2026 zweck: Wie die Maschinen-Seite aufgebaut ist, wie der kleine Dienst dazu funktioniert und wie man beides startet. --- # Maschinen-Seite (Dashboard) ## 1. Was sie kann `http://localhost:3000/vms.html` — drei Spalten: | Spalte | Inhalt | |---|---| | **links** | alle 62 Maschinen aus dem VMware-Inventar, nach Zweck gruppiert (Arbeits-VMs, Reserve, Telefon, Mail, Steuerung …), mit lesbarem Namen, Zweck, IP und Marke „läuft / aus" | | **mitte** | für die gewählte Maschine: **▶ Starten**, **■ Stoppen**, **⟳ neu laden** und die typischen Prüfbefehle — jeder mit **kopieren** und **prüfen** | | **rechts** | das Terminal: die echte Ausgabe der Prüfung, mit Zeitstempel, fortlaufend | Die Befehle richten sich nach der Maschine: 143 bekommt `meet-lokal`, 144 `livekit-lokal`, die Arbeits-VMs den Weg über den Bastion-Tunnel, `steuer127` den Panel-Test, `telefon-pbx` den SIP-Port. ## 2. Der Dienst dahinter Das Dashboard ist eine React-App und kann keine Prozesse starten. Deshalb gibt es ein kleines Programm daneben: **`C:\vm-tools\server.js`** (node, keine Fremdpakete), gebunden an **127.0.0.1:3210**: | Pfad | Zweck | |---|---| | `GET /api/vms` | Maschinen aus `inventory.vmls` + `vmrun list` → Name, Zweck, IP, Gruppe, läuft | | `POST /api/vm` | `{pfad, aktion: "start"\|"stop"}` → `vmrun start … nogui` bzw. `stop … soft` (mit hartem Stopp als Rückfall) | | `POST /api/pruefen` | `{ziel, art, port}` mit `art` = `ping`, `tcp`, `http`, `befehl` → führt aus und liefert die Ausgabe | **Port 3210, nicht 3100:** 3100 ist schon belegt (Windows-CoWork-Controller). **CORS** ist nur für `localhost:3000` freigegeben; der Dienst hört ausschließlich auf 127.0.0.1. ## 3. Starten ```powershell Start-Process -FilePath "C:\Program Files\nodejs\node.exe" -ArgumentList "C:\vm-tools\server.js" -WindowStyle Hidden ``` Prüfen: `http://127.0.0.1:3210/api/vms` muss JSON liefern (62 Maschinen). **Dauerbetrieb:** Der Dienst läuft nur, solange der Rechner läuft und jemand ihn startet. Für Autostart eine Verknüpfung in `shell:startup` anlegen — Ziel: `"C:\Program Files\nodejs\node.exe" C:\vm-tools\server.js`. ## 4. Geprüft am 01.11.2026 | Prüfung | Ergebnis | |---|---| | `/api/vms` | **62 Maschinen**, 4 laufen (steuer127, steuer1, 143, 144) | | Seite im Browser | 62 Einträge, 16 Gruppen, Start/Stop-Knöpfe, sechs Prüfbefehle für 143 | | Prüfung `ping 192.168.0.127` | Antwort in <1 ms, Ausgabe rechts sichtbar | | Prüfung `tcp 192.168.0.126:22` | „offen" | | Seiten-Aufruf | HTTP 200, 12.798 Bytes | ## 5. Wo man hinkommt | Von | Wohin | |---|---| | Dashboard (Port 3000) | Knopf **Maschinen** oben rechts | | Steuer-Panel (`steuer127.g3.local`) | Eintrag **Maschinen (starten, pruefen)** | | direkt | `http://localhost:3000/vms.html` | ## 6. Was noch fehlt 1. **Autostart** des Dienstes (siehe Abschnitt 3) — ohne ihn zeigt die Seite „Dienst nicht erreichbar". 2. **Vollbild-Terminal** je Maschine (SSH-Sitzung im Browser). Heute gibt es Einzelprüfungen; ein echter Terminalzugang wäre der nächste Schritt. 3. Die Namen der Reserve-VMs (145–150) sind noch Platzhalter — sobald klar ist, was darauf läuft, gehört es in die Tabelle `BEKANNT` in `server.js`. ## 7. Terminal je Maschine (01.11.2026, nachgereicht) Die rechte Spalte ist jetzt ein **echtes SSH-Terminal**, keine Ausgabefläche mehr: | Bedienelement | Wirkung | |---|---| | **Terminal öffnen** (in der Mitte) | startet eine SSH-Sitzung zur gewählten Maschine | | Eingabezeile unten | Befehl tippen, Enter sendet; **↑/↓** blättert durch den Verlauf; **Strg+C** bricht ab | | **Strg+C / leeren / schließen** | Abbruch, Fläche leeren, Sitzung beenden | **Wie der Zugang funktioniert:** Auf diesem Windows-Rechner liegt nur der Schlüssel für `steuer127`. Für die lokalen VMs springt er als Sprungrechner ein, und zwar über `sudo`, weil `steueruser1` den Schlüssel in `/root` nicht lesen darf: ``` ssh -tt -i C:\Users\pc2\.ssh\steuer steueruser1@192.168.0.127 \ "sudo -n ssh -tt -i /root/.ssh/anna2 anna2@" ``` Für `steuer127` selbst entfällt der Sprung (direkte Verbindung). **Technik:** Der Dienst hält den SSH-Prozess, die Seite liest seine Ausgabe über Server-Sent-Events (`/api/ssh//strom`) und schickt Tastatureingaben per `POST /api/ssh/taste`. Farbcodes werden im Browser entfernt, damit die Ausgabe lesbar bleibt. Eine Sitzung schließt nach 30 Minuten ohne Eingabe von selbst. **Geprüft am 01.11.:** | Prüfung | Ergebnis | |---|---| | Terminal zu `steuer127` | Anmeldung, `hostname; whoami` → `steuer127` / `steueruser1` | | Terminal zu VM 143 (Sprung über 127) | Anmeldung, `hostname; whoami` → `reserve-143` / `anna2` | | Farbcodes | keine mehr in der Ausgabe | | SSH-fähige Maschinen | 21 von 62 (alle Linux-VMs mit IP; Windows-VMs haben keinen SSH-Zugang) | **Grenzen:** Windows-VMs (Win10, Win11) haben kein Terminal — dort steht der Knopf auf gesperrt. Und ein Passwort-Dialog funktioniert nur, wenn die Ziel-VM den Schlüssel `anna2` akzeptiert; sonst erscheint die Passwortabfrage im Terminal und kann dort auch beantwortet werden. ## 8. Startreihenfolge als Knopf (01.11.2026) Oben rechts auf der Maschinen-Seite stehen zwei Knöpfe: | Knopf | Tut | |---|---| | **▶ Startreihenfolge** | fährt die vier Arbeits-VMs **nacheinander** hoch: 114 Tools → 115 Business → 116 Kommunikation → 117 Content | | **■ Reihe stoppen** | stoppt dieselben vier in derselben Reihenfolge (sanft, mit hartem Stopp als Rückfall) | Der Fortschritt läuft im Terminal mit, Zeile für Zeile: ``` === Starte: Arbeits-VMs (Tools, Business, Kommunikation, Content) === [1/4] tools-vm: laeuft schon [2/4] klon-115: starte ... laeuft [3/4] klon-116: starte ... laeuft [4/4] klon-117: starte ... laeuft === fertig: 4 von 4 === ``` **So arbeitet der Dienst:** Er startet eine Maschine, **wartet bis sie wirklich läuft** (`vmrun list` zeigt sie, höchstens drei Minuten), und geht dann zur nächsten. Wer schon läuft, wird übersprungen. Die Reihenfolge ist im Dienst als Tabelle hinterlegt (`REIHEN` in `server.js`); weitere Reihen dort eintragen — `grosse`, `telefon` und `meetlivekit` sind schon vorbereitet und über `/api/reihen` abfragbar. **Geprüft am 01.11.:** Klick auf „Startreihenfolge" → 114 (lief schon), 115, 116, 117 nacheinander gestartet, alle vier meldeten sich; danach **9 von 62** Maschinen laufen, 18,8 GB Arbeitsspeicher noch frei. **Achtung Speicher:** Jede Arbeits-VM nimmt 4 GB. Alle vier zusammen 16 GB plus die zwei Meet-VMs (8 GB) plus die Steuer-VMs (10 GB) — das passt bei 64 GB, ist aber die Obergrenze. Vor „alle starten" lohnt der Blick auf den Speicher. ## 9. Terminal zu beliebiger Adresse (01.11.2026) In der Terminal-Kopfzeile gibt es jetzt zwei Felder: **IP oder Name** und **Benutzer** (Vorgabe `anna2`) sowie den Knopf **verbinden**. Damit geht ein Terminal zu jeder Maschine, auch zu einer, die nicht im Inventar steht. **Was sofort auffiel:** `ubu22-komu3` (VM auf `J:`, per VMware Tools **192.168.0.252** — das ist `komu1.example.com` aus der hosts-Liste) läuft, antwortet auf Ping, hat aber **keinen offenen SSH-Port**: ``` ssh: connect to host 192.168.0.252 port 22: Connection refused ``` Das heißt: kein Terminal möglich, solange dort kein `sshd` läuft. Der Weg dorthin ist die VMware-Konsole: VM-Fenster öffnen, dort `sudo apt install openssh-server && sudo systemctl enable --now ssh` — danach funktioniert das Terminal sofort, weil der Sprung über `steuer127` schon steht. **Gegenprobe mit der freien Adresse:** `192.168.0.126` (steuer1) mit Benutzer `anna2` → angemeldet, `ip a | head -6` ausgeführt, Ausgabe im Terminal. ## 10. Terminal schließen Der Knopf **schließen** beendet die Sitzung wirklich: der Zustand springt auf „keine Sitzung", die Eingabezeile wird gesperrt, und der SSH-Prozess im Dienst wird beendet. Geprüft am 01.11.: vorher „verbunden" mit aktiver Eingabe, nach dem Klick „keine Sitzung" mit gesperrter Eingabe. Falls ein Terminal „hängt": einfach **schließen**, dann die Maschine neu wählen und erneut „Terminal öffnen" — der Dienst räumt Sitzungen nach 30 Minuten ohne Eingabe auch selbst auf. ## 11. Zweites Eingabefeld: der Befehl von der KI (01.11.2026) Über der normalen Eingabezeile sitzt jetzt eine eigene Zeile: ``` Befehl von der KI [ ip -4 addr show ens33 | grep inet ] ▶ ausführen übernehmen ``` **Wozu:** Ich schreibe den Befehl in dieses Feld — er steht dort sichtbar, ohne zu laufen. **Ausgeführt wird er erst, wenn Franz auf „▶ ausführen" klickt.** Vorher war es umgekehrt: ich tippte und Enter drückte, und im Terminal war nur das Ergebnis zu sehen — der Befehl selbst war schon durchgelaufen. | Bedienelement | Wirkung | |---|---| | Feld „Befehl von der KI" | wird von mir gefüllt, bleibt stehen, ist editierbar | | **▶ ausführen** | schickt den Befehl ins Terminal (setzt vorher `>>> befehl` als Marke in die Ausgabe) | | **übernehmen** | kopiert den Vorschlag nur in die normale Eingabezeile, ohne ihn zu starten | | Enter im Vorschlagsfeld | dasselbe wie „ausführen" | Der Vorschlag überlebt ein Neuladen der Seite (er liegt im `localStorage`), damit nichts verloren geht, wenn der Browser neu startet. **Geprüft am 01.11.:** Terminal zu 114 geöffnet, Vorschlag `ip -4 addr show ens33 | grep inet` eingesetzt, Feld und Knopf im Browser vorhanden. Ausführen erfolgt durch Franz. ## 12. Aufteilung der drei Spalten (01.11.2026) Die Spalten waren ungleich verteilt: links 320 px Maschinen, Mitte 1fr (Prüfbefehle), rechts nur 470 px Terminal — das Terminal war der engste Teil, obwohl dort die Ausgabe läuft. Neu: | Spalte | Breite | |---|---| | Maschinen | 290 px | | Prüfbefehle | 380 px | | **Terminal** | **restliche Breite** (`minmax(520px, 1fr)`) | Bei einem Fenster von 2195 px sind das gemessen: links 290, Mitte 380, **Terminal 1477 px**. Das Vorschlagsfeld ist damit 1130 px breit, statt in einer schmalen Spalte zu stehen. Unter 1360 px Fensterbreite klappen die drei Spalten untereinander (vorher war die Grenze bei 1200 px), damit das Terminal nie gequetscht wird. ## 13. Arbeitsweise: Befehl sichtbar, dann selbst starten Damit klar ist, wie das Zusammenspiel gedacht ist: 1. Ich wähle eine Maschine und öffne das Terminal — die Klicks markiere ich mit einem **gelben Punkt**, damit sichtbar ist, wohin ich klicke. 2. Ich schreibe den Befehl ins Feld **„Befehl von der KI"** und **starte ihn nicht**. 3. Franz liest den Befehl und drückt **▶ ausführen** — erst dann läuft er. 4. Die Ausgabe erscheint im Terminal, mit der Marke `>>> befehl` davor. ## 14. Terminal auch im Steuer-Panel (01.11.2026) Dieselbe Maschinen- und Terminal-Ansicht gibt es jetzt auch hier: **`https://steuer127.g3.local/terminal.html`** — erreichbar über den Menüpunkt **„Terminal (Maschinen, hier im Panel)"**. Warum das ohne Umbau ging: Die Seite im Panel ist dieselbe Oberfläche wie `localhost:3000/vms.html`, und sie spricht denselben Dienst auf dem PC an (`http://127.0.0.1:3210`). Chrome erlaubt einer **https**-Seite den Zugriff auf **http://127.0.0.1** — localhost gilt als vertrauenswürdig, deshalb keine Mixed-Content-Sperre. Damit das klappt, musste der Dienst seine CORS-Liste erweitern: `https://steuer127.g3.local` und `http://steuer127.g3.local` stehen jetzt darin. **Geprüft am 01.11.:** Seite lädt im Panel, zeigt **62 Maschinen**, Terminal zu `steuer127` geöffnet (`verbunden`), Eingabe aktiv, Vorschlagsfeld `hostname; systemctl is-active steuer-panel` eingesetzt — Ausführung erfolgt durch Franz per Klick. **Unterschied zur Dashboard-Seite:** nur die Kopfzeile (Verweise) und der Titel; die Funktion ist identisch — Liste, Start/Stop, Prüfbefehle, Terminal, Vorschlagsfeld, Startreihenfolge. **Voraussetzung bleibt:** Der Dienst `node C:\vm-tools\server.js` muss laufen (Autostart-Verknüpfung liegt im Autostart-Ordner). Ohne ihn zeigt die Seite „Dienst nicht erreichbar".