48 lines
2.3 KiB
Markdown
48 lines
2.3 KiB
Markdown
# 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
|
|
`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.
|