# 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)