OCS INVENTORY NG

INSTALLATION
1. 1.1. 1.2. 1.3.

DES AGENTS

par Baptiste DELEBECQ d'aprs la documentation d'OCS Inventory NG (http://wiki.ocsinventory-ng.org/) Installation de l'agent Windows .......................................................2 Fichiers utiles pour le dploiement de l'agent Windows .............................2 Procdure d'installation manuelle ..........................................................2 Procdure d'installation automatique .....................................................2 1.3.1. Prsentation ..............................................................................2 1.3.2. Mise en oeuvre ..........................................................................3 1.3.3. Utilisation .................................................................................3

2. Installation de l'agent Linux ............................................................4 2.1. lments requis ..................................................................................4 2.2. Installation .........................................................................................5 2.2.1. Installation dtaille ...................................................................5 2.2.2. Installation "rapide" ...................................................................5 2.2.3. Utilisation .................................................................................5 3. 3.1. 3.2. 3.3. 3.4. Annexes ...........................................................................................6 Annexe 1 ............................................................................................6 Annexe 2 ............................................................................................7 Annexe 3 ............................................................................................7 Annexe 4 ............................................................................................7

Projet S6 Inventaire
Etudiants : Fabien Crespel (fabien@crespel.net) Baptiste Delebecq (delebecqbaptiste@hotmail.fr) Fabienne Noizet (fabienne_noizet@hotmail.com) Projet encadr par : Vincent Poirriez (Vincent.Poirriez@univ-valenciennes.fr) Florent Fareneau (Florent.Fareneau@univ-valenciennes.fr) Formation : Licence 3 SPI Informatique S6/2008 Institut des Sciences et Techniques de Valenciennes (ISTV) Universit de Valenciennes et du Hainaut-Cambrsis (UVHC)

Universit de Valenciennes et du Hainaut-Cambrsis (UVHC) Projet S6 Inventaire

Version du 25/03/08 08:29:41

OCS INVENTORY NG

INSTALLATION

DES AGENTS

1. INSTALLATION

DE L'AGENT

WINDOWS

1.1. Fichiers utiles pour le dploiement de l'agent Windows

OcsAgentSetup.exe : fichier d'installation de l'agent. OcsLogon.exe : fichier permettant le tl-dploiement (installation automatique) de l'agent

Windows. Si l'agent est install, il le fera juste fonctionner, sinon il le tlchargera automatiquement depuis le serveur de communication, l'installera et le lancera.

1.2. Procdure d'installation manuelle

Lancer OcsAgentSetup.exe sur l'ordinateur client. Aprs acceptation de la licence il sera demand de remplir les champs suivants :
L'adresse du serveur de communication OCS Inventory NG. Le port ouvert sur ce mme serveur. Les arguments que vous souhaiteriez passer l'agent (champ Miscellaneous).

Il est possible d'interdire l'agent d'utiliser les rglages proxy systme (Internet Explorer) en cochant l'option No Proxy. Les diffrents arguments possibles dans le champ Miscellaneous sont dtaills dans le tableau en Annexe 1, on y retrouvera entre autres un argument ayant le mme effet que l'option No Proxy prcdemment dcrite. Aprs validation de ces paramtres, l'installation se poursuit en donnant la possibilit d'installer l'agent dans un rpertoire personnalis, celui par dfaut tant C:\Program Files\OCS Inventory Agent\. L'agent est automatiquement dfini comme service dmarrer automatiquement avec le systme. Cette mthode d'installation n'a que peu d'intrt car elle ncessite de renouveler l'opration sur chacune des machines du parc.

1.3. Procdure d'installation automatique

1.3.1. Prsentation
Ce mode de dploiement utilise le fichier OcsLogon.exe qui peut tre utilis de deux manire diffrentes :
Soit dans un script d'ouverture de session, un peu fastidieux dans notre cas tant donn le

nombre d'utilisateurs diffrents.

Soit dans une rgle GPO (Group Policy Object) d'Active Directory qui permet de lancer l'agent

chaque dmarrage des ordinateurs ou de l'installer si il n'est pas prsent. Cette mthode semble plus adapte nos besoins, c'est donc celle que nous allons dcrire. Par dfaut OcsLogon.exe tentera de se connecter au serveur de communication en utilisant le DNS ocsinventory-ng, pour modifier cette valeur sans l'ajouter comme nom DNS il suffira de renommer le fichier OcsLogon.exe par le nom DNS ou l'adresse IP du serveur de communication.

2/7

OCS INVENTORY NG

INSTALLATION

DES AGENTS

1.3.2. Mise en oeuvre

Pour dployer l'agent au moyen de GPO Active Directory, commenons par ouvrir la console Utilisateurs et ordinateurs Active Directory afin d'diter les proprits correspondantes notre nom de domaine Active Directory ou Unit Organisationnelle. Dans l'onglet Stratgie de Groupe, crons une nouvelle stratgie (on utilisera une stratgie de l'Ordinateur). Droulons l'arbre Configuration Ordinateur pour aller dans Paramtres Windows puis Scripts (Dmarrage/arrt) pour slectionner Dmarrage. Affichons maintenant les fichiers et scripts utiliss par le script de dmarrage pour y ajouter notre fichier OcsLogon.exe ; fermons ce rpertoire. Aprs avoir cliqu sur Ajouter puis Parcourir, nous pouvons slectionner notre fichier et dfinir les Paramtres de script, les arguments possibles sont dtaills dans le tableau en Annexe 2. Nous pouvons prsent valider les fentres pour terminer l'activation de la nouvelle rgle GPO. Au prochain dmarrage de chaque ordinateur, l'Agent sera install dans le rpertoire C:\Program Files\OCS Inventory Agent et sera lanc.

