Guarantee durable visible runtime logging

PROD-ScheduledTask-und-Laufzeitlogging-2026-08-26.txt

@@ -1,6 +1,6 @@
 PROD-RUNBOOK: SCHEDULEDTASK-STEUERUNG UND PERSISTENTES LAUFZEITLOGGING
 Stand: 2026-08-26
-Zielversion: 2.3.0
+Zielversion: 2.3.1
 Adapter: BizTalk ScheduledTask Adapter 7.0.2
 Adapterpfad: C:\Program Files (x86)\BizTalk ScheduledTask Adapter 7.0.2
 
@@ -8,14 +8,15 @@ URSACHE
 MSBTS_ReceiveLocation.Enable/Disable validiert die Transportdaten. Der Adapter
 benoetigt dabei Microsoft.BizTalk.Scheduler.dll (beobachtet: Version 3.13.0.0).
 Die Datei liegt in der BizTalk-Installation, ist aber nicht zwingend im GAC
-aufloesbar. Version 2.3.0 laedt sie nach Assemblyidentitaetspruefung nur in den
+aufloesbar. Version 2.3.1 laedt sie nach Assemblyidentitaetspruefung nur in den
 laufenden Toolprozess. Das Tool kopiert keine DLL und aendert den GAC nicht.
 
 VORBEREITUNG
 1. before.json, Reports und vorhandene Logs extern sichern.
-2. Setup 2.3.0 als Administrator installieren/aktualisieren.
-3. setup_version=2.3.0.0 und erfolgreichen Ziel-Self-Test pruefen.
-4. Tool als Administrator starten, Log Folder oeffnen.
+2. Setup 2.3.1 als Administrator installieren/aktualisieren.
+3. setup_version=2.3.1.0 und erfolgreichen Ziel-Self-Test pruefen.
+4. Tool als Administrator starten, gruenen Startup-Log-Pruefeintrag kontrollieren,
+   dann Log Folder oeffnen. Normalfall: %ProgramData%\BizTalkPlatformManagementTool\Logs.
 5. Im lokalen BizTalk-Ordner Microsoft.BizTalk.Scheduler.dll pruefen.
 6. Nur bei Sonderpfad AdapterAssemblySearchPaths in der EXE.config erweitern.
    Mehrere Pfade mit Semikolon trennen. Keine fremde/alte DLL kopieren.
@@ -46,6 +47,13 @@ LOGGING-TEST
 6. Aufbewahrung: aktueller Tag plus 29 Vortage.
 7. Grid: neueste maximal 10.000 Eintraege; Dateien bleiben vollstaendig.
 
+HINWEIS ZUM PFAD
+ProgramData ist nicht Program Files und im Explorer normalerweise ausgeblendet.
+Unter Program Files ist im Normalfall kein Log sichtbar. Die Reihenfolge lautet:
+ProgramData, LocalAppData, EXE-Unterordner Logs, Temp. Fallback oder Totalausfall
+muss ab 2.3.1 mit Pfad und Exception im Grid erscheinen. Die Tagesdatei muss den
+bei jedem Start geschriebenen Verifikationseintrag enthalten.
+
 FEHLERFALL SICHERN
 1. Aktuelle .log und relevante .log.gz aus Log Folder.
 2. shutdown-plan.json oder restore-plan.json.
@@ -65,7 +73,7 @@ ABNAHME
 - Teilfehler bleibt Failed, spaetere unabhaengige Schritte laufen weiter.
 - Historie erscheint nach Neustart im Grid.
 - Vortage komprimiert, 30 Kalendertage aufbewahrt.
-- Setup/Tool/Reports zeigen 2.3.0 bzw. 2.3.0-net461.
+- Setup/Tool/Reports zeigen 2.3.1 bzw. 2.3.1-net461.
 
 Detailfassung:
 docs\PROD-ScheduledTask-und-Laufzeitlogging-2026-08-26.md