Merge pull request #67 from it-novum/openitcockpit5

ITC-3463 openITCOCKPIT 5

Author: nook24

.gitignore

@@ -1,6 +1,7 @@
 .idea
 .vscode
 .DS_Store
+*:Zone.Identifier
 
 # Static Website build files
 de/site

README.md

@@ -90,7 +90,7 @@ Go to `http://127.0.0.1:8080/`
 
 ## License
 ```
-Copyright (C) 2015-2020  it-novum GmbH
+Copyright (C) 2015-2025  it-novum GmbH
 
 
 openITCOCKPIT is dual licensed

de/docs/additional/mod-gearman.md

@@ -42,7 +42,7 @@ Dieser Dienst wird durch das Paket `openitcockpit-mod-gearman-worker-go-local` b
 
 Um Mod-Gearman für einen gesamten Host zu umgehen, können Sie das benutzerdefinierte Makro `WORKER` mit dem Wert `local` setzen.
 
-![Mod-Gearman umgehen](/images/mod_gearman/bypass_mod_gearman.jpg)
+![Mod-Gearman umgehen](/images/mod_gearman/bypass_mod_gearman.png)
 
 Sie können das Makro auch für einen bestimmten Dienst definieren, um nur diesen Dienst auszuschließen.
 
@@ -99,7 +99,7 @@ openITCOCKPIT-Versionen 4.8.0 und höher haben Mod-Gearman standardmäßig aktiv
 
 Um dies zu tun, navigieren Sie zu `System -> Konfigurationsdatei Editor` und bearbeiten Sie die Datei `/opt/openitc/nagios/etc/nagios.cfg`.
 
-![Deaktivieren von Mod-Gearman](/images/mod_gearman/enable_mg.jpg)
+![Deaktivieren von Mod-Gearman](/images/mod_gearman/enable_mg.png)
 
 Deaktivieren Sie die Option `enable_mod_gearman` und klicken Sie auf Speichern.
 
@@ -221,7 +221,7 @@ Um Prüfungen an einen Worker zu binden, müssen Sie das `WORKER`-benutzerdefini
 
 Definieren Sie das Makro `WORKER` mit dem Wert `hostgroup_Fulda`
 
-![Worker ueber Macro steuern](/images/mod_gearman/mg_routing_oitc.jpg)
+![Worker ueber Macro steuern](/images/mod_gearman/mg_routing_oitc.png)
 
 !!! note
     Es ist wichtig, dass der Wert des benutzerdefinierten Makros mit `hostgroup_` vorangestellt ist.

de/docs/additional/troubleshooting.md

@@ -244,3 +244,49 @@ Sollte dies das Problem nicht beheben, schauen Sie sich bitte den [Mod-Gearman A
 
 Sollte Ihre openITCOCKPIT Oberfläche kein `Grafana` enthalten, kann dies mit `apt-get install openitcockpit-module-grafana` nachinstalliert werden.
 
+## Paketmanager leer
+
+!!! info
+    Dies betrifft nur die openITCOCKPIT Versionen **3.x** und **4.x**, welche End of Life sind.
+    Für openITCOCKPIT 5 ist dies **nicht** erforderlich.
+
+openITCOCKPIT verfügt über einen eigenen Paketmanager, welcher die Installation von openITCOCKPIT Modulen erleichtert.
+Die Liste der verfügbaren Module wird von einem Server abgerufen. Die Adresse des Servers wurde im Jahr 2025 geändert,
+von
+```
+packagemanager.it-novum.com
+```
+
+zu
+```
+packagemanager.openitcockpit.io
+```
+
+Da die openITCOCKPIT Versionen 3.x und 4.x nicht mehr gewartet werden, muss die Adresse des Servers manuell geändert werden.
+
+### openITCOCKPIT 3.x
+
+Öffnen Sie die Datei `/usr/share/openitcockpit/app/Console/Command/Task/SystemMetricsTask.php` und ersetzten Sie in Zeile 90 `packagemanager.it-novum.com`
+durch `packagemanager.openitcockpit.io`.
+
+GitHub: [https://github.com/it-novum/openITCOCKPIT/blob/779a60216416ac8bb5c4cb73f82f3515ac65ed46/app/Console/Command/Task/SystemMetricsTask.php#L90](https://github.com/it-novum/openITCOCKPIT/blob/779a60216416ac8bb5c4cb73f82f3515ac65ed46/app/Console/Command/Task/SystemMetricsTask.php#L90)
+
+Offnen Sie die Datei `/usr/share/openitcockpit/app/src/itnovum/openITCOCKPIT/Core/PackagemanagerRequestBuilder.php` und ersetzten Sie in Zeile 45 `packagemanager.it-novum.com` durch `packagemanager.openitcockpit.io`.
+
+GitHub: [https://github.com/it-novum/openITCOCKPIT/blob/779a60216416ac8bb5c4cb73f82f3515ac65ed46/app/src/itnovum/openITCOCKPIT/Core/PackagemanagerRequestBuilder.php#L45](https://github.com/it-novum/openITCOCKPIT/blob/779a60216416ac8bb5c4cb73f82f3515ac65ed46/app/src/itnovum/openITCOCKPIT/Core/PackagemanagerRequestBuilder.php#L45)
+
+Ab jetzt sollte der Paketmanager wieder funktionieren.
+
+### openITCOCKPIT 4.x
+
+Öffnen Sie die Datei `/opt/openitc/frontend/src/Command/SystemMetricsCommand.php` und ersetzten Sie in Zeile 111 `packagemanager.it-novum.com`
+durch `packagemanager.openitcockpit.io`.
+
+GitHub: [https://github.com/it-novum/openITCOCKPIT/blob/e24ff4327edd98bf8dfcf12c404ecbb24f4eb758/src/Command/SystemMetricsCommand.php#L111](https://github.com/it-novum/openITCOCKPIT/blob/e24ff4327edd98bf8dfcf12c404ecbb24f4eb758/src/Command/SystemMetricsCommand.php#L111)
+
+Offnen Sie die Datei `/opt/openitc/frontend/src/itnovum/openITCOCKPIT/Core/PackagemanagerRequestBuilder.php` und ersetzten Sie in den Zeilen 32 und 45 `packagemanager.it-novum.com` durch `packagemanager.openitcockpit.io`.
+
+GitHub: [https://github.com/it-novum/openITCOCKPIT/blob/e24ff4327edd98bf8dfcf12c404ecbb24f4eb758/src/itnovum/openITCOCKPIT/Core/PackagemanagerRequestBuilder.php#L32-L45](https://github.com/it-novum/openITCOCKPIT/blob/e24ff4327edd98bf8dfcf12c404ecbb24f4eb758/src/itnovum/openITCOCKPIT/Core/PackagemanagerRequestBuilder.php#L32-L45)
+
+Ab jetzt sollte der Paketmanager wieder funktionieren.
+

de/docs/additional/upgradev4-v5.md

@@ -184,15 +184,11 @@ Dies dient dazu, unerwartete System-Upgrades zu verhindern.
 
 Die neue Adresse lautet: `packages5.openitcockpit.io`.
 
-!!! warning
-    Derzeit befindet sich openITCOCKPIT 5 in der **Beta-Phase**. Bitte verwenden Sie dieses Version nicht für Produktionssysteme.
-    Das Repository ist automatisch für die Verwendung des Kanals `nightly` konfiguriert.
-
 ##### Ubuntu-Benutzer
 
 ```bash
 curl https://packages5.openitcockpit.io/repokey.txt | tee /etc/apt/keyrings/openitcockpit-keyring.asc
