Harden ACC installer update and endpoint performance

2026-08-04 10:27:10 +02:00
parent 22a4725056
commit 8888ab97c0
23 changed files with 581 additions and 77 deletions
@@ -1,5 +1,12 @@
 # Installation auf dem BizTalk-Server

+Falls nur die TXT-Datei uebertragen wurde:
+
+```cmd
+certutil -decode BizTalkCheckmkPulse-Setup.zip.b64.txt BizTalkCheckmkPulse-Setup.zip
+certutil -hashfile BizTalkCheckmkPulse-Setup.zip SHA256
+```
+
 1. `BizTalkCheckmkPulse-Setup.zip` vollstaendig in ein lokales Verzeichnis entpacken.
 2. `Setup.exe` als lokaler Administrator starten und die UAC-Abfrage bestaetigen.
 3. Das Collector-Konto im Format `DOMAIN\Benutzer` eingeben, zum Beispiel
@@ -8,6 +15,25 @@
 5. Im Aufgabenplaner den Task `BizTalk Checkmk Pulse Provider` und danach den
   Checkmk-Agent-Dump kontrollieren.

+Bei einer bereits vorhandenen ACC-Installation ist dies ein Update. Der
+Installer erkennt die bestehende Umgebung, behaelt Endpoint-Katalog, Snapshot
+und Logs sowie vorhandene AppSettings bei und ergaenzt neue Config-Keys aus dem
+Paket. Das BEW-Konto und sein aktuelles Kennwort muessen erneut eingegeben
+werden, weil der Scheduled Task mit den bestaetigten Zugangsdaten neu
+registriert wird.
+
+Die frueheren unveraenderten Endpoint-Defaults `12` parallele Probes und
+`EndpointMaxCount=500` werden beim Update auf `16` beziehungsweise `100`
+migriert. Abweichende, bewusst konfigurierte Werte bleiben erhalten.
+
+Vor dem Stoppen des vorhandenen Tasks wird die neue Version separat getestet.
+Bei normalen Servicekonten prueft der Installer ausserdem Kennwort und
+Batch-Anmelderecht vor der Umschaltung.
+Der Task wird vor dem Dateitausch deaktiviert und sein Prozessende maximal zehn
+Sekunden abgewartet, damit keine laufende Provider-EXE ueberschrieben wird.
+Bei einem Fehler nach der Umschaltung versucht der Installer, vorherige
+Programmdateien, Wrapper und Task wiederherzustellen.
+
 PowerShell wird fuer Installation, Update, Deinstallation und Laufzeit nicht
 benoetigt. Das Kennwort wird direkt an die Windows-Aufgabenplanung uebergeben
 und weder in einer Datei noch in einer Prozesskommandozeile abgelegt.