Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
fr:config:ocsng [2008/11/16 11:14]
wawa created
fr:config:ocsng [2015/07/03 11:46] (current)
Line 4: Line 4:
   * créer automatiquement les matériels (Ordinateurs,​ imprimantes,​ écrans, etc)   * créer automatiquement les matériels (Ordinateurs,​ imprimantes,​ écrans, etc)
   * suivre les mises à jour des matériels   * suivre les mises à jour des matériels
 +
 +Dans la suite de ce document, nous allons détailler la configuration de GLPI en mode mono-entité (configuration par défaut de GLPI). En effet, celui-ci devrait suffir à la plupart des besoins.
 +Une partie sur la gestion de l'​import OCS en mode mult-entités est disponible à la fin.
  
  
 ===== Principes généraux de l'​import OCS ===== ===== Principes généraux de l'​import OCS =====
 Le processus d'​import et de synchronisation des données est appelé import OCS, et met en jeu le module GLPI appelé Mode OCSNG. Celui-ci se fait par connexion directe depuis GLPI à la base de données d'OCS. Le processus d'​import et de synchronisation des données est appelé import OCS, et met en jeu le module GLPI appelé Mode OCSNG. Celui-ci se fait par connexion directe depuis GLPI à la base de données d'OCS.
-Durant ces traitements,​ un certain nombre d'​actions sont effectuées par GLPI :+Durant ces traitements,​ un certain nombre d'​actions sont effectuées par GLPI. Les 2 plus importantes sont :
   * vérification des données à importer (afin d'​éliminer les doublons)   * vérification des données à importer (afin d'​éliminer les doublons)
-  * passage du moteur de règles afin d'​affecter la machine (et les matériels associés) dans une entité 
   * import des données avec mise à jour de l'​historique   * import des données avec mise à jour de l'​historique
  
