added a chapter about auxiliary processes

Author: sebkir

src/onprem/de/cmc_migration.asciidoc

@@ -16,7 +16,7 @@ xref:cmc_files#[Dateien und Verzeichnisse des CMC]
 == Umstellung von Nagios auf CMC
 
 Neue Instanzen werden von den kommerziellen Editionen automatisch mit dem xref:cmc#[{CMK} Micro Core (CMC)] als Kern erzeugt.
-Wenn Ihre Instanz von einer älteren Version stammt, können Sie diese nachträglich von Nagios auf CMC umstellen. 
+Wenn Ihre Instanz von einer älteren Version stammt, können Sie diese nachträglich von Nagios auf CMC umstellen.
 Der Vorgang an sich ist dabei sehr einfach:
 
 Stoppen Sie zunächst Ihre {CMK}-Instanz:
@@ -40,15 +40,15 @@ Vergessen Sie danach nicht das Starten:
 {c-omd} omd start
 ----
 
-*Achtung:* Der aktuelle Status des Kerns (aktueller Zustand von Hosts und Services, etc.) wird dabei _nicht_ übernommen. 
-Sobald jeder Check einmal ausgeführt wurde, hat das System den Status aber ohnehin wieder ermittelt. 
-Dabei werden alle Hosts und Services, die nicht {UP} bzw. {OK} sind, *neu benachrichtigt.* 
-Wenn Sie das nicht wünschen, dann schalten Sie vor der Umstellung die Benachrichtigungen (_notifications_) ab -- 
+*Achtung:* Der aktuelle Status des Kerns (aktueller Zustand von Hosts und Services, etc.) wird dabei _nicht_ übernommen.
+Sobald jeder Check einmal ausgeführt wurde, hat das System den Status aber ohnehin wieder ermittelt.
+Dabei werden alle Hosts und Services, die nicht {UP} bzw. {OK} sind, *neu benachrichtigt.*
+Wenn Sie das nicht wünschen, dann schalten Sie vor der Umstellung die Benachrichtigungen (_notifications_) ab --
 mit dem Snapin xref:user_interface.html#master_control[Master control] der Seitenleiste.
-xref:basics_downtimes#[Wartungszeiten] und Kommentare werden aber übernommen, ebenso wie historische 
+xref:basics_downtimes#[Wartungszeiten] und Kommentare werden aber übernommen, ebenso wie historische
 Messdaten in den xref:graphing.html#rrds[RRDs].
 