-echo "deb [signed-by=/etc/apt/keyrings/openitcockpit-keyring.asc] https://packages5.openitcockpit.io/openitcockpit/$(lsb_release -sc)/nightly $(lsb_release -sc) main" > /etc/apt/sources.list.d/openitcockpit.list
+echo "deb [signed-by=/etc/apt/keyrings/openitcockpit-keyring.asc] https://packages5.openitcockpit.io/openitcockpit/$(lsb_release -sc)/stable $(lsb_release -sc) main" > /etc/apt/sources.list.d/openitcockpit.list
 
 apt-get update
 ```
@@ -201,7 +197,7 @@ apt-get update
 
 ```bash
 curl https://packages5.openitcockpit.io/repokey.txt | tee /etc/apt/keyrings/openitcockpit-keyring.asc
-echo "deb [signed-by=/etc/apt/keyrings/openitcockpit-keyring.asc] https://packages5.openitcockpit.io/openitcockpit/$(lsb_release -sc)/nightly $(lsb_release -sc) main" > /etc/apt/sources.list.d/openitcockpit.list
+echo "deb [signed-by=/etc/apt/keyrings/openitcockpit-keyring.asc] https://packages5.openitcockpit.io/openitcockpit/$(lsb_release -sc)/stable $(lsb_release -sc) main" > /etc/apt/sources.list.d/openitcockpit.list
 
 apt-get update
 ```
@@ -219,7 +215,7 @@ apt-get update
 cat <<EOT > /etc/yum.repos.d/openitcockpit.repo
 [openitcockpit]
 name=openITCOCKPIT Monitoring System
-baseurl=https://packages5.openitcockpit.io/openitcockpit/RHEL8/nightly/\$basearch/
+baseurl=https://packages5.openitcockpit.io/openitcockpit/RHEL8/stable/\$basearch/
 enabled=1
 gpgcheck=1
 gpgkey=https://packages5.openitcockpit.io/repokey.txt
@@ -241,7 +237,7 @@ dnf --refresh check-update
 cat <<EOT > /etc/yum.repos.d/openitcockpit.repo
 [openitcockpit]
 name=openITCOCKPIT Monitoring System
-baseurl=https://packages5.openitcockpit.io/openitcockpit/RHEL8/nightly/\$basearch/
+baseurl=https://packages5.openitcockpit.io/openitcockpit/RHEL8/stable/\$basearch/
 enabled=1
 gpgcheck=1
 gpgkey=https://packages5.openitcockpit.io/repokey.txt
@@ -390,6 +386,59 @@ Sollten Sie Verbindungsfehler mit Ihrem System haben, können Sie versuchen die
 apt-get install -f
 ```
 
