Documentation:Newbie/fr

From OCS Inventory NG
Jump to: navigation, search

La documentation du débutant - Ce qu'il faut savoir

OCS Inventory NG en 5 lignes, c'est quoi ?

OCS Inventory NG soit Open Computer and Software Inventory est une application permettant de réaliser un inventaire automatisé sur la configuration matérielle des machines du réseau et sur les logiciels qui y sont installés. OCS permet de visualiser cet inventaire grâce à une interface web. Il comporte également la possibilité de télé-déployer des applications sur un ensemble de machines selon des critères de recherche. Une fonction des agents nommée IpDiscover, couplée à des scans snmp permet de connaître l'intégralité des interfaces du réseau. Enfin, il est possible de développer ses propres plugins pour remonter des informations spécifiques.

Principe de fonctionnement

Le serveur OCS reçoit les inventaires envoyés par les agents au format XML, et enregistre les données dans sa base de données mysql. Les agents contactent le serveur et pas l'inverse. Le serveur est en mode écoute. Les échanges entre les agents et le serveur se font en http et/ou https. Le déploiement d'applications et les scans snmp se font en https uniquement.


Schéma de transmission des données depuis l'agent jusqu'au serveur de base de données:


Données brutes -> Formatage XML -> envoi HTTP ou HTTPS dans /ocsinventory -> traitement avec mod_perl à la volée -> BDD mysql


Le serveur OCS est composé de 4 éléments :

  1. Le serveur de base de données qui stocke l'information d'inventaire (mysql)
  2. Le serveur de communication qui prend en charge les échanges HTTP ou HTTPS entre le serveur de base de données et les agents (Apache, perl et mod_perl)
  3. La console d'administration pour que l’administrateur réseau puisse interroger le serveur de base de données depuis un navigateur (Apache, php)
  4. Le serveur de déploiement qui stocke toutes les configurations des paquets à déployer (Apache, ssl)
Architecture OCS.jpg

Les outils de déploiement de la solution

Une installation simplifiée du serveur

  • Package XAMPP préconfiguré pour Windows
  • Parckage tar.gz avec script d'installation automatique

Des outils de déploiement des agents par le réseau

Les fonctionnalités supplémentaires

Un interfaçage avec de nombreux logiciels

Classiques

  • GLPI (requête directement la base de données OCS)
  • LDAP pour authentification sur l'interface (ocsreports)

Autres

OCS fournit un Web service SOAP, ce qui lui permet de s'interfacer avec de nombreuses applications, comme Nagios par exemple.

Informations techniques majeures

Agent Windows

Répertoire de configuration de l'agent :

  • C:\Documents and Settings\All Users\Application Data\OCS Inventory NG\Agent sous Windows 2000, XP et 2003.
  • C:\ProgramData\OCS Inventory NG\Agent sous Windows Vista, 2008, Seven et 2008 R2.

Le fichier de configuration de l'agent est ocsinventory.ini

Serveur

Ne pas confondre les répertoires /ocsinventory et /ocsreports.

  • ocsreports : répertoire contenant tous les fichiers php qui constituent l'interface d'administration.

On utilise un navigateur pour y accéder, avec comme URL : http://serveur/ocsreports

  • ocsinventory : répertoire virtuel utilisé par mod_perl pour traiter les fichiers d'inventaires XML envoyés par les agents et enregistrer les données en base de données.
  • Décomposition du serveur OCS
ServeurOCS decompose.png

Débugger la solution

  • Utiliser les logs des agents :
    • Windows : Utiliser le paramètre Debug dans le fichier ocsinventory.ini pour avoir des logs plus parlant. Ce fichier se trouve dans le répertoire :
      • C:\Documents and Settings\All Users\Application Data\OCS Inventory NG\Agent sous Windows 2000, XP et 2003.
      • C:\ProgramData\OCS Inventory NG\Agent sous Windows Vista, 2008, Seven et 2008 R2.

Pour celà, il faut couper le service OCS si l'agent fonctionne en mode service avant de pouvoir modifier ce fichier. Ensuite, passer Debug=2 pour obtenir le niveau de log le plus élevé.

    • Unix/Linux : Utiliser les options --debug et --logfile pour avoir un log détaillé.

Lancer un inventaire avec ces options : ocsinventory-agent --debug --logfile=/mon/path/log.txt

  • Utiliser les logs du serveur :
    • Les logs apache : access.log et error.log.

Utiliser les commandes locate ou find pour trouver le chemin d'accès à ces fichiers.

    • Le log OCS : activity.log

Pour utiliser ce dernier, il faut activer la fonction de log depuis l'interface d'administration (LOGLEVEL), et modifier le fichier de configuration z-ocsinventory-server.conf pour passer l'option OCS_OPT_DBI_PRINT_ERROR à 1. Pensez à redémarrer apache pour prendre en compte cette modification.