Files
PolyTraderSharp/docs/TESTUMGEBUNG-Linux-VM.md
RichardandClaude Opus 5 53231d62bc
CI / Build & Tests (Linux) (push) Canceled after 0s
CI / Plattformneutralität & Hygiene (push) Canceled after 0s
Testen laeuft jetzt ueber das Deploymentcenter; Befunde in den Bugtracker
Die Testanleitung im PolyTrader-Repo ist nur noch ein Zeiger auf die
massgebliche Fassung in Deploymentcenter/docs/TESTUMGEBUNG.md, plus dem, was
PolyTrader-eigen ist: Display :99, Datenbank polytrader_test, Dienstkonto,
Publish-Verzeichnis, /tmp-Praefix. Die Anleitung galt immer projektuebergreifend
und lag nur hier, weil sie beim ersten Linux-Lauf von PolyTrader entstand. Eine
Tabelle loest die alten Abschnittsnummern auf, damit vorhandene Verweise lesbar
bleiben.

Befundbericht: Nachtrag 6 haelt die Gegenprobe am Bild vom 28.08.2026 fest -
den ersten Lauf nach dem neuen Verfahren. Linux-Build 0 Fehler / 15 Warnungen
wie unter Windows, 484 Tests gruen, --smoke-ui unter xvfb-run -n 99 durchgaengig
gruen. B-6, B-7, B-11, B-13, B-14 und die B-12-Selbstheilung sind damit auf der
Zielplattform bestaetigt; B-9 hat sich als kein Fehler entpuppt, und die
Spaltenumstellung hatte einen eigenen Fehler erzeugt.

Damit ist dieser Bericht abgeschlossen. Was offen bleibt, steht ab jetzt im
Bugtracker (Items #50-#52 und #56 fuer polytrader, #53-#55 und #57 fuer
deploymentcenter) statt in Befundberichten - dort geht es nicht mehr verloren,
und Befunde an fremden Projekten landen dort, wo jemand sie beheben kann.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-08-28 21:06:34 +02:00

99 lines
4.0 KiB
Markdown

# Linux-Testumgebung — PolyTrader-Teil
**Stand: 28.08.2026**
> ## ⚠️ Die Anleitung ist umgezogen
>
> Die vollständige, gepflegte Fassung liegt jetzt im **Deploymentcenter-Repo**:
>
> **`J:\Softwareprojekte\Deploymentcenter\docs\TESTUMGEBUNG.md`**
>
> Diese Datei hier enthält nur noch, was **PolyTrader-eigen** ist.
**Warum der Umzug.** Die Anleitung galt von Anfang an projektübergreifend — sie regelt
Datenbanknamen, X-Displays und Portvergabe für *alle* Projekte auf der geteilten VM. Sie lag
trotzdem im PolyTrader-Repo, weil sie beim ersten Linux-Lauf von PolyTrader entstanden ist.
Das war die falsche Heimat, und es fiel auf, als die Testumgebung an die vorhandene Infrastruktur
angeschlossen wurde: Lizenzschlüssel, Release-Ablage und Bugtracker gehören dem Deploymentcenter,
und die Beschreibung, wie ein Agent sie benutzt, gehört dorthin, wo sie mit ihnen gemeinsam
gepflegt wird. Ein Agent in Predictalytics hätte die Regeln für sein X-Display sonst in einem
fremden Handelsprojekt suchen müssen.
---
## Was neu ist
Auf der VM muss nichts mehr von Hand besorgt werden, was das Deploymentcenter schon hat:
```bash
curl -fsSL https://dc.mhdf.de/testkit/dc-testkit.sh -o ~/bin/dc-testkit && chmod +x ~/bin/dc-testkit
dc-testkit doctor # Werkzeuge, Netz, Token, Projekt
dc-testkit license # befristeten DEV-Lizenzschlüssel selbst holen
dc-testkit run # ausliefern, prüfen, aktualisieren — meldet, was scheitert
dc-testkit report --type bug --title "…" --desc "…"
```
Voraussetzung ist ein **Werkbank-Token** für PolyTrader (Besitzerart `dev_agent`, Rechte
`bugtracker:manage` und `license:dev`). Das legt ein Mensch einmalig im Deploymentcenter-WebUI an;
siehe `TESTUMGEBUNG.md` §4.2.
**Kein Kundenschlüssel mehr auf der Test-VM.** Ein DEV-Schlüssel läuft nach 30 Tagen ab, ist in
der Aktivierungsliste als Testhardware erkennbar und verbraucht keine Aktivierungsplätze einer
echten Lizenz.
---
## PolyTrader-eigene Festlegungen
Diese Werte stehen auch in der Belegungsliste der Hauptanleitung (§7); hier stehen sie, damit man
sie beim Arbeiten am Projekt nicht dort suchen muss.
| Was | Wert |
|---|---|
| X-Display | **`:99`** — fest für PolyTrader |
| Datenbank | `polytrader_test`, Benutzer `polytrader_test`@`localhost` |
| Passwortdatei | `~/.polytrader_test_dbpw` (Rechte 600) |
| systemd-Unit | `polytrader.service`, Konto `polytrader`, Verzeichnis `/opt/polytrader` |
| Publish-Verzeichnis | `~/polytrader-test` |
| Dateien in `/tmp` | immer mit Präfix `polytrader_` |
| Fenstername für `xdotool` | `^PolyTrader$` |
⚠️ **`xvfb-run -n 99`, niemals `-a`.** Das `-a` sucht sich selbst ein freies Display und beginnt
dabei bei `:99` — also ausgerechnet auf PolyTraders Nummer.
⚠️ **Keine Produktivdatenbank verbinden.** Der `MarketSyncService` synchronisiert selbständig
Marktdaten, sobald er läuft — auch dann, wenn niemand ihn darum gebeten hat.
---
## Wo die alten Abschnitte jetzt stehen
Ältere Dokumente in diesem Repo verweisen auf Abschnittsnummern dieser Datei. Die Nummerierung hat
sich durch den neuen Testkit-Abschnitt verschoben:
| Alt (hier) | Neu (`Deploymentcenter/docs/TESTUMGEBUNG.md`) |
|---|---|
| §1 Was diese Maschine ist | §1 — unverändert |
| §2 Zugang einrichten | §2 — unverändert |
| §3 Was installiert ist | §3 — unverändert |
| — | **§4 Das Testkit** (neu) |
| §4.1 Datenbanken | §5.1 |
| §4.2 Verzeichnisse | §5.2 |
| §4.3 systemd-Dienste | §5.3 |
| §4.4 Ports | §5.4 |
| §4.5 X-Displays | §5.5 |
| §4.6 Erhöhte Rechte | §5.6 |
| §4.7 GUI ohne Bildschirm | §5.7 |
| **§4.8 Oberflächen selbst begutachten** | **§5.8** |
| §5 Was hier nicht passieren darf | §6 |
| §6 Belegung | §7 |
| **§7 Aufräumen** | **§8** |
| §8 Bekannte Einschränkungen | §9 |
Betroffen sind [BEFUND-Linux-Betrieb-2026-08-26.md](./pruefplaene/BEFUND-Linux-Betrieb-2026-08-26.md)
(§4.8 und §7) und [ROADMAP.md](./ROADMAP.md). Die Verweise wurden bewusst **nicht** umgeschrieben:
Ein Befundbericht ist eine Momentaufnahme und soll lesen wie am Tag seiner Erstellung. Diese
Tabelle löst sie auf.