81 lines
3.8 KiB
Plaintext
81 lines
3.8 KiB
Plaintext
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
|