Checkm TLS Agent Kommunikation aktivieren

Checkmk Agent Registrierung (TLS)

Ziel

• Einen Checkmk-Client sicher per TLS beim Checkmk-Server registrieren

Voraussetzung

• Checkmk Server ist erreichbar (z. B. checkmk.it213.int)
• Site existiert (z. B. kitlab)
• Benutzer existiert (z. B. cmkadmin)
• Root-Rechte auf dem Client

Agent Installation

Debian / Ubuntu

• dpkg -i check-mk-agent_*.deb

Rocky / RHEL / Alma

• rpm -Uvh check-mk-agent-*.rpm

Dienst prüfen

• systemctl status cmk-agent-ctl-daemon.service

Verbindung testen

• ping checkmk.it213.int

Registrierung

• Registrierung erfolgt IMMER auf dem Client
• Der Hostname wird automatisch vom System übernommen

• sudo cmk-agent-ctl register --server checkmk.it213.int --site kitlab --user cmkadmin --hostname $HOSTNAME

Bedeutung

• --server
• Checkmk Server

• --site
• Name der Site

• --user
• Benutzer im Checkmk

Hostname Verhalten

• Es wird automatisch der lokale System-Hostname verwendet
• Kein Parameter notwendig
• Verhindert Fehler durch falsche oder doppelte Hostnamen

Beispiel

• hostname

• proxy

• cmk-agent-ctl register --server checkmk.it213.int --site kitlab --user cmkadmin

Test

• cmk-agent-ctl status
• ss -tulpen | grep 6556

Fehler

• DNS funktioniert nicht
• Agent läuft nicht
• falsche Zugangsdaten