biztalk-checkmk-pulse/deployment/INSTALLATION.md

Installation auf dem BizTalk-Server

Falls nur die TXT-Datei uebertragen wurde:

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 BEW\t231bizmon.
4. Kennwort und Umgebung eingeben und Installieren / aktualisieren waehlen.
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.

Der Installer vergibt keine AD-, BizTalk- oder SQL-Berechtigungen. Das Konto muss separat Mitglied der fuer die BizTalk-Gruppe konfigurierten Read-Only- Gruppe sein und lokal das Recht Log on as a batch job besitzen.

Bei einer Deinstallation bleiben Snapshot und Logs absichtlich unter %ProgramData%\BizTalkCheckmkPulse erhalten. Sie koennen nach der Betriebsfreigabe manuell entfernt werden.