106 lines
3.9 KiB
Markdown
106 lines
3.9 KiB
Markdown
# BizTalk Platform Management Tool
|
|
|
|
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
|
|
|
|
1. Tool als Administrator starten.
|
|
2. Zielserver und Arbeitsordner prüfen.
|
|
3. **Verbindung prüfen** ausführen.
|
|
4. Mit aktiviertem Dry-run **Zustand erfassen**.
|
|
5. **Herunterfahren** im Dry-run ausführen und `shutdown-plan.json` prüfen.
|
|
6. Dry-run deaktivieren und **Herunterfahren** bestätigen.
|
|
7. Server manuell patchen.
|
|
8. Dieselbe Vorher-Zustandsdatei auswählen.
|
|
9. **Wiederherstellen** zunächst im Dry-run prüfen und danach real ausführen.
|
|
10. **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:
|
|
|
|
1. zuvor aktivierte Receive Locations deaktivieren
|
|
2. zuvor gestartete Orchestrierungen stoppen
|
|
3. zuvor gestartete Send Ports stoppen
|
|
4. zuvor gestartete Hostinstanzen des ausgewählten Servers stoppen
|
|
|
|
Wiederherstellen:
|
|
|
|
1. zuvor gestartete Hostinstanzen des ausgewählten Servers starten
|
|
2. zuvor gestartete Send Ports starten
|
|
3. zuvor gestartete Orchestrierungen starten
|
|
4. zuvor aktivierte Receive Locations zuletzt aktivieren
|
|
|
|
## Dateien
|
|
|
|
Standard-Arbeitsbereich:
|
|
|
|
```text
|
|
%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:
|
|
|
|
```cmd
|
|
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:
|
|
|
|
```text
|
|
artifacts\BizTalkPlatformManagementTool-Setup\
|
|
artifacts\BizTalkPlatformManagementTool-Setup.zip
|
|
artifacts\BizTalkPlatformManagementTool-Setup.zip.b64.txt
|
|
artifacts\BizTalkPlatformManagementTool-Setup.zip.sha256.txt
|
|
```
|
|
|
|
## Dokumentation
|
|
|
|
- [Installation](Installation.md)
|
|
- [Technische Dokumentation](Dokumentation.md)
|
|
- [Microsoft-Referenzen](REFERENCES.md)
|