KNW-1727 ready for review

eseyffarth · eseyffarth · commit 9100f504460a · 2025-08-21T12:46:17.000+02:00
diff --git a/src/common/de/cmc_differences.asciidoc b/src/common/de/cmc_differences.asciidoc
@@ -1,6 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE % Linge lt site_name
-// SKIPCOMMITS 2025-07-17
+// SKIPCOMMITS 2025-08-21
 include::global_attr.adoc[]
 = Besonderheiten des CMC
 :revdate: 2024-09-02
@@ -273,7 +273,10 @@ Die Vorteile:
 * Einfachere Implementierung mit deutlich mehr Stabilität.
 
 ifdef::onprem[]
-Das Neuanlegen von RRDs erledigt der CMC mit einem weiteren Helper, der per `cmk --create-rrd` aufgerufen wird. 
+// Das Neuanlegen von RRDs erledigt der CMC mit einem weiteren Helper, der per `cmk --create-rrd` aufgerufen wird. // alter Befehl
+Das Neuanlegen von RRDs erledigt der CMC mit einem weiteren Helper.
+// ES: Der Befehl selbst wird ja durch den CMC ausgeführt und nicht durch den Benutzer. Eigentlich braucht es hier keine Details zum Aufruf des Helpers, oder? Falls doch:
+// Das Neuanlegen von RRDs erledigt der CMC mit einem weiteren Helper, der per `cmk-create-rrd` aufgerufen wird. // neuer Befehl seit https://checkmk.com/de/werk/17387
 Dieser legt die Dateien wahlweise kompatibel zu PNP an oder alternativ im neuen {CMK}-Format (gilt nur für Neuinstallationen). 
 Ein Wechsel von Nagios auf CMC hat daher keinen Einfluss auf bestehende RRD-Dateien. 
 Diese werden nahtlos weiter gepflegt.
diff --git a/src/common/de/graphing.asciidoc b/src/common/de/graphing.asciidoc
@@ -524,18 +524,21 @@ dann nicht mehr Minuten bedeuten, sondern die in [.guihint]#Step (precision)# ei
 Zeitspanne.
 
 Jede Änderung des RRD-Aufbaus hat zunächst nur Einfluss auf
-*neu angelegte* RRDs -- sprich wenn Sie neue Hosts oder Services in das
+*neu angelegte* RRDs -- sprich: wenn Sie neue Hosts oder Services in das
 Monitoring aufnehmen. Sie können aber die bestehenden RRDs von {CMK} umbauen
-lassen. Dazu dient der Befehl `cmk --convert-rrds`, bei welchem sich
+lassen. Dazu dient der Befehl `cmk-convert-rrds`, bei welchem sich
 immer die Option `-v` (verbose) anbietet. {CMK} kontrolliert dann
 alle vorhandenen RRDs und baut diese nach Bedarf in das eingestellte
 Zielformat um.
 
-*Wichtig:* Um die Integrität der in den RRDs enthaltenen Daten sicherzustellen, stoppen Sie stets Ihre Instanz (mit `omd stop`) *bevor* Sie mit `cmk --convert-rrds` existierende RRDs konvertieren.  
+[IMPORTANT]
+====
+Um die Integrität der in den RRDs enthaltenen Daten sicherzustellen, stoppen Sie stets Ihre Instanz (mit `omd stop`), *bevor* Sie mit `cmk-convert-rrds` existierende RRDs konvertieren.  
+====
 
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds
+{c-omd} cmk-convert-rrds -v
 myserver012:
   Uptime (CMC).....converted, 376 KB -> 159 KB
   Filesystem / (CMC).....converted, 1873 KB -> 792 KB
@@ -550,7 +553,7 @@ Der Befehl ist intelligent genug, um RRDs zu erkennen, die bereits den
 richtigen Aufbau haben:
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds
+{c-omd} cmk-convert-rrds -v
 myserver345:
   Uptime (CMC).....uptodate
   Filesystem / (CMC).....uptodate
@@ -592,20 +595,20 @@ Format konvertiert worden sind. Sollten die Daten noch im alten Format
 vorliegen, können Sie diese über das Anlegen einer Regel im oben gezeigten
 Regelsatz auf das {CMK}-Format umstellen. 
 