1.3.3. Utilisation
L'agent peut aussi tre lanc manuellement par la commande suivante : C:\Program Files\OCS Inventory Agent\OCSInventory.exe [options] o les options sont celles dcrites pour l'installation locale (Annexe 1).

3/7

OCS INVENTORY NG

INSTALLATION

DES AGENTS

2. INSTALLATION

DE L'AGENT

LINUX

Le dploiement de l'agent sous Linux est un peu plus complexe que sous Windows. Tout d'abord on ne pourra pas le dployer automatiquement depuis le serveur, moins que les systmes en question ne disposent dj d'un agent OCS de version antrieure (en effet le mise jour peut se faire de manire automatique condition que l'inventaire se fasse par protocole HTTP), sinon il faudra passer sur chacune des machines pour y installer les paquets.

2.1. lments requis

Dmidecode 2.2 ou suprieure PERL 5.6 ou suprieur

Module PERL XML::Simple version 2.12 ou suprieure Module PERL Compress::Zlib version 1.33 ou suprieure Module PERL Net::IP version 1.21 ou suprieure Module PERL LWP::UserAgent version 5.800 ou suprieure Module PERL Digest::MD5 version 2.33 ou suprieure Module PERL Net:SSLeay version 1.25 ou suprieure
Utilitaire Make Compilateur C/C++ tel que GNU GCC

Concernant les modules PERL voici les commandes pour les installer :

Debian :
apt-get apt-get apt-get apt-get apt-get apt-get install install install install install install libxml-simple-perl libcompress-zlib-perl libnet-ip-perl libwww-perl libdigest-md5-perl libnet-ssleay-perl

Fedora :
yum yum yum yum yum yum install install install install install install perl-XML-Simple perl-Compress-Zlib perl-Net-IP perl-LWP perl-Digest-MD5 perl-Net-SSLeay

Le script d'installation peut aussi installer de lui-mme ces modules, mais seulement s'il n'en existe pas de version antrieure sur l'ordinateur (il ne peut pas les mettre jour). Il est donc prfrable d'installer soi-mme ces modules. De plus il est important de souligner que si l'installation de l'un de ces modules ncessite un programme non install (comme SSLeay qui a besoin d'OpenSSL) alors l'installation de ce module ainsi que celle de l'agent OCS Inventory NG choueront. Dans le cas d'un chec d'installation, l'erreur l'origine du problme sera reporte dans un fichier ocs_agent_setup.log permettant de localiser le problme et d'y remdier.

