# Installation und Update

## Voraussetzungen

- Windows Server 2019/2022 oder Administrationshost
- Microsoft BizTalk Server 2020 oder installierte BizTalk Administration Tools
- .NET Framework 4.6.1 oder neuer
- lokales Administratorkonto
- Mitgliedschaft in der Gruppe **BizTalk Server Administrators**
- WMI-Zugriff auf `root\MicrosoftBizTalkServer`

## Installation

1. `BizTalkPlatformManagementTool-Setup.zip` vollständig entpacken.
2. `Setup.exe` starten; die UAC-Anforderung bestätigen.
3. Optional die systemweite Desktop-Verknüpfung auswählen.
4. **Installieren / aktualisieren** wählen.

Installiert wird nach `%ProgramFiles%\BizTalkPlatformManagementTool`.
Persistente Wartungszustände und Logs liegen getrennt unter
`%ProgramData%\BizTalkPlatformManagementTool`.

## Sicheres Update

Der Installer validiert das Paket, kopiert die neue Version zunächst in ein
Staging-Verzeichnis und aktiviert sie erst danach. Eine vorhandene Installation
wird vorübergehend umbenannt. Schlägt das Update fehl, wird die vorherige
Programmversion wiederhergestellt. Wartungszustände und Logs unter
`%ProgramData%` bleiben unberührt.

Vor dem Update muss das Management Tool geschlossen sein. Laufende
Wartungsoperationen dürfen nicht durch ein Update unterbrochen werden.

## Deinstallation

Im Setup kann die Anwendung wieder deinstalliert werden. Standardmäßig bleiben
Wartungszustände und Logs erhalten. Die Option kann deaktiviert werden, wenn
auch diese Daten bewusst entfernt werden sollen.

## Transport-TXT zurückwandeln

Die Datei `BizTalkPlatformManagementTool-Setup.zip.b64.txt` kann auf dem
Zielsystem beispielsweise mit `certutil.exe` zurückgewandelt werden:

```cmd
certutil.exe -decode BizTalkPlatformManagementTool-Setup.zip.b64.txt BizTalkPlatformManagementTool-Setup.zip
```

Anschließend die SHA-256-Prüfsumme mit
`BizTalkPlatformManagementTool-Setup.zip.sha256.txt` vergleichen.

## Erster Funktionstest

1. Tool über Startmenü oder Desktop-Verknüpfung starten.
2. Dry-run aktiviert lassen.
3. **Verbindung prüfen** ausführen.
4. **Zustand erfassen** ausführen.
5. JSON-, CSV- und HTML-Dateien im Arbeitsordner prüfen.
6. **Herunterfahren** im Dry-run ausführen und den Plan kontrollieren.