Grafisches .NET-Werkzeug für kontrollierte Wartungsfenster einer Microsoft BizTalk-Server-2020-Umgebung. Es erfasst den Laufzeitzustand, fährt ausschließlich die zuvor aktiven Artefakte in sicherer Reihenfolge herunter und startet nach dem Patchen ausschließlich diese Artefakte wieder.

Wichtigste Eigenschaften

übersichtliche deutschsprachige WinForms-Oberfläche mit klarer Sechs-Schritt-Führung
Dry-run standardmäßig aktiv
Vorher-Snapshot als verbindliche Wiederherstellungsgrundlage
vorhandener Vorher-Snapshot wird beim Herunterfahren nicht überschrieben
servergebundene Validierung verhindert die Verwendung einer Zustandsdatei für den falschen BizTalk-Server
Receive Locations, Send Ports, Orchestrierungen und Hostinstanzen
kontrollierte Reihenfolge mit Zustandsprüfung und konfigurierbarem Timeout
nur vorher aktive Artefakte werden heruntergefahren und wieder gestartet
WMI-Objekte werden eindeutig aufgelöst; mehrdeutige Treffer führen sicher zum Abbruch
wiederholbare Ausführung: bereits erreichte Zielzustände werden übersprungen
atomar geschriebene JSON-Dateien mit Größenbegrenzung
keine Transport-URIs, Benutzernamen oder Kennwörter im Snapshot
CSV-/HTML-Berichte und Vorher-/Nachher-Vergleich
tägliche Logs unter %ProgramData%\BizTalkPlatformManagementTool\Logs
eigenständiger .NET-Installer für Installation, Update und Deinstallation
ZIP-, SHA-256- und Base64-TXT-Paket werden beim Release-Build erzeugt

Sicherer Wartungsablauf

Tool als Administrator starten.
Zielserver und Arbeitsordner prüfen.
Verbindung prüfen ausführen.
Mit aktiviertem Dry-run Zustand erfassen.
Herunterfahren im Dry-run ausführen und shutdown-plan.json prüfen.
Dry-run deaktivieren und Herunterfahren bestätigen.
Server manuell patchen.
Dieselbe Vorher-Zustandsdatei auswählen.
Wiederherstellen zunächst im Dry-run prüfen und danach real ausführen.
Nachher erfassen und Vergleichen.

Die Zustandsdatei ist sicherheitskritisch: Sie definiert exakt, welche Artefakte wieder gestartet werden. Bewusst gestoppte, gebundene oder deaktivierte Artefakte bleiben beim Restore unangetastet.

Reihenfolge

Herunterfahren:

zuvor aktivierte Receive Locations deaktivieren
zuvor gestartete Orchestrierungen stoppen
zuvor gestartete Send Ports stoppen
zuvor gestartete Hostinstanzen des ausgewählten Servers stoppen

Wiederherstellen:

zuvor gestartete Hostinstanzen des ausgewählten Servers starten
zuvor gestartete Send Ports starten
zuvor gestartete Orchestrierungen starten
zuvor aktivierte Receive Locations zuletzt aktivieren

Dateien

Standard-Arbeitsbereich:

%ProgramData%\BizTalkPlatformManagementTool\
  Wartungen\
    Wartungsstatus-YYYYMMDD-HHmmss.json
    shutdown-plan.json
    shutdown-after.json
    restore-plan.json
    restore-after.json
    after.json
    diff.json / diff.csv / diff.html
  Logs\
    BizTalkPlatformManagementTool-YYYY-MM-DD.log

Zu jedem Snapshot entstehen CSV- und HTML-Begleitberichte. Vollständige Transportadressen werden nicht gespeichert, weil sie Zugangsdaten oder andere sensible URI-Bestandteile enthalten können und für die Wiederherstellung nicht benötigt werden.

Build und Tests

Voraussetzung ist das .NET Framework 4.6.1 Developer Pack:

msbuild BizTalkPlatformManagementTool.sln /t:Rebuild /p:Configuration=Release /p:Platform="Any CPU"
tests\BizTalkPlatformManagementTool.Tests\bin\Release\BizTalkPlatformManagementTool.Tests.exe

Der Release-Build erzeugt automatisch:

artifacts\BizTalkPlatformManagementTool-Setup\
artifacts\BizTalkPlatformManagementTool-Setup.zip
artifacts\BizTalkPlatformManagementTool-Setup.zip.b64.txt
artifacts\BizTalkPlatformManagementTool-Setup.zip.sha256.txt