-Auch hier benötigen Sie anschließend den Befehl `cmk --convert-rrds`, und auch hier gilt: Stoppen Sie stets Ihre Instanz, bevor Sie existierende RRDs konvertieren.
+Auch hier benötigen Sie anschließend den Befehl `cmk-convert-rrds`, und auch hier gilt: Stoppen Sie stets Ihre Instanz, bevor Sie existierende RRDs konvertieren.
 
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds
+{c-omd} cmk-convert-rrds -v
 myhost123:
    Uptime PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/Uptime. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/Uptime. Use --delete-rrds for cleanup.
    OMD mysite apache PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
    fs_/home/user PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/fs_/home/user. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/fs_/home/user. Use --delete-rrds for cleanup.
    OMD mysite apache PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
    Memory PNP -> CMC..converted.
 ...
 ----
@@ -619,7 +622,7 @@ bequem später mit einem weiteren Aufruf des Befehls erledigen:
 
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds --delete-rrds
+{c-omd} cmk-convert-rrds -v --delete-rrds
 ----
 endif::[]
 
diff --git a/src/common/en/cmc_differences.asciidoc b/src/common/en/cmc_differences.asciidoc
@@ -1,6 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE % Jörg Linge lt site_name
-// SKIPCOMMITS 2025-07-17
+// SKIPCOMMITS 2025-08-21
 include::global_attr.adoc[]
 = Special characteristics of the CMC
 :revdate: 2024-09-02
@@ -269,7 +269,10 @@ The advantages:
 * Simpler implementation with markedly more stability
 
 ifdef::onprem[]
-The installation of new RRDs is performed by the CMC with a further helper, activated by `cmk --create-rrd`.
+The installation of new RRDs is performed by the CMC with a further helper.
+// , activated by `cmk --create-rrd`. // old command
+// , activated by `cmk-create-rrd`. // new command since https://checkmk.com/de/werk/17387
+// ES: see my comments in the German version of this article
 This optionally creates files compatible with PNP, or with the new {CMK} format (only for new installations).
 A switch from Nagios to CMC has no effect on existing RRD files -- these will be seamlessly carried-over and will continue to be maintained.
 
diff --git a/src/common/en/graphing.asciidoc b/src/common/en/graphing.asciidoc
@@ -1,5 +1,6 @@
 // -*- coding: utf-8 -*-
 // IGNORE % + 1m @
+// SKIPCOMMITS 2025-08-21
 include::global_attr.adoc[]
 = Measured values and graphing
 :revdate: 2025-07-14
@@ -497,16 +498,19 @@ represent minutes, but instead the time interval set in [.guihint]#Step (precisi
 Every change to the RRD structure initially has an effect only on
 *newly created* RRDs -- that is to say, on hosts or services
 newly-incorporated into the monitoring. You can also allow {CMK} to
-restructure existing RRDs. This is performed by the `cmk --convert-rrds`
+restructure existing RRDs. This is performed by the `cmk-convert-rrds`
 command, for which the `-v` (verbose) option is always available.
 {CMK} will then inspect all existing RRDs and restructure them as needed
 into the defined target format.
 
-*Important:* To ensure the integrity of the data contained in the RRDs, always stop your site (with `omd stop`) *before* converting existing RRDs with `cmk --convert-rrds`.  
+[IMPORTANT]
+====
+To ensure the integrity of the data contained in the RRDs, always stop your site (with `omd stop`) *before* converting existing RRDs with `cmk-convert-rrds`.
+====
 
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds
+{c-omd} cmk-convert-rrds -v
 myserver012:
    Uptime (CMC).....converted, 376 KB -> 159 KB
    Filesystem / (CMC).....converted, 1873 KB -> 792 KB
@@ -522,7 +526,7 @@ desired structure:
 
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds
+{c-omd} cmk-convert-rrds -v
 myserver345:
    Uptime (CMC).....uptodate
    Filesystem / (CMC).....uptodate
@@ -562,20 +566,20 @@ data was ever converted to the current and much more efficient format. Should th
 data still be stored in PNP format you can convert it into the {CMK} format by
 applying a rule as shown in the rule set above. 
 
-Here, too, you will also require the `cmk --convert-rrds` command, and again, always stop your site before converting existing RRDs.
+Here, too, you will also require the `cmk-convert-rrds` command, and again, always stop your site before converting existing RRDs.
 
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds
+{c-omd} cmk-convert-rrds -v
 myhost123:
    Uptime PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/Uptime. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/Uptime. Use --delete-rrds for cleanup.
    OMD mysite apache PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
    fs_/home/user PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/fs_/home/user. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/fs_/home/user. Use --delete-rrds for cleanup.
    OMD mysite apache PNP -> CMC..converted.
