JDisc Discovery

JDisc Discovery inventarisiert gesamte Netzwerke und erkennt alle wichtigen Betriebssysteme (einschließlich HP-UX, Solaris und AIX). Es erkennt Hardware- und Software, IP-Netzwerke, Windows-Domänen und Active Directory. Darüber hinaus identifiziert JDisc Discovery alle wichtigen Virtualisierungstechnologien, sowie viele Cluster-Umgebungen. Ein Praxisbeispiel finden Sie auf unserem Blog

Installation#

Für den Betrieb ist die Installation der JDisc-Server-Komponenten auf einem Microsoft Windows (bestenfalls in der Server-Variante) erforderlich. Die Installationsdateien hierfür können unter folgender Adresse heruntergeladen werden:

https://jdisc.com/downloads/

Während des Setups wird abgefragt, welche Passwörter für das im Hintergrund verwendete PostgreSQL-DBMS verwendet werden sollen. Dies betrifft den administrativen Account postgres und den Account postgresro, der lediglich über Leserechte auf die JDisc-Datenbank verfügt. Letztere Account wird für die Schnittstelle zu i-doit benötigt. Zudem muss beim Setup angegeben werden, dass die PostgreSQL-Instanz nach außen hin erreichbar sein soll. Diese hört standardmäßig auf den Port 25321. Der Port ist in der Windows Firewall freizuschalten.

Die JDisc Dokumentation ist unter https://jdisc.com/support/documentation/ zu finden. Bei Fragen zur Installation oder Konfiguration von JDisc hilft der Support des Herstellers https://jdisc.com/support/.

https://jdisc.com/support/

Dieser Artikel widmet sich im Folgenden der Schnittstelle zwischen i-doit und JDisc Discovery.

Konfiguration#

Die Konfiguration der Schnittstelle befindet sich unter Verwaltung → Import und Schnittstellen → JDISC → JDisc-Konfiguration. Dort können beliebig viele Instanzen von JDisc Discovery angegeben werden. Dies ermöglicht komplexe Inventarisierungs-Szenarien mit voneinander getrennten Netzen.

Allgemeine Einstellungen#

Nach dem Speichern der Parameter kann die Verbindung zur JDisc-Datenbank über den Button Verbindung prüfen getestet werden.

Um Objekte zu archivieren, die von JDisc für eine bestimmte Anzahl von Tagen nicht gesehen wurden, wird der Schwellenwert und die Schwellenwerteinheit in der Verwaltung eingestellt. Verwaltung → [Mandanten-Name] Verwaltung → Einstellungen für [Mandanten-Name] → JDisc.

Discovery Einstellungen#

Über i-doit kann der Benutzer einen Scan bei der konfigurierten JDisc-Instanz auslösen. Dazu wird der WebService von JDisc Discovery verwendet, der installiert und aktiviert sein muss.

Auch hier kann nach dem Speichern der Parameter über den Button Verbindung prüfen getestet werden, ob die Konfiguration erfolgreich ist.

JDisc-Profile#

Die JDisc-Profile innerhalb von i-doit geben die Möglichkeit, die Verknüpfung von Objekttypen und ihren Attributen zwischen JDisc und i-doit zu definieren. Unter Verwaltung → Import und Schnittstellen → JDISC → JDisc-Profile kann festgelegt werden, in welcher Weise die durch JDisc gefundenen Objekte ihren Weg in die IT-Dokumentation finden.

In der Standard-Installation von i-doit ist bereits ein vordefiniertes Beispiel Profil vorhanden. Das vordefinierte JDisc Profil Example ist ein Profil das Ihnen aufzeigen soll, wie ein JDisc Profil gestaltet werden kann.

Allgemeine Einstellungen#

Objekttyp Zuweisungen#

Für jeden Typ in JDisc kann ein äquivalenter Objekttyp in i-doit ausgewählt werden. Geschieht dies nicht, werden Devices diesen Typs nicht importiert. Die Reihenfolge der Zuweisungen wird beim Import beachtet. Dieser geht die Liste von oben nach unten durch, um eine Zuweisung zu identifizieren. Die Matrix ist pro Zeile folgendermaßen aufgebaut:

Zusätzliche Optionen#

Kategorien die für JDisc erstellt worden sind:

• Custom Identifier
• JDisc Custom Attributes
• JDisc Discovery
• JDisc Geräte Informationen
• Netzwerk → Verbindungs Endpunkte
• Subscriptions
• Support Entitlements
• Zugewiesene Abonnente

Identifizierung von Objekten#

Wir identifizieren JDisc Geräte anhand einer Kombination von Faktoren, vor allem des Objekttyps, der Seriennummer und der MAC-Adresse. Falls verfügbar, verwenden wir auch JDiscs interne unique identifier als zusätzliches Mittel zur Identifizierung. Der Identifikationsprozess ist auf den jeweiligen Objekttyp zugeschnitten und nutzt Attribute wie Bezeichnung, Seriennummer, Hostname, IP-Adressen, FQDN und MAC-Adresse. Um doppelte Einträge zu vermeiden, stellen wir eine Zuordnungsbeziehung zwischen JDisc und i-doit-Geräten her.

