Fix legacy installer updates and diagnostics

deployment/INSTALLATION.md

@@ -28,14 +28,23 @@ nach dem nächsten Agentenlauf das 2.2.1-Fehlerbild `Item not found in
 monitoring data`. Nur bei bewusst auf `true` gesetztem Opt-in ist anschließend
 eine Checkmk Service Discovery erforderlich.
 
-Ab Version 2.2.3 vergleicht der Installer bei jedem Update die exakten
-Servicenamen der installierten und der vorbereiteten Version. Neue, entfernte
-oder umbenannte Services führen **vor dem Stoppen des Tasks** zu einem
-Sicherheitsstopp. Die Installation darf nur über die Checkbox
+Ab Version 2.2.5 vergleicht der Installer bei jedem Update die exakten
+Servicenamen der installierten und der vorbereiteten Version. Rein neue
+Services sind abwärtskompatibel, blockieren das Update nicht und werden als
+Hinweis für die anschließende Service Discovery angezeigt. Entfernte oder
+umbenannte Services führen **vor dem Stoppen des Tasks** zu einem
+Sicherheitsstopp. Die Installation darf dann nur über die Checkbox
 **Service-Rename ist beabsichtigt; Checkmk Service Discovery ist eingeplant**
 fortgesetzt werden. Der Installer zeigt dabei die entfernten und neuen Namen
 an. Eine bloß geänderte Ausgabereihenfolge gilt nicht als Rename.
 
+Version 2.2.5 akzeptiert außerdem den gültigen Self-Test einer installierten
+Legacy-Version mit weniger Services. Paket, Staging und aktivierte Zielversion
+müssen weiterhin exakt neun Services liefern. Damit kann insbesondere eine
+Version mit acht Services auf die Version mit dem zusätzlichen Service
+`BizTalk Endpoint Reachability` aktualisiert werden. Der frühere Abbruch
+`Exitcode=0, Zeilen=8` betraf die Altversion und war kein Fehler im neuen Paket.
+
 Version 2.2.4 nimmt die umgeschaltete Installation zusätzlich vollständig ab:
 
 - einmaliger, triggerloser Providerlauf unter dem angegebenen Collector-Konto,
@@ -55,6 +64,16 @@ Programmversion samt Task wiederhergestellt und ein frischer Lauf der alten
 Version abgewartet. Fehler in Paket-, Config- oder Rename-Vorprüfung treten vor
 jeder Taskänderung auf und lassen die laufende Installation unangetastet.
 
+Jeder Installations-/Updatelauf schreibt ein separates Diagnoselog nach
+`%ProgramData%\BizTalkCheckmkPulse\logs\setup-*.log`. Es enthält die aktuelle
+Phase, Pfad und Version jeder geprüften EXE, Exitcode, vollständiges stdout und
+stderr des Self-Tests, Taskstatus samt Dezimal-/Hexcode, Exception-Kette und
+Rollback-Ergebnis. Bei einem Runtime-Abnahmefehler werden zusätzlich die
+letzten Provider-Logzeilen übernommen. Das Collector-Kennwort wird weder an
+das Logging übergeben noch protokolliert. Ein abgeschlossener Providerlauf mit
+Fehlercode beendet die Abnahme sofort; nur ein noch laufender Task wird bis zur
+Timeoutgrenze abgewartet.
+
 Beim korrigierenden Wechsel von 2.2.1 mit `BizTalk ACC ...` auf stabile
 `BizTalk ...`-Namen ist die Änderung beabsichtigt: Checkbox aktivieren und den
 Servicebestand danach per Discovery abgleichen. Sind in Checkmk bereits die