PROD-RUNBOOK: SCHEDULEDTASK-STEUERUNG UND PERSISTENTES LAUFZEITLOGGING
Stand: 2026-08-26
Zielversion: 2.3.4
Adapter: BizTalk ScheduledTask Adapter 7.0.2
Adapterpfad: C:\Program Files (x86)\BizTalk ScheduledTask Adapter 7.0.2

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.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.4 als Administrator installieren/aktualisieren.
3. setup_version=2.3.4.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.

FUNKTIONSTEST
1. Diagnose.
2. Snapshot Before; Scheduler-Receive-Location und scheduler:-URI pruefen.
3. Shutdown zuerst mit Dry run; shutdown-plan.json reviewen.
4. Dry run deaktivieren, Shutdown bestaetigen.
5. Erwartete Logzeilen:
   ScheduledTask adapter preflight
   ProcessBitness=...; SearchDirectories=...
   ScheduledTask dependency loaded process-locally / resolved through CLR/GAC
   (oder already loaded)
   Calling MSBTS_ReceiveLocation.Disable
   Reached: Disable receive location completed
6. shutdown-result.json: Succeeded oder AlreadySatisfied.
7. Drain-Checkpoint: Group Hub/Monitoring leer laufen lassen, dann Yes.
8. Restore zuerst Dry run, dann real.
9. Calling MSBTS_ReceiveLocation.Enable und Reached pruefen.
10. Snapshot After und Compare; Sollzustand muss wiederhergestellt sein.

LOGGING-TEST
1. Lauf mit erkennbarer Uhrzeit erzeugen, Tool schliessen und neu starten.
2. Vorherige Eintraege muessen mit Datum/Uhrzeit wieder im Grid stehen.
3. Clear leert nur das Grid; Neustart laedt die Historie erneut.
4. Aktueller Tag: BizTalkPlatformManagementTool-yyyy-MM-dd.log
5. Abgeschlossene Vortage: .log.gz
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.
3. Passenden *-result.json-Report.
4. before.json und vorhandenen Nachher-Snapshot.
5. Unveraenderte BizTalkPlatformManagementTool.exe.config.
6. Screenshot des vollstaendigen roten Grid-Eintrags.
7. Dateiversion von Microsoft.BizTalk.Scheduler.dll.

Fehler enthalten Typ, HRESULT, innere Ausnahmen, Fusion-Informationen,
Stacktrace, angeforderte/anfragende Assembly und alle Suchpfade. GAC oder DLLs
im Fehlerfall nicht spontan veraendern; zuerst dieses Supportpaket auswerten.

ABNAHME
- Scheduler-Receive-Location real deaktiviert und wieder aktiviert.
- Normale Adapter ohne Scheduler-Preflight weiterhin funktionsfaehig.
- 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.4 bzw. 2.3.4-net461.

Detailfassung:
docs\PROD-ScheduledTask-und-Laufzeitlogging-2026-08-26.md