Guarantee durable visible runtime logging

2026-08-26 10:40:29 +02:00
parent 999f69bcb9
commit fe3c84a27f
20 changed files with 520 additions and 72 deletions
@@ -0,0 +1,44 @@
+# PROD-Runbook: Laufzeitlog-Ablage und Version 2.3.1
+
+**Stand:** 2026-08-26
+**Zielversion:** 2.3.1
+
+## Einordnung des Screenshots
+
+Der gezeigte Ordner `C:\Program Files\BizTalkPlatformManagementTool` ist der Programmordner. Der primäre Laufzeitlogordner ist dagegen `%ProgramData%\BizTalkPlatformManagementTool\Logs`, üblicherweise `C:\ProgramData\BizTalkPlatformManagementTool\Logs`. `C:\ProgramData` ist im Explorer standardmäßig ausgeblendet. Im Programmordner wird deshalb im Normalfall kein Log erwartet.
+
+Die frühere Implementierung konnte dennoch einen echten Fehler verdecken: Sie prüfte nur, ob sich der Ordner anlegen ließ, und ignorierte einen Fehler beim nachfolgenden `AppendAllText`. Damit konnte das Grid funktionieren, obwohl kein dauerhaftes Log geschrieben wurde.
+
+## Fix in 2.3.1
+
+- Jeder Kandidat muss einen echten Create/Write/Flush/Delete-Test bestehen.
+- Die Reihenfolge ist ProgramData, LocalAppData, EXE-Unterordner `Logs`, Temp.
+- Ein späterer Append-Fehler wiederholt denselben Datensatz auf dem nächsten Kandidaten.
+- Fallback und vollständiger Ausfall erscheinen mit Pfad und Exception im Grid.
+- Jeder GUI-Start schreibt `Runtime log storage verified by startup append. Active file: ...` in Grid und Tagesdatei.
+- Der Installer-Self-Test prüft einen vollständigen temporären Write/Read-Roundtrip.
+- Tagesdateien werden nach Abschluss komprimiert; aktueller Tag plus 29 Vortage bleiben erhalten. Bis zu 10.000 Einträge werden nach Neustart ins Grid geladen.
+
+## PROD-Abnahme nach Update
+
+1. Setup 2.3.1 als Administrator ausführen und erfolgreichen Ziel-Self-Test prüfen.
+2. Tool als Administrator starten, noch keine reale BizTalk-Operation ausführen.
+3. Im Grid den grünen Startup-Verifikationseintrag prüfen und seinen vollständigen Dateipfad notieren.
+4. Auf eine gelbe Pfad-Fallbackwarnung oder `RUNTIME FILE LOGGING UNAVAILABLE` achten.
+5. **Log Folder** öffnen und prüfen, dass exakt die genannte Tagesdatei existiert.
+6. Datei öffnen und den Startup-Verifikationseintrag dieses Starts prüfen.
+7. **Diagnose** ausführen, Tool regulär schließen und neu starten.
+8. Prüfen, dass Diagnoseeinträge wieder im Grid erscheinen und auch in der Tagesdatei stehen.
+9. Erst danach den ScheduledTask-Test zunächst als Dry-run und nach Planreview real durchführen.
+
+Bei `RUNTIME FILE LOGGING UNAVAILABLE` keine reale Wartungsoperation beginnen. Screenshot des vollständigen Grid-Eintrags, aktiven Benutzer, freien Speicher, Endpoint-Security-Ereignisse und die ACLs der vier genannten Kandidaten sichern. Keine ACL eigenmächtig aufweiten; die Ursache mit dem Serverbetrieb klären.
+
+## Supportpaket
+
+- Aktuelle `.log` und relevante `.log.gz` aus **Log Folder**
+- Screenshot der Startup-Verifikation beziehungsweise vollständigen Speicherwarnung
+- `shutdown-plan.json`/`restore-plan.json` und passender `*-result.json`-Report
+- `before.json`, Nachher-Snapshot und unveränderte EXE-Konfiguration
+- Setup-Log mit `setup_version=2.3.1.0` und erfolgreichem Ziel-Self-Test
+
+Die Windows-/BizTalk-/PROD-Prüfung bleibt die endgültige Abnahme; die portable Regressionstoolchain simuliert die drei Speicherfehlerpfade ohne BizTalk.