BizTalkPlatformManagementTool/docs/PROD-Laufzeitlog-Ablage-2026-08-26.md

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.