diff --git a/docs/de/daten-konsolidieren/jdisc-discovery.md b/docs/de/daten-konsolidieren/jdisc-discovery.md index 169f4765..c2a344fb 100644 --- a/docs/de/daten-konsolidieren/jdisc-discovery.md +++ b/docs/de/daten-konsolidieren/jdisc-discovery.md @@ -1,11 +1,17 @@ -# JDisc Discovery +--- +title: JDisc Discovery +description: JDisc Discovery +icon: +status: +lang: de +--- [JDisc Discovery](http://www.jdisc.com/de/) 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](https://www.i-doit.com/blog/it-service-management-mit-dem-discovery-tool-jdisc-und-i-doit/) ## 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: +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/](https://jdisc.com/downloads/) @@ -14,7 +20,11 @@ Während des Setups wird abgefragt, welche Passwörter für das im Hintergrund v Die JDisc Dokumentation ist unter [https://jdisc.com/support/documentation/](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/). -!!! info "JDisc WebService mit GraphQL, Quelle [JDisc FAQ](https://jdisc.com/support/faq/)" +[https://jdisc.com/support/](https://jdisc.com/support/) + +Dieser Artikel widmet sich im Folgenden der Schnittstelle zwischen i-doit und JDisc Discovery. + +!!! info "JDisc WebService mit GraphQL, Quelle [JDisc FAQ](https://jdisc.com/support/faq/)" > Der WebService ist ein SOAP basierter Service, mit dem man einzelne Aktivitäten in JDisc fernsteuern kann. Der SOAP Service läuft normalerweise auf Port 9000. Wir haben allerdings für unser neues WEB UI eine moderne GraphQL Schnittstelle implementiert, die den SOAP Service komplett ersetzt! I-Doit kann unser neues GraphQL API ab Version i-doit Release 22 verwenden!
> Ändere einfach den Port auf **443** und das Protokoll auf **HTTPS** um auf das GraphQL Interface umzustellen. Das WebService Add-On wird dann nicht mehr benötigt.
> Das GraphQL API hat nur Vorteile gegenüber dem SOAP Service:
@@ -27,10 +37,7 @@ Die Konfiguration der Schnittstelle befindet sich unter **Verwaltung → Import [![JDisc Konfiguration](../assets/images/de/daten-konsolidieren/jdisc/1-jdisc.png)](../assets/images/de/daten-konsolidieren/jdisc/1-jdisc.png) -!!! info "Archivieren von alten Objekten" - 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**. - -### JDisc-Konfiguration +### Allgemeine Einstellungen | Parameter | Anmerkung | | -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -44,12 +51,12 @@ Die Konfiguration der Schnittstelle befindet sich unter **Verwaltung → Import 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 seit einer bestimmten Anzahl von z.B. X Tagen nicht mehr gesehen wurden, muss unter **Verwaltung → [Mandanten-Name] Verwaltung → Einstellungen für [Mandanten-Name] → JDisc** der Schwellwert und die Schwellwert Einheit gesetzt 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**. -| Parameter | Anmerkung | -| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | -| **Schwellwert** | Eine Zahl. Wenn die Einstellung definiert ist, werden die Objekte, die JDisc innerhalb dieses Zeitraums nicht gesehen hat, beim Import archiviert. | -| **Schwellwert Einheit** | Tage, Wochen oder Monate | +| Parameter | Anmerkung | +| ----------------------- | --------------------------------------------------------------------------------------------------------------------------------------- | +| **Schwellwert** | Wenn die Einstellung definiert ist, werden die Objekte, die JDisc innerhalb dieses Zeitraums nicht gesehen hat, beim Import archiviert. | +| **Schwellwert Einheit** | Tage, Wochen oder Monate | ### Discovery Einstellungen @@ -59,8 +66,8 @@ Um Objekte zu archivieren, die von JDisc seit einer bestimmten Anzahl von z.B. X | ---------------- | ---------------------------------------------------- | | **Benutzername** | Account, der für den Web Service genutzt werden soll | | **Passwort** | Zum Account passendes Passwort | -| **Port** | Benutze **443** für GraphQL | -| **Protokoll** | Benutze **https** für GraphQL | +| **Port** | Standard: **9000** für GraphQL **443** | +| **Protokoll** | Standard: **http** für GraphQL **https** | Auch hier kann nach dem Speichern der Parameter über den Button **Verbindung prüfen** getestet werden, ob die Konfiguration erfolgreich ist. @@ -87,8 +94,8 @@ In der Standard-Installation von i-doit sind bereits vordefinierte Profile vorha 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: -| JDisc-Typ | JDisc-Betriebssystem | Objektnamen modifizieren | FQDN Zusatz | Port Filter | Objekttyp | Import Matching Profil | Standort | Aktionen | -| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | +| JDisc-Typ | JDisc-Betriebssystem | Objektnamen modifizieren | FQDN Zusatz | Port Filter | Objekttyp | Import Matching Profil | Standort | Aktionen | +| -------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------- | | Device Type aus JDisc, der beim Import berücksichtigt werden soll.

