DE:OCS

From i-doit documentation

i-doit Benutzerhandbuch 0.9.x:

Hauptseite | Vorwort | Über dieses Handbuch | Release Notes | Nützliche Links | Installation | Systemkonfiguration | Grundlagen | Empfehlungen zum Vorgehen | Das CMDB-Modul | Allgemeine Kategorien | Spezifische Kategorien | Browser | Objekttypen | Verbindungen | Dateien | Lizenzen | Workflows | my-doit | Kontakte | Einstellungen | Nagios Integration | Report Manager | OCS Inventory NG

Einleitung

Mit Hilfe des Importmoduls kann auf vorhandene OCS-Datenbanken zugegriffen werden, um die dort inventarisierten Objekte in die CMDB von i-doit zu importieren.

Benutzung

Verwaltung

Um die OCS-Schnittstelle zu verwenden sind zunächst Informationen zur Verbindung zu den OCS-Datenbanken zu hinterlegen. Außerdem können die Objekttypen für die Objekte aus OCS festgelegt werden. Dazu muss die Verwaltungsseite aufgerufen werden.

OCS-Datenbanken

Unter dem Punkt OCS-Datenbanken können beliebig viele Datenbankverbindungen gespeichert werden. Hier ist die Angabe des Hostnamens oder der IP des Hosts auf dem die OCS Datenbank liegt, sowie des Ports (Standard: 3306), des Datenbankschemas (der Name der Datenbank) und der Zugangsdaten eines mindestens leseberechtigten MySQL-Benutzers nötig.

OCS Konfiguration

In der Konfiguration kann zum einen der Standardobjekttyp für den Import von OCS-Objekten angegeben werden, zum anderen können für Clients und Server auch Tag-Prefixe angegeben werden, anhand derer der Typ des Hosts automatisch erkannt wird.

Alle Objekte, die später von OCS ins i-doit importiert werden, erhalten als Objekttypen den hier angegebenen.
Wenn für Server oder Clients ein ein Prefix angegeben wird, wird beim Import jedes Objektes geprüft, ob das für den Hosts vergebene Tag mit diesem Prefix beginnt.

Im Beispiel wurde für Server srv_ und für Clients ws_ als Prefix angegeben. Werden später für den Import drei Hosts ausgewählt, die srv_web, ws_mueller und Mailserver heißen, so wird der Host srv_web als Server und ws_mueller als Client importiert. Da keines der beiden Prefixe auf "Mailserver" zutreffen, wird dieser ebenfalls als Client importiert.

Import

Hat man die Einstellungen vorgenommen kann über den Menüpunkt "Import" das Importmodul aufgerufen und dort der Punkt "OCS Objekte" gewählt werden. Hier erscheinen dann alle Hosts, die in den OCS-Datenbanken gespeichert sind.

Von hier aus können über die Checkboxen bereits Objekte gewählt und mit Klick auf den "Importieren >>"-Button importiert werden. Es wird ein Controllermodul aufgerufen, dass den Import vornimmt und Logmeldungen auf der Oberfläche ausgibt.

Mit einem Klick auf einen der Einträge kann eine Detailansicht des entsprechenden Objektes aufgerufen werden.

Hier findet man zunächst eine Übersicht über die Kerninformationen des Objektes. Weiterhin befindet sich dort eine Auswahl, als welcher Objekttyp der Host importiert werden soll. Hier ist der Objekttyp aus der Verwaltung voreigestellt, kann an dieser Stelle aber explizit für dieses Objekt überschrieben werden. Im untern Bereich findet man eine Auswahl der Kategorien, die aus dem OCS übernommen werden sollen. Über den Button "Importieren >>" wird der Import gestartet.

---

Import über die Kommandozeile

Um Hosts aus OCS über die Kommandozeile ins i-doit zu importieren, kann das eingebaute Controllermodul verwendet werden. Das Controllermodul kann wie folgt aufgerufen werden:

php /pfad/zu/idoit/controller.php -v -m ocs

Dieser Aufruf kann z.B. über Cron regelmäßig automatisiert durchgeführt werden.

Es ist möglich, die Hosts, die importiert werden sollen durch ihren Namen in einer Datei anzugeben. In einer solchen Datei müssen alle Hostnamen aufgeführt sein, die importiert werden sollen. Pro Zeile wird hier genau ein Hostname angegeben. So könnte eine Datei "hosts.ocs" folgendermaßen aussehen:

Webserver
Mailserver
SQL-Server

Der entsprechende Aufruf lautet:

php /pfad/zu/idoit/controller.php -v -m ocs hosts.ocs

Welche Kategorien zu importieren sind, kann im Controllermodul selbst angegeben werden. Dies ist die Datei src/handler/isys_handler_ocs.class.php. Im unteren Teil der Datei findet man folgende Codepassage:

$this->m_categories = array("operating_system",
                            C__CATG__CPU,
	   	            C__CATG__MEMORY,
		   	    C__CATG__APPLICATION,
		   	    C__CATG__NETWORK,
		   	    C__CATG__STORAGE,
		   	    C__CATG__DRIVE,
		   	    C__CATG__GRAPHIC,
		   	    C__CATG__SOUND,
		   	    C__CATG__MODEL,
		   	    C__CATG__UNIVERSAL_INTERFACE);

Jede der Konstanten steht für eine Kategorie, wobei die Namen sprechend sind. Es sind standardmäßig alle Kategorien, die importiert werden können in dem Array angegeben. Durch das Löschen von Konstanten können Kategorien aus dem Import entfernt werden.