BizTalkPlatformManagementTool/Installation.md

Installation

Voraussetzungen

• Windows Server 2019/2022 oder ein Windows-Administrationshost
• Microsoft BizTalk Server 2020 oder BizTalk Administration Tools
• .NET Framework 4.6.1 Runtime
• Für Builds: Visual Studio mit .NET Framework 4.6.1 Developer Pack
• Zugriff auf den WMI-Namespace root\MicrosoftBizTalkServer
• Ausreichende Rechte zum Lesen und Ändern von BizTalk-Artefakten
• Schreibrechte im Verzeichnis der EXE für die tägliche Logdatei

Build

1. Repository öffnen.
2. BizTalkPlatformManagementTool.sln in Visual Studio öffnen.
3. Konfiguration Release|Any CPU auswählen.
4. Solution bauen.
5. Das Ergebnis liegt unter src\BizTalkPlatformManagementTool\bin\Release\.

Deployment

1. Den Release-Ordner auf einen BizTalk-Server oder einen Administrationshost kopieren.
2. Sicherstellen, dass der ausführende Benutzer WMI-Zugriff auf root\MicrosoftBizTalkServer hat.
3. BizTalkPlatformManagementTool.exe starten.
4. Als Ausgabeverzeichnis einen Ordner wählen, in dem Plan-, Snapshot- und Report-Dateien abgelegt werden dürfen.
5. Prüfen, dass im EXE-Verzeichnis BizTalkPlatformManagementTool-yyyy-MM-dd.log geschrieben werden kann. Logs werden für maximal fünf Tage vorgehalten.

Erster Funktionstest

1. Anwendung starten.
2. Zielserver eintragen oder den vorgeschlagenen lokalen Server verwenden.
3. Dry run aktiviert lassen.
4. Diagnose ausführen.
5. Snapshot Before ausführen und prüfen, ob before.json sowie CSV/HTML-Reports erzeugt wurden.

Produktive Nutzung

Vor produktiven Änderungen immer zuerst einen Dry-run ausführen und die erzeugten shutdown-plan.json beziehungsweise restore-plan.json prüfen. Dry-run erst deaktivieren, wenn der Plan fachlich und technisch korrekt ist.