Guarantee durable visible runtime logging

PROD-Laufzeitlog-Ablage-2.3.1.txt

@@ -0,0 +1,38 @@
+PROD-RUNBOOK: LAUFZEITLOG-ABLAGE - VERSION 2.3.1
+Stand: 2026-08-26
+
+EINORDNUNG
+Der Installationsordner C:\Program Files\BizTalkPlatformManagementTool ist nicht
+der primaere Logordner. Dieser liegt unter
+%ProgramData%\BizTalkPlatformManagementTool\Logs. ProgramData ist im Explorer
+normalerweise ausgeblendet. Im Program-Files-Ordner wird daher im Normalfall
+kein Log erwartet.
+
+FIX IN 2.3.1
+- Echter Create/Write/Flush/Delete-Test vor Auswahl eines Logpfads.
+- Reihenfolge: ProgramData, LocalAppData, EXE-Unterordner Logs, Temp.
+- Append-Fehler: derselbe Datensatz wird im naechsten Kandidaten wiederholt.
+- Fallback/Totalausfall erscheinen mit Pfad und Exception im Grid.
+- Jeder GUI-Start schreibt einen Startup-Verifikationseintrag in Datei und Grid.
+- Der Installer-Self-Test prueft einen temporaeren Write/Read-Roundtrip.
+- 30 Kalendertage, abgeschlossene Tage GZip, maximal 10.000 Grid-Eintraege.
+
+PROD-ABNAHME
+1. Setup 2.3.1 als Administrator installieren/aktualisieren.
+2. Erfolgreichen Ziel-Self-Test im Setup-Log pruefen.
+3. Tool starten, noch keine reale BizTalk-Operation ausfuehren.
+4. Gruenen Eintrag "Runtime log storage verified by startup append" pruefen.
+5. Gelbe Fallbackwarnung bzw. RUNTIME FILE LOGGING UNAVAILABLE ausschliessen.
+6. Log Folder oeffnen. Genannte Tagesdatei muss existieren und den Eintrag
+   dieses Starts enthalten.
+7. Diagnose ausfuehren, Tool schliessen und neu starten.
+8. Diagnosehistorie muss im Grid und in der Tagesdatei vorhanden sein.
+9. Erst danach ScheduledTask zuerst als Dry-run und nach Planreview real testen.
+
+BEI TOTALAUSFALL
+Keine reale Wartungsoperation beginnen. Vollstaendigen Grid-Eintrag, Benutzer,
+freien Speicher, Endpoint-Security-Ereignisse und ACLs der vier Kandidaten
+sichern. ACLs nicht eigenmaechtig aufweiten.
+
+DETAILFASSUNG
+docs\PROD-Laufzeitlog-Ablage-2026-08-26.md