45 lines
3.1 KiB
Markdown
45 lines
3.1 KiB
Markdown
# 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.
|