+#### Keine Graphen / CPU does not support x86-64-v2
+
+Wenn Sie nach dem Upgrade auf openITCOCKPIT 5 keine Graphen sehen, Grafana nicht funktioniert oder die Fehlermeldung `Fatal glibc error: CPU does not support x86-64-v2` erhalten,
+nutzten Sie entweder eine sehr alte CPU, welche von openITCOCKPIT 5 nicht mehr untersützt wird,
+oder Sie betreiben openITCOCKPIT in einer virtuellen Maschine und haben keinen CPU-Type eingestellt.
+
+Sollte bei Ihnen der Dienst `openitcockpit-graphing.service` nicht starten können, sollten Sie den CPU-Type prüfen.
+
+Ob sie von dem Fehler `Fatal glibc error: CPU does not support x86-64-v2` betroffen sind, können Sie prüfen, indem Sie versuchen den MySQL-Server als Docker-Container zu starten.
+
+##### CPU-Fehler
+
+Im Fehlerfall werden Sie folgende Ausgabe erhalten und der MySQL-Server wird sich automatisch beenden:
+
+```bash
+docker run --rm -it mysql:latest
+
+Fatal glibc error: CPU does not support x86-64-v2
+```
+
+Um dies zu beheben, müssen Sie den CPU-Typ Ihrer virtuellen Maschine anpassen. Abhänikg von Ihrer Virtualisierungssoftware können Sich die Einstellungen unterscheiden.
+Wir zeigen in diesem Beispiel die Option für `Proxmox` / `KVM`.
+
+Aktuell ist bei der VM kein CPU-Typ eingestellt und es wird der Type `Default kvm64` verwendet.
+
+![Default CPU-Type Default kvm64](/images/openitcockpit5/pve_default_kvm64.png)
+
+Ändern Sie den CPU-Typ auf `host` oder `x86-64-v2-AES`, speichern Sie die Änderungen und schalten die VM aus und wieder ein.
+Im Anschluss sollten das Problem behoben sein.
+
+![Default CPU-Type x86-64-v2-AES](/images/openitcockpit5/pve_x86-64-v2-AES.png)
+
+##### Erfolg
+
+Wenn der MySQL-Server erfolgreich gestartet werden kann, erhalten Sie eine Ausgabe wie diese und der MySQL-Server wird sich automatisch beenden:
+
+```bash
+docker run --rm -it mysql:latest
+
+2025-05-13 14:37:28+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 9.3.0-1.el9 started.
+2025-05-13 14:37:29+00:00 [Note] [Entrypoint]: Switching to dedicated user 'mysql'
+2025-05-13 14:37:29+00:00 [Note] [Entrypoint]: Entrypoint script for MySQL Server 9.3.0-1.el9 started.
+2025-05-13 14:37:29+00:00 [ERROR] [Entrypoint]: Database is uninitialized and password option is not specified
+    You need to specify one of the following as an environment variable:
+    - MYSQL_ROOT_PASSWORD
+    - MYSQL_ALLOW_EMPTY_PASSWORD
+    - MYSQL_RANDOM_ROOT_PASSWORD
+```
+
+In diesem Fall ist Ihr System nicht betroffen und Sie können die Schritte zur Fehlerbehebung ignorieren.
+
+
+
 #### Wenn Ihre openITCOCKPIT Version < 4.8.7 ist
 
 Damit der Aktualisierungsprozess erfolgreich abgeschlossen werden kann, müssen Sie mindestens Version 4.8.7 von openITCOCKPIT verwenden.