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