4/7

OCS INVENTORY NG

INSTALLATION

DES AGENTS

2.2. Installation
2.2.1. Installation dtaille
Aprs avoir dcompress l'archive OCSNG_LINUX_AGENT_1.01.tar.gz ( l'aide de la commande tar xzvf OCSNG_LINUX_AGENT_1.01.tar.gz), nous pouvons lancer l'installation via le script setup.sh (en excutant la commande cd OCSNG_LINUX_AGENT_1.01 suivie de sh setup.sh) ; plusieurs reprises le programme demandera de confirmer ou de modifier un paramtre en proposant plusieurs choix (les choix par dfaut tant entre []). Lorsque le programme demande le type de protocole utiliser lors de l'envoie d'inventaire, nous lui demanderons d'utiliser le protocole HTTP pour tout ordinateur tant connect au rseau (tant donc capable de communiquer avec le serveur). Si un ordinateur dconnect du rseau doit galement tre inventori, nous entrerons la valeur local lui indiquant qu'il ne doit pas envoyer d'inventaire mais gnrer un fichier le contenant, ce fichier pourra par la suite tre amen manuellement (via une cl USB par exemple) au serveur. Le programme demandera aussi de saisir un TAG, qui constitue une donne supplmentaire sur la machine (salle, btiment, groupe de machines, etc.). Dans notre cas ceci n'est pas ncessaire, on peut donc laisser le champ vide. Dans le cas d'une utilisation non locale, il faudra indiquer l'adresse du serveur de communication d'OCS Inventory NG ainsi que le port de ce dernier. Par la suite le programme testera la prsence des composants cits prcdemment et proposera, si l'un d'entre eux est absent, de l'installer. Le refus de cette installation sera synonyme d'abandon de l'installation.

2.2.2. Installation "rapide"

Pour gagner du temps on peut faire cette installation de manire plus implicite en ajoutant la commande sh setup.sh les arguments prsents dans le tableau en Annexe 3. Les problmes que pourrait rencontrer l'agent durant son excution sont rpertoris dans le fichier /var/log/ocsinventory-client

2.2.3. Utilisation
L'agent peut tre lanc manuellement grce la commande ocsinv suivie des arguments dcrits dans le tableau en Annexe 4.

5/7

OCS INVENTORY NG

INSTALLATION

DES AGENTS

3. ANNEXES
3.1. Annexe 1
Arguments /S /UPGRADE /NOSPLASH /SERVER:[nom] /NP /PNUM:XX /LOCAL Descriptions Installation en mode "silencieux" ne ncessitant pas d'interaction avec l'utilisateur. Permet de mettre jour une prcdente installation de l'Agent de Service Permet de dsactiver l'cran d'accueil. Demande l'agent de se connecter au serveur [nom]. Dsactive l'usage des paramtres proxy d'Internet Explorer. Spcifie un port pour communiquer avec le serveur de communication. Par exemple : /pnum:8080. Fait fonctionner l'agent en mode inventaire local. Seul un fichier {hostname}.ocs, en XML compress contenant les rsultats de l'inventaire, sera cr dans le rpertoire de l'agent. Identique "/local", mais qui interagit avec le serveur de communication. Cre un fichier XML non compress {hostname}.xml, contenant les rsultats de l'inventaire dans son rpertoire. Le client ne demande pas l'utilisateur la valeur TAG. Spcifie la valeur TAG. Force l'agent chercher les logiciels installs rpertoris sous la rubrique HKEY_CURRENT_USER du registre. Cre un fichier log {hostname}.log dans le rpertoire de l'agent. Force l'agent toujours envoyer les rsultats de l'inventaire, indpendamment du paramtre FREQUENCY. Force l'agent gnrer un nouveau deviceid. Si le numro de srie de l'ordinateur ne peut tre reu avec WMI, cela force l'agent utiliser les tables DMI pendant que fonctionne l'outil BiosInfo.exe. Autrement, l'agent essaiera en premier les fonctions BIOS et ensuite les tables DMI. Si le numro de srie de l'ordinateur ne peut tre reu avec WMI, cela force l'agent utiliser les fonctions BIOS pendant que fonctionne l'outil BiosInfo.exe. Autrement, l'agent essaiera en premier les fonctions BIOS et ensuite les tables DMI. Demande l'agent d'utiliser le fichier [filename] comme fichier de configuration au lieu de Ocsinventory.dat. L'agent testera seulement la connexion HTTP au serveur de communication et crira un fichier "ok.ok" si tout est bon. utiliser avec les arguments /DEBUG, /NP et /PNUM. Lance IPDISCOVERY sur le rseau nomm [net_number] si le serveur demande un inventaire. Peut tre utilis avec /FORCE pour s'assurer de son fonctionnement. Ne peut tre utilis avec /LOCAL. L'agent scanne seulement 5 adresses IP s'il est lu comme hte IPDISCOVER ( utiliser seulement en dboguage ou en test, pas en production).