-  WARNING: Dupliate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
+  WARNING: Duplicate RRDs for stable/OMD mysite apache. Use --delete-rrds for cleanup.
    Memory PNP -> CMC..converted.
 ...
 ----
@@ -589,7 +593,7 @@ command:
 
 [{shell}]
 ----
-{c-omd} cmk -v --convert-rrds --delete-rrds
+{c-omd} cmk-convert-rrds -v --delete-rrds
 ----
 endif::[]
 
diff --git a/src/onprem/de/cmk_commandline.asciidoc b/src/onprem/de/cmk_commandline.asciidoc
@@ -1,7 +1,7 @@
 // -*- coding: utf-8 -*-
 // IGNORE % Benachrichtigungs WATO
 // NONASCII ├ ─ └ │ …​ °
-// SKIPCOMMITS 2025-07-22
+// SKIPCOMMITS 2025-08-21
 include::global_attr.adoc[]
 = {CMK} auf der Kommandozeile
 :revdate: 2024-03-06
@@ -588,7 +588,8 @@ Hier folgt die Übersicht der Optionen, die wir in diesem Kapitel, aber auch an
 |`cmk --update-dns-cache` |Löscht den DNS-Cache und erzeugt ihn neu. Details zum DNS-Cache finden Sie im xref:hosts_setup#dns[Artikel über die Hosts.] Dieser Befehl wird in einer {CMK}-Instanz standardmäßig einmal am Tag per Cronjob durchgeführt.
 |`cmk --cleanup-piggyback` |Löscht alle veralteten xref:piggyback#[Piggyback-Daten] im Verzeichnis `tmp/check_mk/piggyback/`. Dieser Befehl wird in einer {CMK}-Instanz standardmäßig einmal am Tag per Cronjob durchgeführt.
 |`cmk -P` |xref:mkps#commandline[MKPs verwalten]
-|`cmk --convert-rrds` |xref:graphing#customise_rrds[RRDs konvertieren]
+// |`cmk --convert-rrds` |xref:graphing#customise_rrds[RRDs konvertieren]
+// ES: Dieser Befehl heißt jetzt cmk-convert-rrds und passt damit nicht mehr sinnvoll in diese Tabelle. Vorschlag: Weiteren Abschnitt hiernach einfügen für Befehle, die cmk-<irgendwas> heißen (und ggf. früher mal als cmk --<irgendwas> aufgerufen wurden). Dorthin passt auch z.B. der mit https://checkmk.com/de/werk/17398 eingeführte commandline helper cmk-piggyback, cmk-passwd und ähnliche Skripte, die (teilweise oder ausschließlich) für die Nutzung durch den OMD-Benutzer gedacht sind.
 |`cmk --snmpwalk myswitch` |xref:snmp#simulation[SNMP-Walk ziehen] vom Host `myswitch`
 |`cmk --snmptranslate` |xref:devel_check_plugins_snmp#locating_oids[SNMP-Walk übersetzen]
 |`cmk --create-diagnostics-dump` |xref:support_diagnostics#commandline[Support Diagnostics Dump erstellen]
diff --git a/src/onprem/en/cmk_commandline.asciidoc b/src/onprem/en/cmk_commandline.asciidoc
@@ -558,7 +558,8 @@ Here follows the overview of the options we will present in this chapter, but al
 |`cmk --update-dns-cache` |Deletes the DNS cache and re-creates it. For details on the DNS cache, see the xref:hosts_setup#dns[article on hosts]. By default, this command is executed in a {CMK} site once a day via cronjob.
 |`cmk --cleanup-piggyback` |Deletes all obsolete xref:piggyback#[piggyback data] in the `tmp/check_mk/piggyback/` directory. By default, this command is executed in a {CMK} site once a day via cronjob.
 |`cmk -P` |xref:mkps#commandline[Managing MKPs]
-|`cmk --convert-rrds` |xref:graphing#customise_rrds[Converting RRDs]
+// |`cmk --convert-rrds` |xref:graphing#customise_rrds[Converting RRDs]
+// ES: See my comments in the German version of this article
 |`cmk --snmpwalk myswitch` |xref:snmp#simulation[Pulling an SNMP walk] from host `myswitch`
 |`cmk --snmptranslate` |xref:devel_check_plugins_snmp#locating_oids[Translating an SNMP walk]
 |`cmk --create-diagnostics-dump` |xref:support_diagnostics#commandline[Creating support diagnostics dump]