-Les informations suivantes sont importantes pour la compréhension du processus : 
-  * checksum OCS 
-GLPI détecte les modifications sur des machines dans OCS en regardant un attribut nommé //​checksum//​. Celui-ci, mis à jour par OCS, indique quel type de modifications ont été effectué (hardware, logiciel, base de registre, etc). 
-Une fois la machine importée ou synchronisée dans GLPI, le //​checksum//​ est remis à 0. 
- 
- 
-  * TAG OCS 
-OCS dispose d'une information,​ appelée TAG, qui permet d'​effectuer des regroupements de machines (pour des besoins de filtrage de données dans l'​interface OCS, de télédiffusion,​ etc). Cette notion peut-être très utile à GLPI, car elle permet de définir l'​entité de destination d'une machine. 
-De plus, le tag peut-être mis en correspondance avec d'​autres champs de GLPI (Groupe, Lieu, Contact numéro, Réseau). 
  
  
-  * Gestion des doublons dans OCS (paramètre AUTO_DUPLICATE_LVL dans ocsreports) 
-Il est important d'​avoir de bien avoir configuré la gestion des doublons d'OCS. En effet, si vous possédez des doublons dans OCS, cela créera par la suite des doublons dans GLPI 
- 
- 
-  * Type d'​import des données : 
-    * Import global : tout est importé mais le matériel est géré de manière globale (sans doublons) 
-    * Import unique : tout est importé tel quel  
- 
- 
-  * Règles d'​affectation d'une machine à une entité ​ 
-GLPI dispose de 2 modes concernant la gestion des entités : mono et multi-entité. Lors de l'​installation (ou de la migration) vers GLPI, une règle appelée //Root// est mise en place. Celle-ci permet à tout ordinateur provenant d'OCS d'​être placé dans l'​entité racine. 
-<note warning> 
-Il est important de comprendre qu'un ordinateur ne vérifiant aucune règle n'est pas importé dans GLPI. De même le calcul de l'​entité de destination d'un ordinateur ne se fait qu'au moment de l'​import. ​ 
-</​note>  ​ 
- 
- 
-  * Dictionnaires de données 
-Il est possible de mettre en place des dictionnaires de données, qui permettent de modifier à la volée les données provenant d'OCS. Ceux-ci fonctionnent pour  
-    * les logiciels : fusionner, modifier le nom, la version et le fabricant d'un logiciel remontant d'OCS 
-    * modèles : modifier les modèles pour les différents types de matériels 
-    * types : modifier les types de matériels 
-    * OS, Service Pack, Version : modifier les informations sur les OS 
-Vous pouvez trouver une liste de règles sur la page du wiki [[fr:​manuel:​dictionnaries_examples_fr|exemples de dictionnaires]]. 
- 
-==== Mode d'​import OCS disponibles ==== 
-Il y a 3 manières d'​importer les données de la base OCSNG : 
-  * manuelle : l'​administration va dans Outils -> Mode OCSNG. Trois options sont disponibles : 
-    * Importation de nouveaux ordinateurs — Si vous commencez avec une base vierge, sélectionnez « Importation de nouveaux ordinateurs » et sélectionnez les ordinateurs à importer dans GLPI. 
-    * Lier de nouveaux ordinateurs à des ordinateurs existants - Permet de fusionner une machine déjà présente dans GLPI avec une d'OCS 
-    * Synchronisation des ordinateurs déjà importés — Si vous avez déjà réalisé une des deux étapes ci-dessous, pour mettre à jour la base de GLPI depuis OCSInventory-NG,​ sélectionnez « Synchronisation des ordinateurs déjà importés » et sélectionnez les ordinateurs à mettre à jour dans la liste proposée. 
- 
-  * cron interne : toutes les 5 minutes le processus d'​import est lancé par GLPI en tâche de fond 
-  * plugin d'​import en masse OCS : ce plugin permet de  
-    * suivre de manière graphique le processus d'​import 
-    * dispose d'un script multi-threadé sur Unix, mono-threadé sous Windows pour optimiser cette tâche 
- 
-Nous vous recommandons l'​utilisation du plugin d'​import en masse OCS, qui est plus souple et plus optimisé. 
  
 ===== Paramètrage du Mode OCSNG ===== ===== Paramètrage du Mode OCSNG =====
Line 101: Line 57:
 | Utiliser le dictionnaire logiciel d'OCS | Indique si l'on utilise la fonction de dictionnaire fournie par OCS | Toujours laisser à NON si le dictionnaire n'est pas utilisé. Sinon aucun logiciel ne sera remonté. Dans tous les cas, préférez le dictionnaire de GLPI, plus complet et plus puissant | | Utiliser le dictionnaire logiciel d'OCS | Indique si l'on utilise la fonction de dictionnaire fournie par OCS | Toujours laisser à NON si le dictionnaire n'est pas utilisé. Sinon aucun logiciel ne sera remonté. Dans tous les cas, préférez le dictionnaire de GLPI, plus complet et plus puissant |
 | Base de registre | Indique si GLPI doit importer les informations du registre Windows remontées par les agents OCS | | | Base de registre | Indique si GLPI doit importer les informations du registre Windows remontées par les agents OCS | |
-| Nombre d'​éléments à synchroniser via le cron | Indique le nombre de machines qui seront traitées par le mécanise de cron interne à GLPI | Mettez la valeur à si vous utilisez soit un import manuel, soit le plugin d'​import en masse OCS |+| Nombre d'​éléments à synchroniser via le cron | Indique le nombre de machines qui seront traitées par le mécanise de cron interne à GLPI | Mettez la valeur à si vous utilisez soit un import manuel, soit le plugin d'​import en masse OCS |
  
 ==== Informations générales Ordinateurs ==== ==== Informations générales Ordinateurs ====
Line 124: Line 80:
 ==== Dictionnaires logiciels ==== ==== Dictionnaires logiciels ====
 <​note>​ <​note>​
-Le dictionnaire OCS permet de regrouper, sous une seule entrée dans GLPI, plusieurs entrées inventoriées dans CSInventory-NG. Par exemple, si vous avez un logiciel A existant en versions 1.x et 1.y qui sont, de votre point de vue, identiques, vous pouvez définir une catégorie « Logiciel A » dans le dictionnaire de OCSInventory-NG. A l'​importation dans GLPI, au lieu d'​avoir deux entrées, une pour la 1.x et une pour la 1.y, vous n'​aurez plus qu'une entrée générique « logiciel A ». Vous pouvez regrouper sous une même catégorie autant de logiciels que vous le souhaitez, ceux-ci n'​apparaîtront que comme un seul et même logiciel dans GLPI. Notez cependant que vous n'​aurez,​ dans GLPI, aucune information quant aux diverses versions de logiciels inclus dans la catégorie « Logiciel A », contrairement à ce qui se passe avec la catégorie « UNCHANGED » pour laquelle l'​ensemble des informations sont transmises à GLPI.+Le dictionnaire OCS permet de regrouper, sous une seule entrée dans GLPI, plusieurs entrées inventoriées dans OCSInventory-NG. Par exemple, si vous avez un logiciel A existant en versions 1.x et 1.y qui sont, de votre point de vue, identiques, vous pouvez définir une catégorie « Logiciel A » dans le dictionnaire de OCSInventory-NG. A l'​importation dans GLPI, au lieu d'​avoir deux entrées, une pour la 1.x et une pour la 1.y, vous n'​aurez plus qu'une entrée générique « logiciel A ». Vous pouvez regrouper sous une même catégorie autant de logiciels que vous le souhaitez, ceux-ci n'​apparaîtront que comme un seul et même logiciel dans GLPI. Notez cependant que vous n'​aurez,​ dans GLPI, aucune information quant aux diverses versions de logiciels inclus dans la catégorie « Logiciel A », contrairement à ce qui se passe avec la catégorie « UNCHANGED » pour laquelle l'​ensemble des informations sont transmises à GLPI.
  
-GLPI dispose lui aussi d'un dictionnaire logiciel qui permet de modifier à la volée son nom, son fabricant, sa version, voire même de ne pas l'​importer.+GLPI dispose lui aussi d'​un ​[[fr:​manuel:​admin:​7_administration#​dictionnaires|dictionnaire logiciel]] qui permet de modifier à la volée son nom, son fabricant, sa version, voire même de ne pas l'​importer.
 Si vous désirez utiliser le dictionnaire GLPI, il est nécessaire au préalable de ne plus utiliser celui d'OCS. Si vous désirez utiliser le dictionnaire GLPI, il est nécessaire au préalable de ne plus utiliser celui d'OCS.
 +
 </​note>​ </​note>​
  
 +<note warning>​ 
 +Si, après avoir configuré la liaison avec OCS, GLPI ne vous remonte aucun logiciel : 
 +  *  pensez à vérifier que l'​option "​Utiliser le dictionnaire OCS" est à Non. Si ce n'est pas le cas, alors modifier cette option 
 +  *  forcer la synchronisation des ordinateurs en utilisant la modification massive : "​Forcer la synchronisation"​ dans //​Inventaires -> Ordinateurs//​ 
 +</​note>​
  
 ==== Liaison automatique de machines ==== ==== Liaison automatique de machines ====
Line 137: Line 98:
 Son fonctionnement est le suivant : Son fonctionnement est le suivant :
   - Une nouvelle machine remonte d'OCS (c'est à dire que la machine OCS  n'est liée à aucune machine GLPI)   - Une nouvelle machine remonte d'OCS (c'est à dire que la machine OCS  n'est liée à aucune machine GLPI)
-  ​- Le moteur de règle est appelé, l'​entité de destination de la machine est calculée +  - Une requête est faite dans GLPI afin de rechercher les machines potentielles qui ont les caractéristiques configurées dans le module de liaison (par exemple les machines avec le statut //En stock// et dont le //numéro de série// est identique)
-    - Si aucune règle n'est vérifiée, la machine n'est pas importée +
-  ​- Une requête est faite dans GLPI afin de rechercher les machines potentielles ​dans cette entité ​qui ont les caractéristiques configurées dans le module de liaison (par exemple les machines avec le statut //En stock// et dont le //numéro de série// est identique)+
     - Si une et une seule machine est retournée par la requête, alors liaison automatique entre la machine de GLPI et celle qui remonte d'OCS     - Si une et une seule machine est retournée par la requête, alors liaison automatique entre la machine de GLPI et celle qui remonte d'OCS
-    - Sinon création d'une nouvelle machine ​dans l'​entité de destination+    - Sinon création d'une nouvelle machine
  
  
Line 156: Line 115:
 | Numéro de série | Recherche de l'​existance d'une machine dans GLPI par son numéro de série | | | Numéro de série | Recherche de l'​existance d'une machine dans GLPI par son numéro de série | |
 | Chercher les machines GLPI ayant le statut | Recherche de l'​existance d'une machine dans GLPI seuelement parmis les machines de ce statut particulier | | | Chercher les machines GLPI ayant le statut | Recherche de l'​existance d'une machine dans GLPI seuelement parmis les machines de ce statut particulier | |
 +
 +==== Mode d'​import OCS disponibles ====
 +Il y a 3 manières d'​importer les données de la base OCSNG :
 +  * manuelle : l'​administration va dans Outils -> Mode OCSNG. Trois options sont disponibles :
 +    * Importation de nouveaux ordinateurs — Si vous commencez avec une base vierge, sélectionnez « Importation de nouveaux ordinateurs » et sélectionnez les ordinateurs à importer dans GLPI.
 +    * Lier de nouveaux ordinateurs à des ordinateurs existants - Permet de fusionner une machine déjà présente dans GLPI avec une d'OCS
 +    * Synchronisation des ordinateurs déjà importés — Si vous avez déjà réalisé une des deux étapes ci-dessous, pour mettre à jour la base de GLPI depuis OCSInventory-NG,​ sélectionnez « Synchronisation des ordinateurs déjà importés » et sélectionnez les ordinateurs à mettre à jour dans la liste proposée.
 +
 +  * cron interne : toutes les 5 minutes le processus d'​import est lancé par GLPI en tâche de fond
 +  * [[https://​forge.indepnet.net/​projects/​massocsimport/​wiki/​Fr_manuel|plugin d'​import en masse OCS]]: ce plugin permet de 
 +    * suivre de manière graphique le processus d'​import
 +    * dispose d'un script multi-threadé sur Unix, mono-threadé sous Windows pour optimiser cette tâche
 +
 +
 +
 +====== Configuration avancée ======
 +
 +
 +===== GLPI en mode multi-entités =====
 +
 +GLPI dispose de 2 modes de fonctionnement :
 +  * mono-entité : toutes les informations sont visibles par tout le monde
 +  * multi-entité : les informations sont //​cloisonnées//,​ et donc visible seulement par une partie des gens
 +
 +Pour utiliser le mode mono-entités,​ il n'y a pas de configuration particulière à fait, car c'est le mode par défaut.
 +
 +Le passage de la mono à la multi-entités implique la mise en place de règles qui doivent permettre de ranger une nouvelle machine qui remonte d'OCS dans la bonne entité. Celles-ci sont définies dans //​Administration -> Règles -> Règles d'​affectation d'une machine à une entité//.
 +
 +<​note>​
 +Le moteur de règle n'est appelé que lors de l'​import de la machine dans GLPI. Pour changer d'​entité une machine déjà présente dans GLPI, il faut utiliser //​manuellement//​ la fonction de transfert.
 +</​note>​
 +
 +==== Liaison automatique de machines et multi-entités ====
 +En mode multi-entité,​ le processus de liaison automatique effectue les actions suivantes :
 +  - Une nouvelle machine remonte d'OCS (c'est à dire que la machine OCS  n'est liée à aucune machine GLPI)
 +  - Le moteur de règle est appelé, l'​entité de destination de la machine est calculée
 +    - Si aucune règle n'est vérifiée, la machine n'est pas importée
 +  - Une requête est faite dans GLPI afin de rechercher les machines potentielles dans cette entité qui ont les caractéristiques configurées dans le module de liaison (par exemple les machines avec le statut //En stock// et dont le //numéro de série// est identique)
 +    - Si une et une seule machine est retournée par la requête, alors liaison automatique entre la machine de GLPI et celle qui remonte d'OCS
 +    - Sinon création d'une nouvelle machine dans l'​entité de destination
 +
 +===== Pour aller plus loin avec l'​import OCS =====
 +
 +Les informations suivantes sont importantes pour la compréhension du processus :
 +  * checksum OCS
 +GLPI détecte les modifications sur des machines dans OCS en regardant un attribut nommé //​checksum//​. Celui-ci, mis à jour par OCS, indique quel type de modifications ont été effectué (hardware, logiciel, base de registre, etc).
 +Une fois la machine importée ou synchronisée dans GLPI, le //​checksum//​ est remis à 0.
 +
 +
 +  * TAG OCS
 +OCS dispose d'une information,​ appelée TAG, qui permet d'​effectuer des regroupements de machines (pour des besoins de filtrage de données dans l'​interface OCS, de télédiffusion,​ etc). Cette notion peut-être très utile à GLPI, car elle permet de définir l'​entité de destination d'une machine.
 +De plus, le tag peut-être mis en correspondance avec d'​autres champs de GLPI (Groupe, Lieu, Contact numéro, Réseau).
 +
 +
 +  * Gestion des doublons dans OCS 
 +    * paramètre AUTO_DUPLICATE_LVL dans ocsreports
 +    * paramètre TRACE_DELETED dans ocsreports (doit être à On)
 +
 +Il est important d'​avoir bien avoir configuré la gestion des doublons d'OCS. En effet, si vous possédez des doublons dans OCS, cela créera par la suite des doublons dans GLPI
 +
 +
 +  * Type d'​import des données :
 +    * Import global : tout est importé mais le matériel est géré de manière globale (sans doublons)
 +    * Import unique : tout est importé tel quel 
 +
 +
 +  * Règles d'​affectation d'une machine à une entité ​
 +GLPI dispose de 2 modes concernant la gestion des entités : mono et multi-entité. Lors de l'​installation (ou de la migration) vers GLPI, une règle appelée //Root// est mise en place. Celle-ci permet à tout ordinateur provenant d'OCS d'​être placé dans l'​entité racine.
 +<note warning>
 +Il est important de comprendre qu'un ordinateur ne vérifiant aucune règle n'est pas importé dans GLPI. De même le calcul de l'​entité de destination d'un ordinateur ne se fait qu'au moment de l'​import. ​
 +</​note>​
 +
 +
 +