JDisc Discovery: Einrichtung und Import

JDisc Discovery inventarisiert automatisch Netzwerkgeräte, Hardware, Software und Virtualisierungsumgebungen. Die Ergebnisse können in die i-doit CMDB importiert werden.

JDisc Connector Add-on

Voraussetzungen

JDisc Discovery läuft auf einem Windows-System
Der PostgreSQL-Port 25321 muss vom i-doit-Server erreichbar sein
Ab i-doit v36 steht zusätzlich das JDisc Connector Add-on zur Verfügung

Schritt 1: Verbindung konfigurieren

Klassisch: Verwaltung > Import & Schnittstellen > JDISC > Konfiguration

JDisc Connector Add-on (ab v36): Die komplette Verwaltung befindet sich im Add-on unter Add-ons > JDisc Connector im Hauptmenü. Dort stehen Dashboard, Discovery Server, Sync Profiles, Geräteliste und Logs zur Verfügung.

Parameter	Standardwert	Beschreibung
Host	—	IP-Adresse oder Hostname des JDisc-Servers
Port	`25321`	PostgreSQL-Port
Datenbank	`inventory`	JDisc-Datenbank
Benutzername	`postgresro`	Read-Only-Benutzer
Passwort	—	Datenbankpasswort

GraphQL aktivieren (empfohlen)

Für verschlüsselte Kommunikation und erweiterte Funktionen:

Parameter	Wert
Protokoll	`https`
Port	`443`
Benutzername/Passwort	WebService-Credentials

Hinweis: GraphQL ist ab i-doit v22 verfügbar und wird für neue Installationen empfohlen. Ohne GraphQL stehen einige Funktionen (z.B. Seriennummern-Anzeige) nicht zur Verfügung.

Schritt 2: Import-Profil erstellen

Klassisch: Verwaltung > Import & Schnittstellen > JDISC > Profile

JDisc Connector Add-on (ab v36): Add-ons > JDisc Connector > Sync Profiles

Profile definieren, wie JDisc-Daten auf i-doit-Objekttypen und -Kategorien gemappt werden. Ein Beispiel-Profil wird mitgeliefert.

Schritt 3: Import durchführen

Klassisch: Extras > Import > JDisc

JDisc Connector Add-on (ab v36): Add-ons > JDisc Connector > Dashboard (Import von dort starten)

Import-Modi

Modus	Verhalten
Aktualisieren	Neue Objekte erstellen, bestehende aktualisieren
Aktualisieren (Neu inventarisiert)	Beziehungen zurücksetzen und neu zuweisen
Aktualisieren (Bestehende)	Nur bereits vorhandene Objekte ändern
Erstellen	Alle Geräte als neue Objekte anlegen
Überschreiben	Vollständiger Re-Import, Listen-Kategorien leeren

Automatisierter Import per CLI

sudo -u www-data php console.php import-jdisc \
    -c /pfad/zur/jdisc.ini

Beispiel jdisc.ini:

[commandOptions]
user=admin
password=admin
tenantId=1
profile=1
server=1
mode=1
detailedLogging=3
regenerateSearchIndex

Häufige Probleme

Problem	Lösung
Verbindung schlägt fehl	Port 25321 in der Windows-Firewall freigeben
Import bricht ab (Memory)	Expert Setting: `system.memory-limit.jdisc = 3G`
Sync Profiles zeigen Fehlermeldung	GraphQL aktivieren und Credentials prüfen
Geräte ohne Titel werden nicht importiert	Im Profil "Import unidentified devices" aktivieren

Ausführliche Dokumentation: JDisc Discovery in der Knowledge Base