/FILE /XML /NOTAG /TAG:"valeur" /HKCU /DEBUG /FORCE /UID /DMI

/BIOSFUNC

/CONF:[filename] /TEST

/IPDISC: [net_number]

/FASTIP

6/7

OCS INVENTORY NG

INSTALLATION

DES AGENTS

3.2. Annexe 2
Arguments /DEPLOY:XXXX /INSTALL /URL:[url] Descriptions Force le dploiement d'une version XXXX spcifique de l'agent. Par exemple : /DEPLOY:4030 Demande au lanceur d'installer l'Agent de Service, au lieu de l'Agent Solo. Demande au lanceur de tlcharger l'Agent Solo ocsagent.exe ou l'Agent de Service ocspackage.exe depuis [url] (sans le nom de fichier). Utilisable pour le dploiement de l'Agent dans de multiples domaines Active Directory, mais utilisant un seul serveur de Communication. Dsactive l'usage des paramtres proxy d'Internet Explorer. Spcifie un numro de port pour communiquer avec le serveur de communication. Par dfaut, le port HTTP 80 est utilis. Fait fonctionner l'agent en mode inventaire local. Seul un fichier {hostname}.ocs, en XML compress contenant les rsultats de l'inventaire, sera cr dans le rpertoire de l'agent. Le client ne demande pas l'utilisateur la valeur TAG. Spcifie la valeur TAG en ligne de commande. Cr un fichier log {hostname}.log dans le rpertoire de l'agent. Demande au lanceur d'installer l'agent dans le rpertoire d'installation nomm [PATH]. Doit tre le dernier argument.

/NP /PNUM:X /LOCAL

/NOTAG /TAG:"valeur" /DEBUG /FOLDER:[PATH]

3.3. Annexe 3
Arguments <SETUP DEPENDANCES> Descriptions "1" pour installer automatiquement les dpendances manquantes, "0" ne pas les installer (l'installeur s'arrtera si une dpendance est manquante). L'adresse IP ou le nom DNS du serveur de communication. local pour un ordinateur non connect au rseau. Le port du serveur de communication d'OCS Inventory NG s'il est diffrent du port HTTP 80 standard. Doit tre la valeur TAG, entre quotes.

<ADRESSE SERVEUR> <PORT SERVEUR> <VALEUR TAG>

3.4. Annexe 4
Arguments -local Descriptions Fait fonctionner l'agent en mode inventaire local. Seul un fichier {hostname}.ocs, en XML compress contenant les rsultats de l'inventaire, sera cr dans le rpertoire de l'agent. Cre un fichier XML non compress {hostname}.xml, contenant les rsultats de l'inventaire dans son rpertoire. Ne cherchera pas les logiciels installs. Dit l'agent de paramtrer la valeur TAG "tag". Force l'agent toujours envoyer les rsultats de l'inventaire, indpendamment du paramtre FREQUENCY. Montre une sortie dtaille du fonctionnement de l'agent. Force l'agent produire plus de dtails dans le fichier log, montrant les changes XML avec le serveur de communication.

-xml -nosoft -tag="tag" -force -info -debug

7/7