Documentation technique

Transcription

1 Conseil en ressources informatiques, intégration et déploiement en Europe. OCS Inventory version A Documentation technique le 4 juillet 2007

2 Sommaire 1 Préambule 4 2 Généralités Pré-requis matériel Schéma de fonctionnement général Déploiement Installation du serveur Installation de l agent sur l ordinateur client Sur un ordinateur exécutant Microsoft Windows Sur un ordinateur exécutant Linux Sur un ordinateur exécutant Mac OS X Dépannage Forcer la remontée Changer les paramètres Pour un agent Windows Pour un agent Linux Pour un agent Mac OS X page du sommaire 2

3 Technologies de sécurité réseau Table de révision date auteur révision description 19/07/07 Julien GUELLEC 1.0 Création du document mobile page du sommaire 3

4 1 Préambule Cette documentation technique à pour objectif de décrire les procédures nécessaires à l installation et à la configuration d un serveur d inventaire de parc informatique basé sur le logiciel libre OCS Inventory. Nous verrons également les étapes nécessaires au déploiement des agents, basés sur les machines clientes, ainsi que leur configuration. OCS Inventory est capable d inventorier : - les périphériques connectés au réseau informatique - les logiciels et les composants matériels installés sur les ordinateurs de ce réseau Mais vous pourrez également déployer des logiciels ou des scripts sur vos machines à distance. Nous verrons dans cette documentation l installation d un tel serveur sur une version stable de Debian et les agents seront quand à eux déployés aussi bien sous Windows que sur Linux. Notez cependant que le serveur peut être installé sur une machine Windows. page 4

5 2 Généralités 2.1 Pré-requis matériel Du point de vue matériel, OCS Inventory ne demande pas forcément une grosse machine ni une grande bande passante : l inventaire complet d une machine Windows consomme environ 5KB de bande passante. 2.2 Schéma de fonctionnement général page 5

6 3 Déploiement 3.1 Installation du serveur Une fois les dépendances installées : 1. Téléchargez la dernière version sur le site officiel : 2. Décompressez l archive récupérée : tar xzf OCSNG_LINUX_SERVER_XX.tar.gz 3. Exécutez le script d installation :./setup.sh 4. Laissez-vous guider par le processus d installation. La plupart des paramètres sont automatiquement sélectionnés. Contrôlez et modifiez ces derniers au besoin. 5. Une fois le processus d installation terminé, éditez le fichier «php.ini» qui se trouve dans le répertoire /etc/php4/apache2/php.ini Vous devez modifier les lignes suivantes : - post_max_size = 60M - post_max_filesize = 60M - décommentez les lignes : extension = mysql.so extension = gd.so 6. Définition du mot de passe administrateur de MySQL : mysqladmin password mot_de_passe 7. Relancez le service apache : /etc/init.d/apache2 restart 8. Connectez-vous sur : avec les identifiants suivants : MySQL login : root MySQL password : votre mot de passe MySQL hostname : localhost page 6

7 3.2 Installation de l agent sur l ordinateur client Sur un ordinateur exécutant Microsoft Windows 1. Téléchargez la dernière version Windows de l agent sur le site officiel : 2. Décompressez l archive et exécutez «OcsAgentSetup.exe» 3. Cliquez sur «Suivant» page 7

8 4. Cliquez sur «J accepte» 5. Renseignez : - Server Name : nom de votre serveur ou adresse IP Serveur de dimension it = xxx.xxx.xxx.xxx - Port Number : 80 par défaut - No Proxy : cliquez pour ne pas utiliser les paramètres du proxy de IE - Miscellaneous : /DEBUG /TAG:"Description de la machine" page 8

9 6. Validez le répertoire d installation L agent OCS Inventory tournera maintenant en tant que service, de façon totalement transparente pour les utilisateurs de la machine. Pas d icône crée sur le bureau ou le menu démarrer, pas d icône dans la barre des tâches. Les informations seront remontées automatiquement au serveur toutes les 24 heures. Cette valeur est modifiable en éditant le fichier service.ini qui se trouve dans le répertoire d installation de l agent : PROLOG_FREQ=24 En cas de problème (ordinateur qui n apparaît pas sur le serveur) rendez-vous à la section «dépannage» de cette documentation technique. page 9

