Skip to content

Commit 2ea25ed

Browse files
edition rename stabilization work KNW-2043, pick-25
1 parent 377b6ef commit 2ea25ed

2 files changed

Lines changed: 58 additions & 67 deletions

File tree

src/onprem/de/update.asciidoc

Lines changed: 30 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -27,28 +27,28 @@ Nehmen Sie als Beispiel folgende Situation auf einem fiktiven Server:
2727

2828
image::update1.png[alt="Drei Instanzen und ihre verwendeten Software-Versionen.",width=70%]
2929

30-
Hier verwendet die Instanz `mysite1` die Version `2.4.0p3.cee`, die Instanzen `mysite2` und `mysite3` die Version `2.4.0p1.cre`.
31-
Die {CMK}-Version `2.4.0p1.cce` ist zwar installiert, wird aber aktuell nicht verwendet.
30+
Hier verwenden die Instanzen `mysite1` und `mysite2` die Version `2.5.0p3.pro` und die Instanz `mysite3` die Version `2.5.0p1.community`.
31+
Die {CMK}-Version `2.5.0p3.ultimate` ist zwar installiert, wird aber aktuell nicht verwendet.
3232

3333
Dieses Beispiel macht klar, dass ein Update nicht einfach nur die Installation eines neuen RPM/DEB-Pakets von {CMK} auf dem Server bedeuten kann.
3434
Vielmehr braucht es dazu noch einen weiteren Schritt.
3535
Nehmen Sie nun als Beispiel folgende Situation:
3636

37-
image::update2.png[alt="Die Instanz 'mysite' mit ihrer verwendeten Software-Version vor dem Update.",width=70%]
37+
image::update2.png[alt="Die Instanz 'mysite3' mit ihrer verwendeten Software-Version vor dem Update.",width=70%]
3838

39-
Hier soll die Instanz `mysite` auf die {CMK}-Version `2.4.0p3.cee` aktualisiert werden.
39+
Hier soll die Instanz `mysite3` auf die {CMK}-Version `2.5.0p3.community` aktualisiert werden.
4040
Der erste Schritt ist das Herunterladen und Installieren des passenden RPM/DEB-Pakets.
4141
Dies geschieht genauso wie bei der xref:install_packages#[ersten Installation].
4242
Die neu installierte Version wird zunächst noch von keiner Instanz verwendet und das sieht dann so aus:
4343

44-
image::g42.png[alt="Die Situation nach der Installation der neuen Software-Version.",width=70%]
44+
image::update3.png[alt="Die Situation nach der Installation der neuen Software-Version.",width=70%]
4545

46-
Als zweiter Schritt erfolgt nun ein Update der Instanz von `2.4.0p1.cre` auf `2.4.0p3.cee`.
46+
Als zweiter Schritt erfolgt nun ein Update der Instanz von `2.5.0p1.community` auf `2.5.0p3.community`.
4747
Dies geschieht durch den Befehl `omd update`, welchen Sie weiter unten im Detail kennenlernen:
4848

4949
image::update4.png[alt="Mit 'omd update' erhält die Instanz die neue Software-Version.",width=70%]
5050

51-
Nach dem Update können Sie die (eventuell) nicht mehr benötigte Version `2.4.0p1.cre` durch das Deinstallieren des entsprechenden Pakets entfernen.
51+
Nach dem Update können Sie die (eventuell) nicht mehr benötigte Version `2.5.0p1.community` durch das Deinstallieren des entsprechenden Pakets entfernen.
5252

5353

