From i-doit documentation

Jump to: navigation, search

i-doit Inventory

i-doit inventory - Release Notes

Universell einsetzbare XML-Import Schnittstelle
H-Inventory Scripts zur Inverntarisierung von
- Microsoft Windows
- Debian/Ubuntu Linux
- SUSE Linux
- Fedora Core
- Redhat
- FreeBSD
- Solaris / Open Solaris
Konsolen Interface zum Importieren von XML-Exports (Scriptsteuerung möglich)
Zentrale grafische Oberfläche für den Upload eines Exports
Vorkonfiguriertes Mapping für einen import eines h-inventory exports
Objekt Typ zur Erstellung des Objekts frei wählbar
Inventarisierung von folgenden Werten möglich:
- System
  - Model
  - Hersteller
  - Systemtyp
- CPU
  - Anzahl Prozessoren
  - Hersteller
  - Taktrate
- Arbeitsspeicher
  - Logischer / Physikalischer Speicher
  - Größe
  - Typ
  - Format
  - Bank
- Festplatten
  - Hersteller
  - Laufwerksname
  - Größe
  - Schnittstelle
- CD/DVD Laufwerk
  - Hersteller
- Netzwerk
  - Bezeichnung
  - Hersteller
  - MAC Adresse
  - IP-Adresse
  - Subnetzmaske
  - Gateway
- Grafikkarte
  - Hersteller
  - Bezeichnung
  - Speicher
- Audio
  - Hersteller
  - Bezeichnung
- Desktop Monitor
  - Hersteller
- Tastatur
  - Layout
- Maus
  - Anzahl Tasten
- SCSI Controller
- IDE Controller
- Installierte Applikationen inkl. Betriebssystem und Windows Updates

H-Inventory

Die Scripts zur Inventarisierung stammen aus H-Inventory (http://www.h-inventory.com/).

Die Scripts sind teilweise angepasst und entsprechend erweitert um mit dem i-doit framework zusammen zu arbeiten.

Nutzung

Konfiguration i-doit

Variante 1: Per Konfiguration

Die Konfiguration des Import Moduls muss sich in folgender Datei befinden: i-doit-verzeichnis/src/handler/config/isys_handler_import.inc.php

Eine Beispiel Konfiguration für eine Verbindung zur Mandanten-ID: 1 mit dem Benutzernamen "admin" und Passwort "admin" sieht folgendermaßen aus (i-doit-verzeichnis/src/handler/config/exampls/isys_handler_import.inc.php):

$g_userconf = array(
       "user"                => "admin",      // Benutzername (Vorzugsweise mit Adminberechtigungen)
       "pass"                => "admin",      // Passwort des Benutzers
       "mandator_id"         => 1             // ID* des Mandanten, in welchen die Importierung stattfinden soll
 );

Ist diese Konfiguration nicht fehlerfrei beziehungsweise gar nicht gesetzt, wird unter Umständen folgende Fehlermeldung beim Importieren ausgegeben:

[!] Error : Could not connect to mandator-id: X

Variante 2: Parametrisiert

Alternativ zur Konfigurationsdatei kann das Importscript auch per Parametrisiertem Login gestartet werden. Dies funktioniert mit den folgenden Parametern:

Unix:
./import -u admin -p password -i 1 imports/datei.xml

Windows:
php.exe c:\i-doit-verzeichnis\controller.php -u admin -p admin -i 1 -v -m import imports/datei.xml

Wobei u für den Benutzername, p für das Passwort und i für die ID* des Mandanten stehen kann

Die Mandanten-ID liefert das mitgelieferte Script mit dem Namen "mandator" aus dem Hauptverzeichnis von i-doit

Unix:
 ./mandator ls

Windows:
php.exe c:\i-doit-verzeichnis\controller.php -v -m mandator ls

Per Script (Batch oder BASH) ließen sich über diesen Weg also mehrere XML Dateien auf einmal importieren.

Windows Beispiel: cd c:\programme\i-doit\apache2\htdocs\ for /f %%a IN (‘dir /b *.xml’) do call c:\programme\i-doit\php\bin\php.exe controller.php -u admin -p admin -i 1 -v -m import %%a

i-doit ist nun bereit für einen Import.

Inventarisierung eines Microsoft Windows XP Clients und Erstellung eines Exports via H-Inventory

1. Download des H-Inventory Pakets von i-doit -> Module -> Import -> Scripts

2. Archiv entpacken

3. Zu scannende IP-Adresse(n) in computer.txt eintragen

4. scan.bat ausführen

5. Nach erfolgreicher Abarbeitung des Scripts befindet sich der Export in der Datei "computername-xx.xml" im selben Verzeichnis

Grafischer Import eines H-Inventory Exports

1. i-doit -> Module-> Import -> Importieren

2. XML Datei hochladen

2. Datei aus der Liste der hochgeladenen Exports auswählen

3. Entsprechenden Objekt-Typ und Import Verfahren auswählen - in diesem Fall Client und inventory (für H-Inventory)

4. Importieren mit "Next >>"

5. Der importierte Client ist nun verfügbar

Import eines H-Inventory Exports per cmd (Windows)

1.1 XML-Export in i-doit Verzeichnis bewegen

   # copy *.xml "C:\Program Files\Apache Software Foundation\htdocs\i-doit\imports"

1.2 Starten eines Imports für einen Client

1.2.1 In das i-doit Verzeichnis wechseln

   # cd "C:\Program Files\Apache Software Foundation\htdocs\i-doit"

1.2.2 ID des zu importierenden Objekt-Typen herausfinden (Nach Aufruf des nachfolgenden Befehls wird eine Auflistung aller Objekt-Typen inkl. ID ausgegeben)

   # C:\Programme\PHP\bin\php5.exe controller.php -v -m import

1.2.3 Importierten:

   # C:\Programme\PHP\bin\php5.exe controller.php -v -m import xml-datei inventory objekt-typ-id
                                                  /\                        /\          /\
                                             verbose mode        /\      XML-Typ     Objekt-Typ (Numerische ID)
                                                    Pfad kann relativ zum i-doit  
                                                      verzeichnis oder absolut sein

1.2.4 Beispiel fuer einen H-Inventory Client-Import:

   # C:\Programme\PHP\bin\php5.exe controller.php -v -m import imports/hostname-xx.xml inventory 10
   
   "inventory": Typ der XML-Datei
   "10": ID des Objekt-Typen Client

1.3 Nach Abarbeitung der Import-Prozedur ist der importierte Client im i-doit verfügbar

Import eines H-Inventory Exports per Console (UNIX/Linux)