Make installer runtime acceptance transactional

README.md

@@ -141,8 +141,11 @@ Pro Service werden standardmäßig maximal fünf betroffene Namen gezeigt.
 Weitere Treffer erscheinen nur als `(+n more)`; Details sind zusätzlich auf
 1600 Zeichen begrenzt. Metriken bleiben trotzdem vollständig.
 
-Mit `EnvironmentName=ACC`, `DEV`, `TST` oder `PRD` wird die Umgebung in den
-Servicenamen aufgenommen, zum Beispiel `BizTalk ACC Platform`.
+`EnvironmentName=ACC`, `DEV`, `TST` oder `PRD` kennzeichnet Snapshot und
+Endpoint-Katalog. Die neun Checkmk-Servicenamen bleiben standardmäßig
+unverändert. Nur das explizite Opt-in
+`IncludeEnvironmentInServiceName=true` ergänzt die Umgebung im Servicenamen
+und verlangt anschließend eine Checkmk Service Discovery.
 
 Statuslogik und Metriken: [docs/CheckmkServices.md](docs/CheckmkServices.md)
 
@@ -217,7 +220,9 @@ artifacts\BizTalkCheckmkPulse-Setup\application\BizTalkCheckmkPulse.exe --self-t
 
 Erwartet werden exakt neun `OK`-Zeilen. Die Regressionstests prüfen
 zusätzlich Snapshot-Roundtrip, atomaren Ersatz, SHA-256-Manipulation,
-Stale-Erkennung, stabile Fallbacks und die bestehenden BizTalk-WMI-Diagnosen.
+Stale-Erkennung, stabile Fallbacks, den exakten Servicevertrag, erzwungene
+Katalogaktualisierung sowie erfolgreiche und abgewiesene
+Post-Install-Runtime-Abnahmen.
 Ein Mono-Build ist eine hilfreiche Quellcodeprüfung, ersetzt aber nicht die
 Windows-/BizTalk-Laufzeitvalidierung.
 
@@ -265,17 +270,26 @@ Der Installer:
 2. baut die neue Version in einem Staging-Verzeichnis auf und übernimmt
    vorhandene AppSettings; neue Keys erhalten ihre neuen Defaults. Die alten
    unveränderten Endpoint-Defaults `12`/`500` werden auf `16`/`100` migriert,
-3. schaltet die Programmdateien per Verzeichniswechsel um; bei einem Fehler
-   werden vorherige Version, Wrapper und Task best effort wiederhergestellt,
-4. behält `%ProgramData%\BizTalkCheckmkPulse` mit Endpoint-Katalog, Snapshot
+3. vergleicht installierten und neuen Checkmk-Servicevertrag; ein
+   unbestätigter Rename stoppt vor jeder Umschaltung,
+4. schaltet die Programmdateien per Verzeichniswechsel um,
+5. startet einen triggerlosen Provider-Abnahmelauf unter dem echten
+   Collector-Konto und erzwingt einen vollständigen Endpoint-Katalogabgleich,
+6. wartet höchstens vier Minuten auf `LastTaskResult=0` und validiert danach
+   mit der Produkt-EXE einen erst nach Installationsbeginn erzeugten Snapshot,
+   die Collector-Identität, alle neun eindeutigen Services ohne `UNKNOWN`
+   sowie den frischen, maschinen- und umgebungsgebundenen Endpoint-Katalog,
+7. registriert erst nach dieser Abnahme den normalen Minutentask; andernfalls
+   werden vorherige Version, Wrapper und Task samt frischem Altsnapshot
+   wiederhergestellt,
+8. behält `%ProgramData%\BizTalkCheckmkPulse` mit Endpoint-Katalog, Snapshot
    und Logs bei,
-5. installiert EXE und Config nach `%ProgramFiles%\BizTalkCheckmkPulse`,
-6. setzt explizite ACLs für Administratoren, Provider und `LocalSystem`,
-7. installiert nur den kleinen `.cmd`-Consumer unter
+9. installiert EXE und Config nach `%ProgramFiles%\BizTalkCheckmkPulse`, setzt
+   explizite ACLs für Administratoren, Provider und `LocalSystem` und
+   installiert nur den kleinen `.cmd`-Consumer unter
    `%ProgramData%\checkmk\agent\local`,
-8. registriert `BizTalk Checkmk Pulse Provider` minütlich mit
-   `IgnoreNew`, fünf Minuten Laufzeitlimit und zwei Wiederholungen,
-9. führt den installierten Self-Test erneut aus und startet den Provider.
+10. registriert `BizTalk Checkmk Pulse Provider` minütlich mit `IgnoreNew`,
+    fünf Minuten Laufzeitlimit und zwei Wiederholungen.
 
 Installation, Update, Deinstallation und Laufzeit verwenden keine PowerShell.
 
@@ -356,6 +370,7 @@ Wichtige Werte:
 | Key | Default | Bedeutung |
 | --- | --- | --- |
 | `EnvironmentName` | leer | Optional `ACC`, `DEV`, `TST`, `PRD`. |
+| `IncludeEnvironmentInServiceName` | `false` | Nur mit geplanter Service Discovery aktivieren. |
 | `SnapshotPath` | `%ProgramData%\BizTalkCheckmkPulse\data\...` | Gemeinsame Provider-/Consumer-Datei. |
 | `SnapshotMaxAgeSeconds` | `180` | Ab diesem Alter liefert der Consumer `UNKNOWN`. |
 | `SnapshotMaxBytes` | `1048576` | Harte Eingabegröße für den Consumer. |