40 lines
1.7 KiB
Markdown
40 lines
1.7 KiB
Markdown
# 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.
|