Die Liste wird aus der angegebenen JDisc-Instanz ausgelesen und zwischengespeichert. | Betriebssysteme, die JDisc bereits inventarisiert hat.

Oftmals reicht der Device Type für eine Zuweisung zu einem Objekttyp nicht aus, weswegen optional das Betriebssystem angegeben werden kann.

Das Feld kann mit Wildcards (*) versehen werden. | Wandelt den Objekttitel um.

**Unverändert**: Der Objektname wird nicht verändert

**Großbuchstaben**: Der komplette Objektname wird in Großbuchstaben geändert.

**Kleinbuchstaben**: Der komplette Objektname wird in Kleinbuchstaben geändert. | Hängt an den Objekttitel einen FQDN Zusatz an. | Welche Netzwerk-Ports sollen importiert werden?

**Normaler Import**: Alle physikalischen und logischen Ports werden importiert.

**Kein Import**: Im Textfeld können Port-Namen angegeben werden, die ignoriert werden sollen.
Das Feld kann mit Wildcards (*) genutzt werden. (Beispiel: Port-Name: Loopback → Ports mit dem Namen Loopback werden nicht importiert)

**Logischer Port**/**Physikalischer Port**/**FC-Port**: Es werden nur die Ports importiert, deren Name im Textfeld zu finden ist.

Die Kriterien können miteinander kombiniert werden, sodass nur bestimmte physikalische und nur bestimmte logische Ports berücksichtigt werden. | Diesem Objekttyp werden importierte Devices zugeordnet.