10 3.2.2 Sur un ordinateur exécutant Linux 1. Téléchargez la dernière version Windows de l agent sur le site officiel : 2. Vérifiez la présence des dépendances suivantes. Si l une d elle est manquante, le setup vous proposera de les installer par la suite. dmidecode version 2.2 ou supérieure PERL 5.6 ou supérieur Utilitaire Make Module PERL XML::Simple (version 2.12) Module PERL Compress ::Zlib ((version 1.33) Module PERL Net::IP (version 1.21) Module PERL LWP::UserAgent (version 5.800) Module PERL Digest::MD5 (version 2.33) Module PERL Net::SSLeay (version 1.25) Compilateur C/C++ (GCC) 3. Exécutez le script d installation :./setup.sh 4. Choisissez la méthode d installation «http» 5. Entrez l adresse IP du serveur 6. Entrez le port d écoute du serveur (défaut : 80) 7. Vous n êtes pas obligé d indiquer un "tag", mais donnez un nom caractérisant la machine inventoriée pour pouvoir la repérer plus facilement dans l inventaire. page 10

11 3.2.3 Sur un ordinateur exécutant Mac OS X A l heure de la rédaction de cette documentation, l agent OCS pour les machines s exécutant sous Mac OS X n est pas supporté nativement. Il est toutefois possible d installer un agent sur les machines Apple grâce à des contributions. La procédure à suivre est la suivante : 1. Téléchargez la dernière version de l agent sur : 2. Installez le.dmg et ouvrez un terminal 3. Editez le fichier /etc/ocsinventory-client/ocsinv.conf (attention ce fichier est en lecture seule et doit être édité avec les droits d administrateur) et complétez-le : <?xml version="1.0" encoding="iso "?> <CONF> <DEVICEID></DEVICEID> <OCSFSERVER>xxx.xxx.xxx.xxx</OCSFSERVER> <UPDATE>1</UPDATE> </CONF> 4. Editez le fichier /etc/ocsinventory-client/ocsinv.adm (attention ce fichier est en lecture seule et doit être édité avec les droits d administrateur) et complétez-le : <ADM> <ACCOUNTINFO> <KEYNAME>TAG</KEYNAME> <KEYVALUE>Tag_de_la_machine</KEYVALUE> </ACCOUNTINFO> </ADM> 5. Sauvegardez ces deux fichiers. La remontée d alerte se fera toutes les 10 heures. page 11

12 4 Dépannage 4.1 Forcer la remontée Si la remontée d information ne se fait pas, il convient de lancer manuellement l exécution du service en mode «debug». Un fichier log sera crée et vous permettra de comprendre d où provient la panne. 1. Sur la machine cliente, ouvrez l interpréteur de commande Windows et placez-vous dans le répertoire d installation de l agent. 2. Exécutez la commande suivante : OCSInventory.exe /server:adresse_ip_de_votre_serveur /debug 3. Ouvrez le fichier crée dans le répertoire d installation de l agent portant le nom : nom_machine_cliente.log 4. En fonction de l erreur retournée, référez-vous à la documention officielle, section «Common errors» pour résoudre votre problème. Cette documentation est disponible sur le site : Changer les paramètres Pour un agent Windows Il peut être utile de changer certains paramètres après avoir installé l agent. Pour cela, éditez le fichier service.ini qui se trouve dans le répertoire d installation de l agent et modifiez les paramètres qui vous intéressent. Voici le contenu de ce fichier : [OCS_SERVICE] NoProxy=0 Server=xxx.xxx.xxx.xxx Pnum=80 Miscellaneous=/DEBUG /TAG:"37" /server: xxx.xxx.xxx.xxx /pnum:80 PROLOG_FREQ=10 OLD_PROLOG_FREQ=10 TTO_WAIT=3240 page 12

13 4.2.2 Pour un agent Linux La configuration de l agent OCS installé sur une machine exécutant un Linux se fait dans les deux fichiers suivants : - ocsinv.conf - ocsinv.adm Pour un agent Mac OS X La configuration de l agent OCS installé sur une machine exécutant Mac OS X est très semblable à celle d un agent sous Linux. Les fichiers de configuration à éditer sont les mêmes. page 13