Beim Importieren von Objekten werden auch andere Unterobjekte wie Netzwerke, Software, Cluster und andere Objekttypen importiert. In diesem Fall können wir andere Regeln als die im Abschnitt "Objekt matching" definierten verwenden.

Import von Daten über die Web GUI#

Der Import von Inhalten aus JDisc erfolgt über Extras → Import → JDisc.

Vor dem Ausführen des Imports müssen die Import-Parameter festgelegt sein.
Da es möglich ist, dass mehr als ein JDisc-Server eingesetzt wird, muss im ersten Schritt der JDisc-Server ausgewählt werden. Das Profil, welches zuvor definiert wurde, kann ebenfalls gewählt werden um die importierten Inhalte und deren Handhabung zu beeinflussen. Zusätzlich kann der Modus des Imports angegeben werden. Der Import-Modus Erstellen wird alle gefundenen Objekte erstellen, ohne zu prüfen, ob diese bereits existieren. Der Import-Modus Aktualisieren wird nur Objekte erstellen, die im i-doit-Datenbestand nicht gefunden werden. Kategorien von bereits existierenden Objekten werden (wenn nötig) um neue Daten ergänzt. Der Import-Modus Überschreiben verhält sich im Prinzip wie der Modus Aktualisieren mit dem Unterschied, dass Listen-Kategorien erst geleert und dann neu angelegt werden.

In der Protokollierung kann der Umfang der geschriebenen Logs beeinflusst werden. Ein umfangreicheres Logging erhöht die Dauer des Imports.
Wenn die Einstellungen vollständig vorgenommen wurden, kann der Import über Importvorgang starten angestoßen werden. Bitte beachte, dass die Dauer des Imports sowohl von der Größe der JDisc-Datenbank, als auch von der verwendeten Hardware abhängig ist.
Wenn der Import abgeschlossen wurde, wird eine Zusammenfassung im Bereich Ergebnis angezeigt.
Beim Import erzeugte Logs findest du im i-doit-Verzeichnis log/.

Durch das klicken des Pause Buttons wird der Import für die Dauer einer festgelegten Zeitspanne pausiert. Dies kann mit der Einstellung Maximale Länge der Importpause innerhalb der i-doit JDisc Einstellungen konfiguriert werden. Nachdem das eingestellte Zeitlimit erreicht wurde wird der Import entweder abgebrochen oder fortgesetzt. Dies ist abhängig von der Einstellung Verhalten des pausierten Imports. Der Import kann außerdem jederzeit manuell fortgesetzt oder abgebrochen werden.
Ein pausierter Import kann über den Fortsetzen Button wieder fortgesetzt werden.
Der Abbrechen Button kann jeder Zeit während eines laufenden Imports betätigt werden und sorgt anschließend dafür, dass der laufende Import abgebrochen wird, die bereits importierten Objekte verbleiben allerdings in der Datenbank.

Die oben genannten Einstellungen können unter Verwaltung → Mandanten Verwaltung → Einstellungen für Mandant → JDisc vorgenommen werden.

Import über die Kategorie JDisc Discovery#

Über die Kategorie JDisc Discovery können Sie einzelne Objekte aktualisieren. Hier besteht die Möglichkeit, das Gerät über eine bestimmte Identifikation zu scannen (Hostadresse, FQDN und Seriennummer).

Die Kategorie können Sie über die Objekttyp Konfiguration des Objekttyps hinzufügen.

Import über die i-doit Console#

Der Import der Daten aus JDisc nach i-doit ist nicht nur manuell über die Oberfläche möglich. Er kann ebenfalls über die i-doit Console ausgeführt und somit automatisiert werden. Wie der entsprechende Aufruf erzeugt wird, finden Sie im zugehörigen Artikel mit einem Beispiel für die Option import-jdisc.

Für den Import lässt sich die ID des gewünschten Profils angeben. Die ID ist in der Liste der Profile zu finden:

Ebenfalls kann die ID des zu verwendenden JDisc Servers angegeben werden. Diese ist in der Konfiguration zu finden:

Eine jdisc.ini könnte so aussehen mehr Informationen zu .ini Dateien sind hier zu finden.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

[commandArguments]
[commandOptions]
user=admin
password=admin
tenantId=6
profile=1
group=
mode=1
server=2
overwriteHost
detailedLogging=3
regenerateSearchIndex
[additional]

Aufruf aus dem i-doit Verzeichnis:

1

sudo -u www-data php console.php import-jdisc -c jdisc.ini

Report views#

JDisc-Verfügbarkeit#

Unter Report Manager -> Views ist ein Report mit dem Namen JDisc-Verfügbarkeit zu finden, der i-doit Objekte mit JDisc objekten vergleicht.

JDisc delete devices#

Unter Report Manager -> Views ist ein Report mit dem Namen JDisc delete devices zu finden, dieser listet alle JDisc Objekte auf, die in i-doit archiviert oder gelöscht sind. Die jeweiligen Objekte können dann ausgewählt und anschließend in JDisc gelöscht werden. Die in JDisc gelöschten Objekte werden im Device Deletion Log gelogged.

FAQ#

Der JDisc Import verwendet ein festes memory_limit von 2G, sollte beim JDisc Import der Suchindex dieses Limit überschreiten sollte der Key system.memory-limit.jdisc = 3G zu den Experteneinstellungen hinzugefügt werden.