5454
[#before_update]
@@ -188,9 +188,9 @@ Die Liste der installierten {CMK}-Versionen können Sie jederzeit mit dem Befehl
188188
[{shell}]
189189
----
190190
{c-root} omd versions
191-
{oldstable}p32.cre
192-
{current}.cee (default)
193-
{current}.cre
191+
{oldstable-patch}.cre
192+
{current}.pro (default)
193+
{current}.community
194194
----
195195

196196
Eine dieser Versionen ist mit `(default)` markiert.
@@ -200,10 +200,10 @@ Die aktuelle Standardversion können Sie mit `omd version` abfragen und mit `omd
200200
[{shell}]
201201
----
202202
{c-root} omd version
203-
OMD - Open Monitoring Distribution Version {current}.cee
204-
{c-root} omd setversion {current}.cre
203+
OMD - Open Monitoring Distribution Version {current}.pro
204+
{c-root} omd setversion {current}.community
205205
{c-root} omd version
206-
OMD - Open Monitoring Distribution Version {current}.cre
206+
OMD - Open Monitoring Distribution Version {current}.community
207207
----
208208

209209
Beim Verwalten _bestehender_ Instanzen spielt die Standardversion keine Rolle.
@@ -215,8 +215,8 @@ Eine Auflistung der aktuellen Instanzen und welche Versionen diese verwenden lie
215215
----
216216
{c-root} omd sites
217217
SITE VERSION COMMENTS
218-
mysite {oldstable}p32.cre
219-
test {current}.cre default version
218+
mysite {oldstable-patch}.cre
219+
test {current}.community default version
220220
----
221221

222222

@@ -251,21 +251,19 @@ Falls es mehr als eine mögliche Zielversion gibt, bekommen Sie diese zur Auswah
251251
++++
252252
include::update_omd-update-2.xml[]
253253
++++
254-
// image::update_omd-update-2.png[alt="Auswahl der Zielversion beim Update.",width=55%]
255254

256255
Bestätigen Sie in der folgenden Dialogbox das gewählte Update auf die neue Version:
257256

257+
// In der XML-Datei wird eine Patch-Version hardkodiert, während in den vorhergehenden und folgenden Befehlsausgaben mit {oldstable-patch} die aktuellste Patch-Version gezeigt wird.
258258
++++
259259
include::update_omd-update-3.xml[]
260260
++++
261-
// image::update_omd-update-3.png[alt="Bestätigungsdialog beim Update der Version.",width=63%]
262261

263262
Wenn Sie gleichzeitig zum _Versions-Update_ ein _Editions-Upgrade_ von einer {RE} auf eine der kommerziellen Editionen durchführen, werden Sie sicherheitshalber noch einmal auf diesen Umstand hingewiesen:
264263

265264
++++
266265
include::update_raw_to_enterprise.xml[]
267266
++++
268-
// image::update_raw_to_enterprise.png[alt="Bestätigungsdialog beim Upgrade der Edition.",width=38%]
269267

270268
Ein wichtiger Teil des Updates ist das Aktualisieren von mitausgelieferten Konfigurationsdateien.
271269
Dabei werden von Ihnen eventuell vorgenommene Änderungen in diesen Dateien nicht einfach verworfen, sondern zusammengeführt.
@@ -278,13 +276,13 @@ Das Update zeigt eine Liste aller angepassten Dateien und Verzeichnisse (im folg
278276

279277
[{shell},highlight=28]
280278
----
281-
2025-05-19 13:47:54 - Updating site 'mysite' from version {oldstable-patch}.cre to {current}.cre...
279+
2026-02-19 13:47:54 - Updating site 'mysite' from version {oldstable-patch}.cre to {current}.community...
282280
283281
* Updated .profile
284282
* Installed dir var/check_mk/packages_local
285283
...
286284
287-
Installed default file of version {current}.cre.
285+
Installed default file of version {current}.community.
288286
* Installed link etc/rc.d/60-ui-job-scheduler
289287
* Installed link etc/rc.d/85-rabbitmq
290288
...
@@ -305,7 +303,7 @@ Executing 'cmk-update-config --conflict ask --dry-run'
305303
-| Done (success)
306304
-|
307305
308-
Completed verifying site configuration. Your site now has version {current}.cre.
306+
Completed verifying site configuration. Your site now has version {current}.community.
309307
Executing update-pre-hooks script "01_mkp-disable-outdated"...OK
310308
Executing update-pre-hooks script "02_cmk-update-config"...
311309
-| ATTENTION
@@ -331,7 +329,7 @@ Wenn die in der obigen Ausgabe hervorgehobene Zeile `Completed verifying site co
331329
[{shell}]
332330
----
333331
{c-omd} omd version
334-
OMD - Open Monitoring Distribution Version {current}.cre
332+
OMD - Open Monitoring Distribution Version {current}.community
335333
----
336334

337335
… und kann gestartet werden:
@@ -419,7 +417,6 @@ In diesem Fall werden Sie als Benutzer eingeschaltet und können den Konflikt in
419417
++++
420418
include::omd-update.xml[]
421419
++++
422-
// image::omd-update.png[alt="Abfrage zur Lösung eines Konflikts.",width=83%]
423420

424421
Sie haben nun folgende Möglichkeiten:
425422

@@ -495,11 +492,11 @@ Mögliche Werte für `--conflict=` sind:
495492
|`--conflict=ask` |Dies ist das Standardverhalten, somit ist die Option in dieser Form eigentlich wirkungslos.
496493
|===
497494

498-
Ein Beispiel für den kompletten Befehl für ein automatisches Update der Instanz `mysite` auf die Version `{current}.cre`:
495+
Ein Beispiel für den kompletten Befehl für ein automatisches Update der Instanz `mysite` auf die Version `{current}.community`:
499496

500497
[{shell}]
501498
----
502-
{c-root} omd stop mysite ; omd -f -V {current}.cre update --conflict=install mysite && omd start mysite
499+
{c-root} omd stop mysite ; omd -f -V {current}.community update --conflict=install mysite && omd start mysite
503500
----
504501

505502
Durch das `&&` vor dem `omd start` wird ein Starten der Instanz verhindert, falls das `omd update` mit einem Fehler abbricht.
@@ -524,7 +521,7 @@ Ein kleines Shell-Skript könnte z.B. so aussehen:
524521
----
525522
#!/bin/bash
526523
SITE=$(omd sites --bare)
527-
VERSION={current}.cre
524+
VERSION={current}.community
528525
529526
omd stop $SITE
530527
omd -f -V $VERSION update --conflict=install $SITE && omd start $SITE
@@ -776,7 +773,6 @@ Wenn Sie nun beispielsweise von der {CE} auf die {SE} downgraden wollen, überze
776773
++++
777774
include::update_downgrade_ce_se.xml[]
778775
++++
779-
// image::update_downgrade_ce_se.png[alt="Bestätigungsdialog beim Downgrade der Edition.",width=30%]
780776

781777
Sobald Sie diese Abfrage mit [.guihint]#yes# bestätigen, geht das Downgrade unmittelbar los.
782778
Informieren Sie sich im Folgenden unbedingt, was *vor* diesem Downgrade zu erledigen ist.
@@ -862,18 +858,18 @@ So finden Sie heraus, welche Pakete installiert sind:
862858
[{shell}]
863859
----
864860
{c-root} dpkg -l | grep check-mk
865-
ii {pkg-cee}-{current} 0.noble amd64 Checkmk - Best-in-class infrastructure & application monitoring
866-
ii {pkg-cre}-{oldstable}p32 0.noble amd64 Checkmk - Best-in-class infrastructure & application monitoring
867-
ii {pkg-cre}-{current} 0.noble amd64 Checkmk - Best-in-class infrastructure & application monitoring
861+
ii {pkg-cee}-{current} 0.noble amd64 Checkmk - Best-in-class infrastructure & application monitoring
862+
ii check-mk-raw-{oldstable-patch} 0.noble amd64 Checkmk - Best-in-class infrastructure & application monitoring
863+
ii {pkg-cre}-{current} 0.noble amd64 Checkmk - Best-in-class infrastructure & application monitoring
868864
----
869865

870866
Die Deinstallation geschieht mit `dpkg --purge`:
871867

872868
[{shell}]
873869
----
874-
{c-root} dpkg --purge {pkg-cre}-{oldstable}p32
870+
{c-root} dpkg --purge check-mk-raw-{oldstable-patch}
875871
(Reading database ... 603038 files and directories currently installed.)
876-
Removing {pkg-cre}-{oldstable}p32 (0.noble) ...
872+
Removing check-mk-raw-{oldstable-patch} (0.noble) ...
877873
...
878874
----
879875

@@ -887,14 +883,14 @@ So finden Sie bei RPM-basierten Systemen heraus, welche {CMK}-Pakete installiert
887883
{c-root} rpm -qa | grep check-mk
888884
{pkg-cee}-{current}-el9-38.x86_64.rpm
889885
{pkg-cre}-{current}-el9-38.x86_64.rpm
890-
{pkg-cre}-{oldstable}p32-el9-38.x86_64.rpm
886+
check-mk-raw-{oldstable-patch}-el9-38.x86_64.rpm
891887
----
892888

893889
Das Löschen geschieht mit `rpm -e`:
894890

895891
[{shell}]
896892
----
897-
{c-root} rpm -e {pkg-cre}-{oldstable}p32-el9-38.x86_64.rpm
893+
{c-root} rpm -e check-mk-raw-{oldstable-patch}-el9-38.x86_64.rpm
898894
----
899895

900896

0 commit comments

Comments
 (0)