Verweise auf Unterabschnitte zeigen jetzt wirklich dorthin
Abschnitt 5.1 existierte, war aber praktisch unsichtbar: alle Verweise
darauf benutzten den Anker von Kapitel 5, sprangen also an den
Kapitelanfang. Dasselbe galt fuer die uebrigen Unterabschnitts-
Verweise (8.2, 10.4, 11.3, 14.2 sowie "Variante B" in Kapitel 6) -
insgesamt 13 Stellen in beiden Dateien.
Beim Nachrechnen der Anker fiel ausserdem auf, dass Leerzeichen NICHT
kollabiert werden: aus "Variante B - Podman-Quadlet" wird
"variante-b--podman-quadlet-..." mit doppeltem Bindestrich, weil der
Gedankenstrich entfaellt und zwei Leerzeichen stehen bleiben. Vier
Anker waren deshalb zunaechst weiterhin falsch und sind korrigiert.
Bestaetigt wird die Regel durch die schon vorhandenen Anker des
Inhaltsverzeichnisses (#1-ueberblick--architektur).
Zusaetzlich zur Auffindbarkeit:
- 5.1 steht jetzt als Untereintrag im Inhaltsverzeichnis.
- Zwei neue Zeilen in der Fehlersuche-Tabelle: die dnf-Meldung
"not registered with an entitlement server" und der Fall, dass
sich epel-release nicht installieren laesst.
Geprueft: in beiden Dateien loesen alle Verweise gegen alle 62 Anker
auf (## bis ####).
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -17,6 +17,7 @@ werden müssen.
|
||||
3. [Voraussetzungen & Ports](#3-voraussetzungen--ports)
|
||||
4. [Installation auf Debian/Ubuntu (Docker)](#4-installation-auf-debianubuntu-docker)
|
||||
5. [Installation auf RHEL/Rocky/Alma/Fedora (Podman)](#5-installation-auf-rhelrockyalmafedora-podman)
|
||||
* [5.1 Unregistriertes RHEL: woher die Pakete kommen](#51-unregistriertes-rhel-woher-die-pakete-kommen)
|
||||
6. [Autostart nach einem Neustart des Hosts (Podman)](#6-autostart-nach-einem-neustart-des-hosts-podman)
|
||||
7. [Konfiguration (`.env`)](#7-konfiguration-env)
|
||||
8. [Checkmk-Image beschaffen (Raw, Enterprise & Co.)](#8-checkmk-image-beschaffen-raw-enterprise--co)
|
||||
@@ -202,7 +203,7 @@ verwendet. Die Compose-Datei ist dieselbe.
|
||||
> RHEL 9 nutzt *Simple Content Access*, ein `subscription-manager attach` ist
|
||||
> **nicht** mehr nötig. Ohne Konto geht es auch per Installations-DVD oder durch
|
||||
> den Wechsel auf Rocky/Alma – alle drei Wege stehen ausführlich in
|
||||
> [Abschnitt 5.1](#5-installation-auf-rhelrockyalmafedora-podman).
|
||||
> [Abschnitt 5.1](#51-unregistriertes-rhel-woher-die-pakete-kommen).
|
||||
>
|
||||
> **Rocky Linux, AlmaLinux, CentOS Stream und Fedora** brauchen nichts davon –
|
||||
> dort einfach weiterlesen.
|
||||
@@ -218,7 +219,7 @@ sudo ./install.sh --with-systemd
|
||||
`install.sh` installiert dabei:
|
||||
|
||||
1. prüft zuerst, ob überhaupt ein nutzbares Repository vorhanden ist, und
|
||||
nennt andernfalls die drei Wege aus [Abschnitt 5.1](#5-installation-auf-rhelrockyalmafedora-podman)
|
||||
nennt andernfalls die drei Wege aus [Abschnitt 5.1](#51-unregistriertes-rhel-woher-die-pakete-kommen)
|
||||
2. `podman`, `tar`, `openssl`
|
||||
3. `dialog` für die ncurses-Oberfläche – schlägt das fehl, wird `newt`
|
||||
(`whiptail`) genommen; beides unterstützen die Skripte
|
||||
@@ -244,7 +245,7 @@ sudo dnf install -y podman-compose
|
||||
> schon der Befehl oben – EPEL ist **kein** Ersatz für die Registrierung.
|
||||
>
|
||||
> Bleibt `podman-compose` deswegen unerreichbar, ist das kein Hindernis:
|
||||
> mit **Quadlet** ([Kapitel 6, Variante B](#6-autostart-nach-einem-neustart-des-hosts-podman))
|
||||
> mit **Quadlet** ([Kapitel 6, Variante B](#variante-b--podman-quadlet-ab-podman-44-ohne-compose))
|
||||
> läuft der Stack ganz ohne Compose, direkt über systemd.
|
||||
|
||||
Starten:
|
||||
@@ -260,7 +261,7 @@ sudo ./scripts/cmk-manage.sh up # nutzt automatisch podman-compose
|
||||
sudo ./scripts/cmk-manage.sh status
|
||||
```
|
||||
|
||||
> Auf RHEL unbedingt [Kapitel 8.2](#8-checkmk-image-beschaffen-raw-enterprise--co)
|
||||
> Auf RHEL unbedingt [Kapitel 8.2](#82-zwei-podman-fallstricke-genau-die-aus-der-praxis)
|
||||
> lesen: kurze Image-Namen und `podman import` statt `podman load` sind die
|
||||
> beiden Ursachen fuer „Image unbekannt“.
|
||||
|
||||
@@ -938,7 +939,7 @@ ausgefüllt), aber das Hochladen eines **selbstsignierten Zertifikats**
|
||||
(*SSL Certificates → Custom*) funktioniert so nicht zuverlässig.
|
||||
|
||||
Für genau diesen Fall führt der Weg über die REST-Schnittstelle des Proxy
|
||||
Managers. Zertifikat wie in [Kapitel 10.4](#10-https-einrichten--lets-encrypt-oder-selbstsigniert)
|
||||
Managers. Zertifikat wie in [Kapitel 10.4](#104-variante-b--selbstsigniertes-zertifikat-interne-umgebung)
|
||||
erzeugen, dann:
|
||||
|
||||
```bash
|
||||
@@ -1584,11 +1585,13 @@ Checkmk-Werksnotizen (Werks/Release Notes) lesen.
|
||||
| Agents melden sich nach der Migration nicht | Site-Name geändert (`--as-site`), IP nicht übernommen oder Port 8000 blockiert; auf dem Agent prüfen: `cmk-agent-ctl status` |
|
||||
| Permission denied auf `data/` unter RHEL | SELinux: `restorecon -Rv /opt/checkmk-stack/data`, `:Z` an den Mounts prüfen |
|
||||
| `podman-compose` nicht gefunden | EPEL aktivieren oder auf Quadlet umstellen (`./install.sh --quadlet`) |
|
||||
| `This system is not registered with an entitlement server` | RHEL ohne Subskription – `dnf` liefert dann gar keine Pakete. Registrieren, Installations-DVD als Repository einbinden oder auf Rocky/Alma wechseln: [Abschnitt 5.1](#51-unregistriertes-rhel-woher-die-pakete-kommen) |
|
||||
| `epel-release` lässt sich nicht installieren | EPEL setzt Red Hats Basis-Repositories voraus und ersetzt die Registrierung nicht. Ohne Subskription führt der Quadlet-Weg ohne `podman-compose` zum Ziel: [Kapitel 6, Variante B](#variante-b--podman-quadlet-ab-podman-44-ohne-compose) |
|
||||
| Adminoberfläche aus dem LAN nicht erreichbar | Port 81 gesperrt. Auf einen freien Port legen: `cmk-manage.sh npm-port 10443` und in der Firewall freigeben |
|
||||
| Nach `npm-port` antwortet der neue Port nicht | Proxy Manager wurde nicht neu gestartet: `cmk-manage.sh restart`; Datei prüfen: `data/npm/data/nginx/custom/http.conf` |
|
||||
| `cmk-manage.sh` bricht mit „CMK_RUNTIME … ist nicht installiert" ab | wird nur noch gewarnt und selbst gesucht; sauber setzen mit `config set CMK_RUNTIME auto` |
|
||||
| Proxy-Manager-Oberfläche im Browser leer / nur Textfragmente | Textbrowser ohne JavaScript verwendet. `cmk-manage.sh browser --engine browsh` (bzw. `carbonyl`) nehmen |
|
||||
| Selbstsigniertes Zertifikat lässt sich im Terminal-Browser nicht hochladen | Datei-Dialoge gibt es dort nicht – Upload über die API, siehe [Kapitel 11.3](#11-proxy-manager-lokal-einrichten-terminal-browser) |
|
||||
| Selbstsigniertes Zertifikat lässt sich im Terminal-Browser nicht hochladen | Datei-Dialoge gibt es dort nicht – Upload über die API, siehe [Kapitel 11.3](#113-grenze-datei-upload) |
|
||||
| `browser` meldet „braucht ein echtes Terminal" | Aufruf aus Pipe/Skript. Direkt auf der Konsole oder per SSH aufrufen; nur der Bau geht headless mit `--build-only` |
|
||||
| TUI startet nicht | `dialog` installieren: `apt-get install -y dialog` bzw. `dnf install -y dialog` |
|
||||
| Site startet nicht, `tmp`-Fehler | `./scripts/cmk-manage.sh omd config <site> set TMPFS off`, danach Site starten |
|
||||
|
||||
Reference in New Issue
Block a user