BizTalkPlatformManagementTool/Installation.md

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:

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.