-Die Historie der Ereignisse (Nagios-Log) wird vom CMC in einem kompatiblen Format, allerdings an einer anderen Stelle (`var/check_mk/core/history`) gepflegt. 
+Die Historie der Ereignisse (Nagios-Log) wird vom CMC in einem kompatiblen Format, allerdings an einer anderen Stelle (`var/check_mk/core/history`) gepflegt.
 Das Log-Archiv befindet sich in `var/check_mk/core/archive`.
 Wenn Sie eine Übernahme der historischen Ereignisse (z.B. für die xref:availability#[Verfügbarkeit]) wünschen, so kopieren Sie die nötigen Dateien auf der Kommandozeile:
 
@@ -78,30 +78,43 @@ Nagios wird aber seinen alten Zustand von vor der Migration zu CMC wieder einles
 Um den CMC so schlank und effizient wie möglich zu halten und an wichtigen Stellen zu modernisieren, wurden nicht alle Funktionen von Nagios 1:1 nachprogrammiert.
 Das bedeutet, dass Sie eventuell an einigen Stellen Ihre Konfiguration anpassen müssen.
 
-Grundsätzlich kann der CMC keine Nagios-Konfigurationsdateien einlesen. 
-Sollten Sie also Teile der Nagios-Dateien von Hand geschrieben haben oder Konstrukte wie `extra_nagios_conf` in der Datei `main.mk` verwenden, so können diese nicht verarbeitet werden. 
-Wenn Sie immer mit dem xref:wato#setup_menu[Setup] der Weboberfläche gearbeitet haben, ist keine Anpassung notwendig. 
+Grundsätzlich kann der CMC keine Nagios-Konfigurationsdateien einlesen.
+Sollten Sie also Teile der Nagios-Dateien von Hand geschrieben haben oder Konstrukte wie `extra_nagios_conf` in der Datei `main.mk` verwenden, so können diese nicht verarbeitet werden.
+Wenn Sie immer mit dem xref:wato#setup_menu[Setup] der Weboberfläche gearbeitet haben, ist keine Anpassung notwendig.
 
 In den folgenden Abschnitten finden Sie eine Aufstellung aller Dinge, die Sie eventuell von Hand in Nagios konfiguriert haben und die beim CMC nicht oder anders umgesetzt sind.
 
 
+=== Hilfsprozesse
+
+Mit der Verwendung des CMC ändert sich die Art und Weise, wie Daten eingesammelt und anschließend geprüft werden, grundlegend.
+Deshalb ist es bei einer Umstellung auf den CMC - besonders bei Instanzen mit mehreren tausend Hosts - wahrscheinlich erforderlich, die Zahl der voreingestellten {CMK} Checker und Fetcher zu prüfen und anzupassen.
+Einen ersten Hinweis darauf kann schon die Funktion xref:analyze_configuration#[Analyze configuration] liefern.
+Wir empfehlen allerdings dringend, das Kapitel xref:cmc_differences#aux_processes[Hilfsprozesse] im Handbuch zu lesen.
+
+Und für alle, die es eilig haben:
+
+* [.guihint]#Maximum concurrent {CMK} checkers# = Anzahl an Prozessorkernen Ihres Servers
+* [.guihint]#Maximum concurrent {CMK} fetchers# = Jeder Fetcher benötigt *ungefähr* 50 MB Arbeitsspeicher - also gerne hochdrehen.
+
+
 === Event Handler
 
-Der CMC unterstützt keine klassischen Nagios Event Handler. 
+Der CMC unterstützt keine klassischen Nagios Event Handler.
 Die kommerziellen Editionen haben aber dafür die sogenannten xref:alert_handlers.html[Alert Handler], die deutlich flexibler sind.
 Sie können über [.guihint]#Setup > Events > icon:icon_alert_handlers[] Alert handlers# konfiguriert werden.
 
 
-=== Service-Abhängigkeiten 
+=== Service-Abhängigkeiten
 
-Service-Abhängigkeiten (_service dependencies_) werden vom CMC aktuell nicht unterstützt. 
-// Es ist möglich, dass das später noch implementiert wird. 
+Service-Abhängigkeiten (_service dependencies_) werden vom CMC aktuell nicht unterstützt.
+// Es ist möglich, dass das später noch implementiert wird.
 Da Serviceabhängigkeiten in Nagios umständlich zu konfigurieren und sehr intransparent für den Benutzer sind, ist auch nicht geplant, sie in dieser Form umzusetzen.
 
 
 === Event-Broker-Module
 
-xref:livestatus#[Livestatus] und die Verarbeitung von Performance-Daten sind im CMC fest integriert. 
+xref:livestatus#[Livestatus] und die Verarbeitung von Performance-Daten sind im CMC fest integriert.
 Andere Module können nicht geladen werden.
 
 
@@ -112,18 +125,18 @@ Die Eskalation von Benachrichtigungen wird nicht mehr im Kern gesteuert, sondern
 
 === Zeitperioden
 
-Bei den xref:timeperiods#[Zeitperioden] (_time periods_) sind einige der Ausnahmedefinitionen, welche in Nagios funktionieren, nicht möglich. 
+Bei den xref:timeperiods#[Zeitperioden] (_time periods_) sind einige der Ausnahmedefinitionen, welche in Nagios funktionieren, nicht möglich.
 Aktuell wird nur das Format `YYYY-MM-DD`, also z.B. `1970-12-18`, unterstützt, nicht aber ein Format wie `february -2`.
 Mit [.guihint]#Setup > General > icon:icon_timeperiods[] Time periods# gibt es aber die Möglichkeit, Kalenderdateien im iCal-Format zu importieren.
 
 
 === Konfigurationsvariable legacy_checks
 
-Die Konfigurationsvariable `legacy_checks`, mit der in alten {CMK}-Versionen aktive Checks konfiguriert wurden, gibt es nicht mehr. 
+Die Konfigurationsvariable `legacy_checks`, mit der in alten {CMK}-Versionen aktive Checks konfiguriert wurden, gibt es nicht mehr.
 Natürlich können Sie auch mit dem CMC aktive Checks ausführen, nur in einer etwas anderen Form.
 
-Der Grund ist, dass die `legacy_checks` sich auf Kommandos beziehen, die man von Hand in der Nagios-Konfiguration anlegt und die dem CMC folglich nicht bereitstehen. 
-Anstelle dessen können Sie die moderneren `custom_checks` verwenden. 
+Der Grund ist, dass die `legacy_checks` sich auf Kommandos beziehen, die man von Hand in der Nagios-Konfiguration anlegt und die dem CMC folglich nicht bereitstehen.
+Anstelle dessen können Sie die moderneren `custom_checks` verwenden.
 Diese verwalten sie mit dem Regelsatz [.guihint]#Integrate Nagios plugins#, den Sie in [.guihint]#Setup > Services > Other services# finden -- und übrigens auch ohne CMC nutzen können.
 
 Folgendes Beispiel zeigt, wie Sie einen bestehenden Legacy-Check ...
@@ -170,12 +183,12 @@ Die neue Methode funktioniert auch mit Nagios als Kern, so dass Sie nach der Ums
 Der CMC verwendet für Host-Checks als Standard xref:cmc_differences.html#smartping[Smart Ping].
 Das bedeutet, dass nach einer Umstellung vom Nagios Kern,
 
-* die Host-Checks zunächst keine Performance-Daten mehr liefern und 
+* die Host-Checks zunächst keine Performance-Daten mehr liefern und
 * die manuell erzeugten Ping-Checks auf Hosts ohne sonstige Checks per Default Performance-Daten erzeugen.
 
 Wenn Sie die Ping-Performance-Daten für einzelne oder alle Hosts benötigen, dann empfehlen wir einen xref:active_checks#[aktiven Check] per Ping für die gewünschten Hosts hinzuzufügen mit dem Regelsatz [.guihint]#Check hosts with PING (ICMP Echo Request)#.
 
 Wenn Sie die bestehenden xref:graphing.html#rrds[Round-Robin-Datenbanken (RRDs)] weiterführen möchten, können Sie einfach -- während der Kern angehalten ist -- die Dateien in den Verzeichnissen `var/pnp4nagios/perfdata/<hostname>`, die mit `pass:[_HOST_]` beginnen umbenennen: von `pass:[_HOST_*]` nach `pass:[PING*]`.
 
-Alternativ können Sie Smart Ping auch mit dem Regelsatz [.guihint]#Host Check Command# abschalten und durch einen klassischen Ping ersetzen, der intern wie gehabt mit `check_icmp` arbeitet. 
-In diesem Fall müssen Sie die RRDs nicht umbenennen, verzichten aber auf die Vorzüge von Smart Ping. 
+Alternativ können Sie Smart Ping auch mit dem Regelsatz [.guihint]#Host Check Command# abschalten und durch einen klassischen Ping ersetzen, der intern wie gehabt mit `check_icmp` arbeitet.
+In diesem Fall müssen Sie die RRDs nicht umbenennen, verzichten aber auf die Vorzüge von Smart Ping.

src/onprem/en/cmc_migration.asciidoc

@@ -83,16 +83,29 @@ If you have always worked with the xref:wato#setup_menu[Setup] of the web interf
 In the following sections you will find a summary of all items that could have been manually configured in Nagios, but which cannot be realized (or for which a different procedure is needed) in the CMC:
 
 
+=== Auxiliary processes
+
+Using the CMC fundamentally changes the way in which data is collected and subsequently checked.
+Therefore, when switching to the CMC - especially for instances with several thousand hosts - it is probably necessary to check and adjust the number of preset {CMK} checkers and fetchers.
+The xref:analyze_configuration#[Analyze configuration] function can provide an initial indication of this.
+However, we strongly recommend reading the chapter xref:cmc_differences#aux_processes[auxiliary processes] in the manual.
+
+And for all those who are in a hurry:
+
+* [.guihint]#Maximum concurrent {CMK} checkers# = number of processor cores on your server
+* [.guihint]#Maximum concurrent {CMK} fetchers# = Each fetcher requires *approximately* 50 MB of memory - so feel free to crank it up.
+
+
 === Event handler
 
-The CMC supports no conventional Nagios event handler. 
+The CMC supports no conventional Nagios event handler.
 The commercial editions however have the so-called xref:alert_handlers.html[alert handlers] for this function, which are markedly more flexible.
 They can be configured via [.guihint]#Setup > Events > icon:icon_alert_handlers[] Alert handlers#.
 
 
 === Service dependencies
 
-This is not currently supported by the CMC. 
+This is not currently supported by the CMC.
 // It is possible that it may be implemented in the future.
 Because service dependencies are laborious to configure in Nagios, and are not very transparent for the user, there are no plans to implement them in this form.
 
@@ -121,7 +134,7 @@ The `legacy_checks` configuration variable used for configuring active checks in
 You can naturally execute active checks with the CMC, but in a somewhat different form.
 
 The reason for this is that the `legacy_checks` refer to commands that are manually defined in the Nagios configuration and which are consequently not available to the CMC.
-In lieu of these you can use the more modern `custom_checks`. 
+In lieu of these you can use the more modern `custom_checks`.
 You manage these with the  [.guihint]#Integrate Nagios plugins# rule set, which you can find in [.guihint]#Setup > Services > Other services# -- and by the way, you can also use these without the CMC.
 
 The following example shows how to change an existing legacy check ...