Wird kein Objekttyp ausgewählt, werden Devices diesen Types ignoriert. | [Welche Strategie soll erfolgen](objekt-identifizieren-bei-importen.md), um bereits in i-doit dokumentierte Objekte durch einen Import zu aktualisieren?
**Zusätzliche Filter Kriterien sind im Import Matching Profil zu finden** | Beim Import werden Objekte, die den hier genannten Kriterien entsprechen, einem bestimmten Standort zugeordnet. Dies geschieht über die Kategorie **Standort**. | Neue Zuweisung hinzufügen, eine bestehende duplizieren oder löschen. | ### Zusätzliche Optionen @@ -96,10 +103,10 @@ Für jeden Typ in JDisc kann ein äquivalenter Objekttyp in i-doit ausgewählt w | Option | Beschreibung | | --------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Kategorien auswählen** | Welche [Kategorien](../grundlagen/struktur-it-dokumentation.md) sollen beim Import befüllt werden? Es werden nur Kategorien gelistet, die der Import behandeln kann. | -| **MAC-Filter** | Entweder kann eine White- oder eine Blacklist für MAC Addressen gewählt werden. Eine MAC Addresse pro Zeile. | +| **MAC-Filter** | Entweder kann eine White- oder eine Blacklist für MAC Addressen gewählt werden. Eine MAC Addresse pro Zeile. | | **Netzwerk Interfaces importieren als** | Inventarisierte Netzwerk-Schnittstellen können in unterschiedlichen Kategorien abgebildet werden. | | **Software beim Import berücksichtigen** | Soll inventarisierte Software als Objekttyp **Anwendungen** importiert werden? | -| **Software beim Import berücksichtigen** -> **Softwarestandort** | Nur sichtbar wenn **Software beim Import berücksichtigen** aktiviert ist. Setzt den Standort von Anwendungen auf einen bestimmten Standort. Nützlich wenn Berechtigungen auf Grundlage von Standorten verwendet werden. | +| **Software beim Import berücksichtigen** -> **Softwarestandort** | Nur sichtbar wenn **Software beim Import berücksichtigen** aktiviert ist. Setzt den Standort von Anwendungen auf einen bestimmten Standort. Nützlich wenn Berechtigungen auf Grundlage von Standorten verwendet werden. | | **Softwarelizenzen beim Import berücksichtigen** | Sollen inventarisierte Softwarelizenzen als Objekttyp **Lizenzen** importiert werden? | | **Systemdienste importieren** | Sollen inventarisierte Systemdienste als Objekttyp **Systemdienst** importiert werden? | | **Cloud Subscriptionen importieren** | Sollen Daten aus der JDisc Kategorie Cloud importiert werden?
Wird in die Kategorie **Zugewiesene Abonnente** importiert. Die Rückwärtige Kategorie **Zugewiesene Benutzer** ist bei Objekten vom Typ Lizenzen zu finden. | @@ -107,8 +114,8 @@ Für jeden Typ in JDisc kann ein äquivalenter Objekttyp in i-doit ausgewählt w | **Verbindungs Endpunkte importieren** | Die Verbindungen werden nicht in die Verkabelung Kategorie, sondern in die Kategorie "Verbindungs Endpunkte" importiert. Das ermöglicht zwischen der manuellen Verkabelung und der automatischen Verkabelung durch JDisc zu unterscheiden. | | **Einfache Datenbank Modellierung verwenden?** | Soll die neue oder die alte [Datenbanklogik](../anwendungsfaelle/dokumentation-von-datenbanken.md) verwendet werden? | | **Layer-3-Netze beim Import berücksichtigen** | Sollen inventarisierte IP-Netze als Objekttyp **Layer-3-Netze** importiert werden? Ist diese Option gesetzt, wird die **Layer-3-Filter** dargestellt. | -| **Layer-3-Netze beim Import berücksichtigen** -> **Layer-3-Filter** | Nur sichtbar wenn **Layer-3-Netze beim Import berücksichtigen**aktiviert ist. Geben Sie den Bereich in den folgenden Formaten an: 127.0.0.1-127.0.10.255 oder 10.40.55.0/24 oder 10.40.55.7. Eine Regel pro Zeile. | -| **Layer-3-Netze beim Import berücksichtigen** -> **Netzwerkstandort** | Nur sichtbar wenn **Layer-3-Netze beim Import berücksichtigen** aktiviert ist. Setzt den Standort von Layer-3 Objekten auf einen bestimmten Standort. Nützlich wenn Berechtigungen auf Grundlage von Standorten verwendet werden. | +| **Layer-3-Netze beim Import berücksichtigen** -> **Layer-3-Filter** | Nur sichtbar wenn **Layer-3-Netze beim Import berücksichtigen**aktiviert ist. Geben Sie den Bereich in den folgenden Formaten an: 127.0.0.1-127.0.10.255 oder 10.40.55.0/24 oder 10.40.55.7. Eine Regel pro Zeile. | +| **Layer-3-Netze beim Import berücksichtigen** -> **Netzwerkstandort** | Nur sichtbar wenn **Layer-3-Netze beim Import berücksichtigen** aktiviert ist. Setzt den Standort von Layer-3 Objekten auf einen bestimmten Standort. Nützlich wenn Berechtigungen auf Grundlage von Standorten verwendet werden. | | **IP Adressentypen beibehalten** | Sollen **IPv4 Adressen**, **IPv6 Adressen**, **Loopback Adressen**, **Virtuelle Adressen** importiert werden? | | **Importtyp für DHCP IP Adressen** | Sollen per DHCP zugewiesen Adressen überschrieben werden? | | **VLans beim Import berücksichtigen** | Sollen inventarisierte VLANs als Objekttyp **Layer-2-Netze** importiert werden? | @@ -138,13 +145,11 @@ Kategorien die für JDisc erstellt worden sind: - [Support Entitlements](../grundlagen/kategorien-und-attribute.md) - [Zugewiesene Abonnente](../grundlagen/kategorien-und-attribute.md) -### Custom identifier +### Identifizierung von Objekten -!!! attention "Matching Regel" - Die `deviceid` aus JDisc wird immer für die Identifizierung von Objekten verwendet. +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. -JDisc `deviceid` soll bei Anlage des Objekts in der **Custom identifier** Kategorie mit type JDisc zugeordnet werden. Hierdurch sollen die Objekte im nach hinein dann auch identifiziert werden. -Wenn keine Daten vorhanden sind wird auf das Objekt-Matching Profil zurück gegriffen. +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 @@ -152,7 +157,7 @@ Der Import von Inhalten aus JDisc erfolgt über **Extras → Import → JDisc**. [![JDisc Import GUI](../assets/images/de/daten-konsolidieren/jdisc/3-jdisc.png)](../assets/images/de/daten-konsolidieren/jdisc/3-jdisc.png) -Vor dem Ausführen des Imports müssen die Import-Parameter festlegt sein.
+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. | **Import Modus** | **Beschreibung** | @@ -175,6 +180,8 @@ Beim Import erzeugte Logs findest du im i-doit-Verzeichnis `log/`. Ü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). +!!! note "Die Seriennummer ist nur verfügbar wenn der JDisc Server via [GraphQL](#discovery-einstellungen) verbunden wurde" + [![JDisc Profile](../assets/images/de/daten-konsolidieren/jdisc/6-jdisc.jpg)](../assets/images/de/daten-konsolidieren/jdisc/6-jdisc.jpg) Die Kategorie können Sie über die Objekttyp Konfiguration des Objekttyps hinzufügen. @@ -215,6 +222,6 @@ Aufruf aus dem i-doit Verzeichnis: sudo -u www-data php console.php import-jdisc -c jdisc.ini ``` -### JDisc-Verfügbarkeit Report +### JDisc-Verfügbarkeit Report view Unter **Report Manager -> Views** ist ein Report mit dem Namen **JDisc-Verfügbarkeit** zu finden, der i-doit Objekte mit JDisc objekten vergleicht. diff --git a/docs/en/consolidate-data/jdisc-discovery.md b/docs/en/consolidate-data/jdisc-discovery.md index d6becf82..c16c956d 100644 --- a/docs/en/consolidate-data/jdisc-discovery.md +++ b/docs/en/consolidate-data/jdisc-discovery.md @@ -1,4 +1,10 @@ -# JDisc Discovery +--- +title: JDisc Discovery +description: JDisc Discovery +icon: +status: +lang: en +--- [JDisc Discovery](http://www.jdisc.com/en/) makes an inventory of whole networks and recognizes all important operating systems (including HP-UX, Solaris and AIX). It recognizes hardware and software, IP networks, Windows domains and Active Directory. In addition, JDisc Discovery identifies all important virtualization technologies, as well as many cluster environments. @@ -14,11 +20,11 @@ The JDisc documentation can be found at [https://jdisc.com/support/documentation If you have any questions regarding the installation or configuration of JDisc, please contact the manufacturer's support [https://jdisc.com/support/](https://jdisc.com/support/). !!! info "JDisc WebService see [JDisc FAQ](https://jdisc.com/support/faq/)" - > The WebService implements access to some JDisc Functionality using a SOAP interface on port 9000. However, with the new GraphQL-based API, the SOAP service is obsolete. I-Doit can access our GraphQL-API to perform the same tasks as with the WEB Service starting with i-doit Release 22.
- > Simply change the protocol in i-doit to HTTPS and use port 443 and then i-doit will use the GraphQL API and you can uninstall the obsolete WEB Service Add-On.
- > The GraphQL-API offers two major advantages:
- > It is using HTTPS by default (as with the WEB Service, HTTP was used by default)
- > It is a modern and powerful API that lets you automate everything in JDisc.
+ > The WebService implements access to some JDisc Functionality using a SOAP interface on port 9000. However, with the new GraphQL-based API, the SOAP service is obsolete. I-Doit can access our GraphQL-API to perform the same tasks as with the WEB Service starting with i-doit Release 22. + > Simply change the protocol in i-doit to HTTPS and use port 443 and then i-doit will use the GraphQL API and you can uninstall the obsolete WEB Service Add-On. + > The GraphQL-API offers two major advantages: + > It is using HTTPS by default (as with the WEB Service, HTTP was used by default) + > It is a modern and powerful API that lets you automate everything in JDisc. ## Configuration @@ -26,10 +32,7 @@ The configuration of the interface is under **Administration → Import and inte [![jdisc-discovery-interface](../assets/images/en/consolidate-data/jdisc-discovery/1-jd.png)](../assets/images/en/consolidate-data/jdisc-discovery/1-jd.png) -!!! info "Archive outdated objects" - To archive objects that have not been seen by JDisc for a certain number of days, the threshold value and the threshold value unit must be set at **Administration → [Tenant name] management → Settings for [Tenant name] → JDisc**. - -### JDisc configuration +### Common Settings | Parameter | Comment | | ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | @@ -45,10 +48,10 @@ After the parameters are saved, you can test the connection to the JDisc databas To archive objects that have not been seen by JDisc for a certain number of e.g. X days, the threshold value and the threshold value unit must be set under **Administration → [Tenant name] management → Settings for [Tenant name] → JDisc**. -| Parameter | Anmerkung | -| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- | -| **Threshold** | Eine Zahl einfügen. When the setting is defined, the objects have not been seen by JDisc within this time period will be archived on import. | -| **Threshold unit** | Days, Weeks oder Month | +| Parameter | Anmerkung | +| ------------------ | ------------------------------------------------------------------------------------------------------------------------ | +| **Threshold** | When the setting is defined, the objects have not been seen by JDisc within this time period will be archived on import. | +| **Threshold unit** | Days, Weeks or Month | ### Discovery settings @@ -58,8 +61,8 @@ The user can activate a scan with the configured JDisc instance with i-doit. For | ------------ | ------------------------------------------- | | **Username** | The account to be used for the web service. | | **Password** | Password for the account | -| **Port** | Use **443** for GraphQL | -| **Protocol** | Use: **https** for GraphQL | +| **Port** | Default: **9000** for GraphQL **443** | +| **Protocol** | Default: **http** for GraphQL **https** | After saving the parameters, you can test whether the configuration was successful with the **Check connection** button. @@ -71,7 +74,7 @@ The JDisc profiles of i-doit provide the possibility to define the connection of The i-doit default installation already provides predefined profiles. Among these predefined profiles is the **Complete import** profile which has the purpose to import all data in i-doit which have been inventoried by JDisc. -!!! note "Create your own profiles" +!!! note "Own profiles" Keep in mind that you would need to alter these profiles to fit your installation and available types of objects from JDisc mapped to i-doit object types. ### General configuration @@ -86,8 +89,8 @@ The i-doit default installation already provides predefined profiles. Among thes For each type in JDisc you can select an equivalent object type in i-doit. If none is selected, devices of this type will not be imported. The order of allocations is observed during import. In order to identify an allocation, the list is processed from top to bottom. For each line the matrix has the following structure: -| JDisc type | JDisc operating system | Objekt title transform | FQDN Addition | Port filter | Object matching profile | Object-type | Location | Actions | -| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | +| JDisc type | JDisc operating system | Objekt title transform | FQDN Addition | Port filter | Object matching profile | Object-type | Location | Actions | +| ---------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- | | Device type from JDisc which is to be considered during import

The list is read out from the specified JDisc instance and kept in the buffer. | Operating systems which already have been inventoried by JDisc.

Often the device type isn't sufficient for an assignment to an object type, therefore you can enter the operating system as an option.

You can enter wildcards (\*) in this field. | Converts the object title.

**"As is" Unchanged**: The object name is not changed

**"Uppercase" letters**: The complete object name is changed to upper case.

**"Lowercase" letters**: The entire object name is changed to lower case. | Appends an FQDN addition to the object title. | Which network ports do you want to import?

**Normal import**: All physical and logical ports are imported.

**No import**: In the text field you can enter port names which shall be ignored.
The field can be used with wildcards (\*). (Example: Port name: Loopback → Ports with the name Loopback are not imported)

**Logical port**/ **Physical port**/ **FC-port**: Only ports which are named in the text field are imported.

You can combine the criteria so that only certain physical and certain logical ports are considered. | [Which strategy do you want to use](object-identification-during-imports.md) to update objects which are already documented in i-doit?
**Additional filter criteria can be found in the Import Matching profile** | Imported devices are assigned to this object type.

If you don't select an object type, devices of this type will be ignored. | Objects which meet the criteria mentioned here are allocated to a certain location during import. This is carried out with the **Location** category. | Add a new assignment, duplicate an existing assignment or delete an assignment. | ### Additional Options @@ -95,10 +98,10 @@ For each type in JDisc you can select an equivalent object type in i-doit. If no | Option | Description | | --------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **Select categories** | Which [categories](../basics/structure-of-the-it-documentation.md) do you want to fill during import? Only supported categories are listed. | -| **MAC filter** | Either a white list or a black list can be selected for MAC addresses. One MAC address per line. | +| **MAC filter** | Either a white list or a black list can be selected for MAC addresses. One MAC address per line. | | **Import network interfaces as** | You can map inventoried network interfaces in different categories. | | **Include software** | Do you want to import inventoried software as object type **Applications**? | -| **Include software** -> **Software location** | Only visible if **Consider software during import** is activated. Sets the location of applications to a specific location. Useful if authorizations are used based on locations. | +| **Include software** -> **Software location** | Only visible if **Consider software during import** is activated. Sets the location of applications to a specific location. Useful if authorizations are used based on locations. | | **Include software licences** | Do you want to import inventoried licenses as object type **Licenses**? | | **Import system services** | Do you want to import inventoried Services as object type **System Services**? | | **Import cloud subscriptions** | Do you want to import inventoried Cloud data?
Data is imported to the category **Assigned subscriptions**. The backward category **Subscriptions** is is assigned to License objects. | @@ -106,8 +109,8 @@ For each type in JDisc you can select an equivalent object type in i-doit. If no | **Import connection endpoints** | The connections are not imported into the cabling category, but into the category "Connection endpoint". This allows to distinguish between manual cabling and automatic cabling by JDisc. | | **Use simple database modelling?** | Should the new or the old database logic be used? | | **Include layer 3 nets** | Do you want to import inventoried IP nets as object type **Layer 3 nets**? | -| **Include layer 3 nets** -> **Layer 3 filter** | Only visible if **Include layer 3 nets** is activated. Specify the range in the following formats: 127.0.0.1-127.0.10.255 or 10.40.55.0/24 or 10.40.55.7. One rule per line. | -| **Include layer 3 nets** -> **Network location** | Only visible if **Include layer 3 nets** is activated. Sets the location of layer-3 objects to a specific location. Useful if authorizations are used based on locations. | +| **Include layer 3 nets** -> **Layer 3 filter** | Only visible if **Include layer 3 nets** is activated. Specify the range in the following formats: 127.0.0.1-127.0.10.255 or 10.40.55.0/24 or 10.40.55.7. One rule per line. | +| **Include layer 3 nets** -> **Network location** | Only visible if **Include layer 3 nets** is activated. Sets the location of layer-3 objects to a specific location. Useful if authorizations are used based on locations. | | **Layer 3 filter** | Specify the range in the following formats: 127.0.0.1-127.0.10.255 or 10.40.55.0/24 or 10.40.55.7. One rule per line. | | **Keep IP address types** | Should IPv4 addresses, IPv6 addresses, loopback addresses, virtual addresses be imported? | | **Import type for DHCP IP addresses** | Should addresses assigned via DHCP be overwritten? | @@ -160,7 +163,7 @@ Because it is possible to apply more than one JDisc server, you have to select t | **Append** | The import mode **"Create"** will create all found objects without checking if they already exist. | | **Update** | The import mode **"Update"** will only create objects that could not be found in i-doit. Categories of already existing objects will be supplemented with new data (if necessary). | | **Overwrite** | The **"Overwrite"** import mode behaves exactly like the "Update" mode with the difference that list categories are first emptied and then newly created. | -| **Update (Existing only)** | The addition of "(Existing only)" will update only existing objects, no new objects are created. | +| **Update (Existing only)** | The addition of "(Existing only)" will update only existing objects, no new objects are created. | | **Overwrite (New inventory)** | With the addition **"(New inventory)"** fixed i-doit-to-jdisc-device links are discarded and the object associations are recalculated. | | **Only create newly scanned devices** | The "**Only create newly scanned devices"** Mode creates only objects that do not exist in i-doit. | | **Update (New inventory)** | With the addition **"(New inventory)"** fixed i-doit-to-jdisc-device links are discarded and the object associations are recalculated. | @@ -215,6 +218,6 @@ If we assume that the jdisc.ini is located in the i-doit root directory, then th sudo -u www-data php console.php import-jdisc -c jdisc.ini ``` -### JDisc availability Report +### JDisc availability Report view -At **Report Manager -> Views** is a report with the name **JDisc availability**, which compares i-doit objects with JDisc objects. +Under **Report Manager -> Views** you will find a report with the name **JDisc availability**, which compares i-doit objects with JDisc objects.