60 lines
2.2 KiB
Markdown
60 lines
2.2 KiB
Markdown
# 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.
|