Harden BizTalk maintenance workflow and add installer

Installation.md

@@ -1,40 +1,59 @@
-# Installation
+# Installation und Update
 
 ## 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
-- Lokale Administratorrechte und Start der EXE mit **Als Administrator ausführen**
-- Schreibrechte im Verzeichnis der EXE für die tägliche Logdatei
+- 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`
 
-## Build
+## Installation
 
-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\`.
+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.
 
-## Deployment
+Installiert wird nach `%ProgramFiles%\BizTalkPlatformManagementTool`.
+Persistente Wartungszustände und Logs liegen getrennt unter
+`%ProgramData%\BizTalkPlatformManagementTool`.
 
-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` mit **Als Administrator ausführen** 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.
+## 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. Anwendung mit **Als Administrator ausführen** 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.
+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.