PROD-RUNBOOK: SCHEDULEDTASK-STEUERUNG UND PERSISTENTES LAUFZEITLOGGING
Stand: 2026-08-26
Zielversion: 2.3.0
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.0 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.
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. Restore zuerst Dry run, dann real.
8. Calling MSBTS_ReceiveLocation.Enable und Reached pruefen.
9. 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.

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.0 bzw. 2.3.0-net461.

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