# 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.