NexTool Solutions

Den GLPI Agent zu installieren ist nur 20 % der Arbeit. Ob das Inventar zu verlässlichen Daten wird, entscheidet die serverseitige Konfiguration: das Inventar aktivieren, den Cron anpassen, doppelte Seriennummern behandeln und die Importregeln absichern. Dieser Leitfaden beschreibt den Weg, den wir beim Betrieb von GLPI-Umgebungen für Kunden gehen, mit den Einstellungen, die eine mit Geistern aufgeblähte CMDB verhindern.

Schritt 0: das Inventar auf dem Server aktivieren (der Schritt, den alle überspringen)

Der häufigste Fehler, dem wir begegnen, ist ein korrekt auf den Arbeitsplätzen installierter Agent, während das Inventar in GLPI ausgeschaltet ist. Ohne diesen Schalter landen die POSTs der Agents an einem Endpunkt, der nichts verarbeitet, und der Support verliert Stunden damit, der Firewall die Schuld zu geben. Bevor Sie Agents ausrollen, prüfen Sie auf dem Server:

• Aktivieren Sie unter Einrichtung > Allgemein > Reiter Inventar die Option Inventar aktivieren.
• Bestätigen Sie den nativen Endpunkt von GLPI 10/11: https://glpi.yourcompany.com/front/inventory.php (der Agent 1.x ermittelt diesen Pfad selbst aus der Basis-URL).
• Prüfen Sie in der Inventarkonfiguration die Importoptionen: Computer, Monitore, Drucker und Komponenten gemäß der Richtlinie des Kunden importieren.

Rollout des GLPI Agent (Windows und Linux)

Unter Windows ist das stille MSI der Standard für GPO. Der Parameter TAG ist der wichtigste und der am wenigsten genutzte: Über ihn leiten die Importregeln das Asset an die richtige Einheit und den richtigen Standort.

glpi-agent-1.x-x64.msi /qn SERVER=https://glpi.yourcompany.com TAG=branch-sp

Unter Linux kümmert sich der offizielle Installer um die Abhängigkeiten:

curl -sL https://raw.githubusercontent.com/glpi-project/glpi-agent/main/tools/linux-installer.sh | bash -s -- --server https://glpi.yourcompany.com --tag branch-sp

Unabhängig vom Betriebssystem steckt das Verhalten des Agents in einer Konfigurationsdatei. Das ist die Basis, die wir standardisieren:

# /etc/glpi-agent/agent.cfg   (Linux)
# %ProgramFiles%\GLPI-Agent\etc\agent.cfg   (Windows)

# Native GLPI 10/11 endpoint (the 1.x agent resolves /front/inventory.php):
server = https://glpi.yourcompany.com

# TAG used by the rules to route entity/location (e.g. branch):
tag = branch-sp

# Resend frequency in seconds (86400 = once a day):
delaytime = 86400

# Random window: avoids everyone reporting in the same login minute:
lazy = 1

# ONLY on an internal network with a self-signed certificate:
# no-ssl-check = 1

Cron: sicherstellen, dass das Inventar tatsächlich verarbeitet wird

Hier lauert eine klassische Falle. Standardmäßig laufen die automatischen Aktionen von GLPI im Modus GLPI (ausgelöst, wenn jemand im System navigiert). Das ist unvorhersehbar: Am Wochenende, wenn niemand angemeldet ist, läuft nichts. Für verlässliches Inventar, Telemetrie und Warteschlangen stellen Sie die automatischen Aktionen auf den Modus CLI (extern) um und planen den Cron des Betriebssystems ein. In GLPI 11 ist der Einstiegspunkt front/cron.php (die Konsole bin/console glpi:cron deckt nicht alles ab):

# /etc/cron.d/glpi  -  processes GLPI automatic actions and queues
# Runs as the PHP user (apache/www-data), every 2 minutes:
*/2 * * * * apache /usr/bin/php /var/www/glpi/front/cron.php >/dev/null 2>&1

Öffnen Sie danach unter Einrichtung > Automatische Aktionen jede relevante Aufgabe und stellen Sie den Ausführungsmodus von GLPI auf CLI um. Ohne das beschwert sich der Kunde über ein „veraltetes Inventar“, und die Ursache liegt nicht beim Agent.

SNMP-Discovery: Switches, Router und Drucker

Arbeitsplätze mit Agent sind der einfache Teil. Netzwerkgeräte führen keinen Agent aus und sind auf SNMP angewiesen. Die Reihenfolge, die funktioniert:

1. Installieren Sie die Netzwerkaufgaben auf dem zentralen Agent (Paket glpi-agent-task-network unter Linux; der Windows-Installer enthält die SNMP-Module bereits).
2. Hinterlegen Sie die SNMP-Zugangsdaten (v2c-Community oder v3) unter Verwaltung > Inventar > SNMP-Zugangsdaten.
3. Legen Sie die zu scannenden IP-Bereiche unter Verwaltung > Inventar > IP-Bereiche fest.
4. Planen Sie die Aufgaben Network discovery (erkennt, was existiert) und Network inventory (erfasst Details zu bereits Erkanntem) ein.

Der häufige Fehler hier ist, Network inventory einzuplanen, ohne vorher die Discovery auszuführen: Ohne erkannte und klassifizierte Geräte gibt es nichts, was im Detail inventarisiert werden könnte.

Importregeln und das Problem doppelter Seriennummern

Beim Betrieb von Umgebungen mit Hunderten von Rechnern erzeugt nicht der Agent die meisten „Geister“ im Inventar, sondern die generische Seriennummer. Notebooks und selbst montierte Desktops melden als Seriennummer To be filled by O.E.M., System Serial Number oder 0000000000; aus derselben Vorlage geklonte virtuelle Maschinen tragen DIESELBE UUID. Ordnet die Importregel über die Seriennummer zu, verknüpft GLPI all diese Rechner mit DEMSELBEN Asset oder erzeugt in jedem Inventarzyklus Dutzende Duplikate. Wir haben entschieden, bei jedem Kunden zwei Kontrollen zu standardisieren: erstens diese Müll-Seriennummern und -MACs im Reiter Blacklist der Inventarkonfiguration einzutragen, damit GLPI sie ignoriert; zweitens in der Importregel (Verwaltung > Regeln > Regeln für Import und Verknüpfung von Geräten) zusätzlich zur Seriennummer ein Kriterium über die UUID aufzunehmen. Der häufige Fehler ist, sich nur auf die Seriennummer zu verlassen und den Schaden drei Monate später zu entdecken, mit aufgeblähter CMDB und einer durch die Duplikate gesprengten Zählung der Softwarelizenzen.

Diagnose: SQL zum Aufspüren stiller Agents

Wenn der Kunde fragt „Wie viele Rechner melden sich nicht mehr?“, liefert die Oberfläche keine schnelle Antwort. Diese Abfrage listet die Agents ohne Kontakt seit mehr als 7 Tagen auf, Kandidaten für ausgeschaltete Rechner, Neuaufsetzen oder einen gestoppten Agent-Dienst:

-- Agents with no contact for more than 7 days
SELECT a.name AS agent, a.last_contact, c.name AS computer
FROM glpi_agents a
LEFT JOIN glpi_computers c
       ON c.id = a.items_id AND a.itemtype = 'Computer'
WHERE a.last_contact < (NOW() - INTERVAL 7 DAY)
ORDER BY a.last_contact ASC;

Führen Sie sie über einen schreibgeschützten SQL-Client aus. Eine Spitze bei stillen Agents fällt meist mit einer GPO-Änderung, einem abgelaufenen Zertifikat oder einer neuen Firewall-Regel zusammen.

Troubleshooting-Matrix aus der Praxis

Vom Inventar zum Lebenszyklus des Assets

Erfassen ist die halbe Arbeit. Das Inventar wird erst zur Verwaltung, wenn die eingehenden Daten klassifiziert, vereinheitlicht und auditiert werden: Die Importregeln leiten Einheit und Kategorie, die Wörterbücher normalisieren Hersteller- und Modellnamen, und der Audit-Trail hält fest, wann ein Asset hinzukommt, den Besitzer wechselt oder aus dem Inventar verschwindet. Genau diese Verkettung trennt „den GLPI Agent installieren“ von „ein verlässliches Inventar betreiben“.

Wenn Ihr GLPI-Inventar voller Duplikate ist, mit verschwindenden Agents oder Netzwerkgeräten außerhalb der Übersicht, prüft das GLPI-Betriebsteam von NexTool die Importregeln, passt die Blacklist an und verbindet das Inventar mit dem Lebenszyklus der Assets. Sprechen Sie mit uns über den GLPI-Betrieb.

Geprüft vom Team von NexTool Solutions.