JDisc Connector#

Übersicht#

Der JDisc Connector ist ein Add-on für i-doit, das den automatisierten Import von IT-Objekten aus einer JDisc-Instanz ermöglicht. Die Integration basiert auf der GraphQL-Schnittstelle von JDisc und erlaubt eine präzise Synchronisation von Geräten und deren Eigenschaften in die CMDB von i-doit.

Ziel der JDisc-Integration in i-doit#

Die Integration von JDisc Discovery in i-doit zielt darauf ab, die Stärken beider Systeme zu kombinieren:

• Automatisierte Datenerfassung: Nutzung der leistungsstarken Scan-Funktionen von JDisc zur automatischen Erhebung aktueller und detaillierter Inventardaten.
• Zentrale Datenhaltung und -verwaltung: Überführung dieser Daten in die i-doit CMDB, um eine zentrale, konsistente und aktuelle Datenbasis ("Single Source of Truth") für alle IT-Assets zu schaffen.
• Reduzierung manuellen Aufwands: Minimierung der manuellen Dateneingabe und -pflege, wodurch Zeit gespart und die Fehleranfälligkeit reduziert wird.
• Verbesserte Datenqualität: Sicherstellung einer hohen Datenqualität in der CMDB durch regelmäßige, automatisierte Updates von JDisc.
• Fundierte Entscheidungen: Bereitstellung einer soliden Datengrundlage für IT-Management-Aufgaben wie Change Management, Lizenzmanagement, Problem Management und strategische Planung.

Voraussetzungen#

• Separate JDisc installation
• i-doit Version: >= 36
• JDisc mit aktivierter GraphQL-Schnittstelle
• Netzwerkzugang zum JDisc-Server
• Benutzerkonto in JDisc mit Leserechten (postgresro)

Weiterführende Links:#

• JDisc Dokumentation
• JDisc Support

Installation#

1. Das Add-on aus dem Kundenportal herunterladen und über das Admin-Center hochladen und installieren
2. oder das Add-on über das integrierte Add-on & Subscription Center installieren
3. Nach der Installation erscheint ein neuer Menüpunkt im Add-on Menü

Schnellstart#

1. Discovery Server konfigurieren
2. Verbindung prüfen
3. Sync Profile erstellen
4. Synchronisation durchführen
5. Status und Logs prüfen

Konfiguration#

Einstellungen die Konfiguriert werden müssen damit die Verbindung zur JDisc Instanz hergestellt werden kann.

Discovery Server#

Sync Profile#

Konfiguration der Regeln zum Import aus JDisc.

Allgemeine Konfiguration#

Jedes Sync Profil benötigt einen Namen und einen zugewiesenen JDisc Server.

Objekttyp-Zuweisung#

Die Spalten Objekt Titel Transformation, FQDN Zusatz, Port Filter und Standort müssen manuell über die Spaltenkonfiguration eingeblendet werden.

Jeder JDisc-Typ wird mit einem i-doit Objekttyp verknüpft. Wenn kein i-doit Objekttyp ausgewählt wird, wird dieser nicht importiert. Das Import Matching Profile wird in der Verwaltung unter Import und Schnittstellen > Import Matching Profile Konfiguriert. Über das Import Matching Profile kann zum Beispiel gefiltert werden ob Objekte import werden die nicht über bestimmte Attribute verfügen.

Synchronisations-Konfiguration#

Allgemein#

Software und Betriebssystem#

Netzwerk#

Geräteliste#

Die Geräteliste zeigt alle durch den Discovery Server erkannten Geräte. Oben kann der gewünschte Discovery Server ausgewählt werden, daneben steht eine Suchfunktion und ein Filter. Jede Zeile entspricht einem Gerät. In den Spalten werden je nach Konfiguration unterschiedliche Attribute angezeigt, zum Beispiel der Synchronisationsstatus, der Objekttyp, die IP-Adresse oder der Hersteller.

Die Spalten lassen sich individuell anpassen über den Dialog Spalten. Dort können Felder ein- oder ausgeblendet werden. Am unteren Rand der Liste steht die Gesamtanzahl der Geräte sowie eine Blätterfunktion zur Navigation durch die Seiten.

Aktionen#

In der linken Spalte Aktionen gibt es pro Gerät zwei Symbole:

• Link-Button - öffnet die JDisc Detailansicht des Geräts in einem neuen Fenster.
• Import-Button - Importiert das Gerät

Dashboard#

Der JDisc Connector für i-doit vereinfacht die Verwaltung von IT-Asset-Discovery und -Synchronisation. Die intuitive Web-Oberfläche bietet zentrale Funktionen und Statusanzeigen:

Sync Info#

Zugriff auf Sync-Profile und Start neuer Synchronisationsläufe. Über das Profil werden die zu synchronisierenden Objekte und Importmodi definiert.

• Sync Profile öffnen: Öffnet die Sync-Profile.
• Neuen Sync starten: Öffnet den Dialog zur Auswahl von Profil/Importmodus und startet den Prozess.

Discovery Info#

Überblick zum aktuellen Zustand des Discovery-Prozesses mit Starter-Button für neue Jobs.

• Aktuell laufende Discovery: Zeigt den Live-Status
• Aktualisieren: Aktualisiert den Discovery Status
• Discovery Server Einstellungen öffnen: Öffnet die Discovery Server Einstellungen
• Geräteliste öffnen: Öffnet die Geräteliste
• Neue Discovery starten: Auswahl von Server, Discovery Job und zeigt die Beschreibung. Der Start ist über den Dialog möglich.

Letzte Logs#

Schnellübersicht über die zuletzt ausgeführten Jobs, inklusive direktem Download der Logs und Statuskontrolle.

• Status: Erfolg oder Fehler direkt ersichtlich
• Aktion: Download des Logs

Beispielhafte Log Einträge:#

Berechtigungen#

Die Berechtigungen für das JDisc Connector Add-on werden über die Rechteverwaltung in i-doit konfiguriert und können gruppenspezifisch vergeben werden. Für die Nutzung des Add-ons müssen entsprechende Zugriffsrechte auf die einzelnen Komponenten gesetzt werden.

Verfügbare Berechtigungsbereiche#

• Dashboard
  Zugriff auf die zentrale Übersicht des Add-ons

• Geräteliste
  Einsicht in die importierten Geräte und deren Synchronisationsstatus

• Sync Profile
  Erstellen, Bearbeiten und Ausführen von Synchronisationsprofilen

• Discovery Server
  Konfiguration und Prüfung der JDisc-Serververbindung

• Logs
  Einsicht und Download der Log-Dateien zu Sync- und Discovery-Vorgängen

Änderungen müssen gespeichert werden damit sie wirksam werden.

Fehlerbehandlung#

• Konfigurationsprüfung
• Discovery- und GraphQL-Prüfung
• Loganalyse bei Fehlern

Best Practices#

• Testumgebung vor Produktiveinsatz
• Regelmäßige Prüfung der Geräteliste und Logs
• Pflege von Seriennummern und MAC-Adressen
• Dokumentation der Sync Profile