Vous êtes sur la page 1sur 7

OCS INVENTORY NG

INSTALLATION DES AGENTS

par Baptiste DELEBECQ d'après la documentation d'OCS Inventory NG (http://wiki.ocsinventory-ng.org/)

1.

Installation de l'agent Windows

2

1.1.

Fichiers utiles pour le déploiement de l'agent Windows

2

1.2.

Procédure d'installation manuelle

2

1.3.

Procédure d'installation automatique

2

1.3.1. Présentation

2

1.3.2. Mise en oeuvre

3

1.3.3. Utilisation

3

2.

Installation de l'agent Linux

4

2.1.

Éléments requis

4

2.2.

Installation

5

2.2.1. Installation détaillée

5

2.2.2. Installation "rapide"

5

2.2.3. Utilisation

5

3.

Annexes

6

3.1.

Annexe 1

6

3.2.

Annexe 2

7

3.3.

Annexe 3

7

3.4.

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-Cambrésis (UVHC)

OCS INVENTORY NG

INSTALLATION DES AGENTS

1. INSTALLATION DE L'AGENT WINDOWS

1.1. Fichiers utiles pour le déploiement de l'agent Windows

OcsAgentSetup.exe

: fichier d'installation de l'agent.

OcsLogon.exe

: fichier permettant le télé-déploiement (installation automatique) de l'agent

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

1.2. Procédure d'installation manuelle

Lancer

OcsAgentSetup.exe

sur l'ordinateur client. Après 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 même serveur.

Les arguments que vous souhaiteriez passer à l'agent (champ

Miscellaneous

).

Il est possible d'interdire à l'agent d'utiliser les réglages proxy système (Internet Explorer) en

cochant l'option

sont détaillés dans le

tableau en Annexe 1, on y retrouvera entre autres un argument ayant le même effet que

l'option

Après validation de ces paramètres, l'installation se poursuit en donnant la possibilité

d'installer

étant

No Proxy .
No Proxy
.

Les différents arguments possibles dans le champ

No Proxy

précédemment décrite.

l'agent

dans

un

répertoire

Miscellaneous

personnalisé,

celui

par

défaut

C:\Program Files\OCS Inventory Agent\

.

L'agent est automatiquement défini comme service à démarrer automatiquement avec le système.

Cette méthode d'installation n'a que peu d'intérêt car elle nécessite de renouveler l'opération sur chacune des machines du parc.

1.3. Procédure d'installation automatique

1.3.1. Présentation

Ce mode de déploiement utilise le fichier différentes :

OcsLogon.exe

qui peut être utilisé de deux manière

Soit dans un script d'ouverture de session, un peu fastidieux dans notre cas étant donné le nombre d'utilisateurs différents.

Soit dans une règle GPO (Group Policy Object) d'Active Directory qui permet de lancer l'agent à chaque démarrage des ordinateurs ou de l'installer si il n'est pas présent. Cette méthode semble plus adaptée à nos besoins, c'est donc celle que nous allons décrire.

tentera de se connecter au serveur de communication en utilisant le

, pour modifier cette valeur sans l'ajouter comme nom DNS il suffira de

de

Par défaut

DNS

renommer

OcsLogon.exe ocsinventory-ng
OcsLogon.exe

OcsLogon.exe

OcsLogon.exe ocsinventory-ng
ocsinventory-ng

ocsinventory-ng

le

fichier

OcsLogon.exe

par

le

nom

DNS

ou

l'adresse

IP

du

serveur

communication.

OCS INVENTORY NG

INSTALLATION DES AGENTS

1.3.2. Mise en oeuvre

Pour déployer l'agent au moyen de GPO Active Directory, commençons par ouvrir la console

propriétés

correspondantes à notre nom de domaine Active Directory ou Unité Organisationnelle. Dans

l'onglet

l'Ordinateur).

, créons une nouvelle stratégie (on utilisera une stratégie de

Utilisateurs

et

ordinateurs

Active

Directory

Stratégie de Groupe

afin

d'éditer

les

Déroulons l'arbre

Configuration Ordinateur

pour aller dans

Paramètres Windows

puis

Scripts (Démarrage/arrêt)

pour sélectionner

Démarrage

.

Affichons maintenant les fichiers et scripts utilisés par le script de démarrage pour y ajouter

notre fichier

OcsLogon.exe

; fermons ce répertoire.

Après avoir cliqué sur

Ajouter

puis

Parcourir

, nous pouvons sélectionner notre fichier et

définir les

Paramètres de script

, les arguments possibles sont détaillés dans le tableau en

Annexe 2.

Nous pouvons à présent valider les fenêtres pour terminer l'activation de la nouvelle règle GPO.

Au prochain démarrage de chaque ordinateur, l'Agent sera installé dans le répertoire

C:\Program Files\OCS Inventory Agent

1.3.3. Utilisation

et sera lancé.

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 décrites pour l'installation locale (Annexe 1).

OCS INVENTORY NG

INSTALLATION DES AGENTS

2. INSTALLATION DE L'AGENT LINUX

Le déploiement de l'agent sous Linux est un peu plus complexe que sous Windows.

Tout d'abord on ne pourra pas le déployer automatiquement depuis le serveur, à moins que les systèmes en question ne disposent déjà d'un agent OCS de version antérieure (en effet le mise à jour peut se faire de manière 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. Éléments requis

Dmidecode 2.2 ou supérieure

PERL 5.6 ou supérieur

Module PERL XML::Simple version 2.12 ou supérieure

Module PERL Compress::Zlib version 1.33 ou supérieure

Module PERL Net::IP version 1.21 ou supérieure

Module PERL LWP::UserAgent version 5.800 ou supérieure

Module PERL Digest::MD5 version 2.33 ou supérieure

Module PERL Net:SSLeay version 1.25 ou supérieure

Utilitaire Make

Compilateur C/C++ tel que GNU GCC

Concernant les modules PERL voici les commandes pour les installer :

Debian :

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

Fedora :

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

Le script d'installation peut aussi installer de lui-même ces modules, mais seulement s'il n'en existe pas de version antérieure sur l'ordinateur (il ne peut pas les mettre à jour). Il est donc préférable d'installer soi-même ces modules. De plus il est important de souligner que si l'installation de l'un de ces modules nécessite 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 problème sera reportée dans un

fichier

ocs_agent_setup.log

permettant de localiser le problème et d'y remédier.

OCS INVENTORY NG

INSTALLATION DES AGENTS

2.2. Installation

2.2.1. Installation détaillée

la

commande via le script

) ; à plusieurs reprises le programme demandera de confirmer ou de modifier un

paramètre en proposant plusieurs choix (les choix par défaut é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 réseau (étant donc capable de communiquer avec le serveur).

Si un ordinateur déconnecté du réseau doit également être inventorié, nous entrerons la

valeur

lui indiquant qu'il ne doit pas envoyer d'inventaire mais générer un fichier le

contenant, ce fichier pourra par la suite être amené manuellement (via une clé USB par exemple) au serveur.

, qui constitue une donnée supplémentaire

sur la machine (salle, bâtiment, groupe de machines, etc.). Dans notre cas ceci n'est pas nécessaire, on peut donc laisser le champ vide.

), nous pouvons lancer l'installation

Après

avoir

décompressé

l'archive

OCSNG_LINUX_AGENT_1.01.tar.gz

).

l'aide

de

tar –xzvf OCSNG_LINUX_AGENT_1.01.tar.gz

setup.sh

(en exécutant la commande

cd OCSNG_LINUX_AGENT_1.01

[]
[]

suivie de

sh
sh
setup.sh
setup.sh
local
local

Le programme demandera aussi de saisir un

TAG
TAG

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 présence des composants cités précédemment 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.

Dans

le

cas d'une

utilisation non locale, il faudra

2.2.2. Installation "rapide"

Pour gagner du temps on peut faire cette installation de manière plus implicite en ajoutant à

la commande

sh setup.sh

les arguments présentés dans le tableau en Annexe 3.

Les problèmes que pourrait rencontrer l'agent durant son exécution sont répertoriés dans le

fichier

/var/log/ocsinventory-client

2.2.3. Utilisation

L'agent peut être lancé manuellement grâce à la commande décrits dans le tableau en Annexe 4.

ocsinv
ocsinv

suivie des arguments

OCS INVENTORY NG

INSTALLATION DES AGENTS

3. ANNEXES

3.1. Annexe 1

Arguments

Descriptions

 

/S

Installation en mode "silencieux" ne nécessitant pas d'interaction avec l'utilisateur.

/UPGRADE

Permet de mettre à jour une précédente installation de l'Agent de Service

/NOSPLASH

Permet de désactiver l'écran d'accueil.

 

/SERVER:[nom]

Demande à l'agent de se connecter au serveur

[nom]

.

/NP

Désactive l'usage des paramètres proxy d'Internet Explorer.

 

/PNUM:XX

Spécifie un port pour communiquer avec le serveur de

 

communication. Par exemple :

/pnum:8080

.

/LOCAL

Fait fonctionner l'agent en mode inventaire local. Seul un fichier

{hostname}.ocs

, en XML compressé contenant les résultats de

l'inventaire, sera créé dans le répertoire de l'agent.

 

/FILE

Identique à "/local", mais qui interagit avec le serveur de communication.

 

/XML

Crée un fichier XML non compressé

{hostname}.xml

, contenant

les résultats de l'inventaire dans son répertoire.

 

/NOTAG

Le client ne demande pas à l'utilisateur la valeur TAG.

 

/TAG:"valeur"

Spécifie la valeur TAG.

 

/HKCU

Force l'agent à chercher les logiciels installés répertoriés sous la

rubrique

HKEY_CURRENT_USER du registre.

   

/DEBUG

Crée un fichier log

{hostname}.log

dans le répertoire de l'agent.

/FORCE

Force l'agent à toujours envoyer les résultats de l'inventaire,

 

indépendamment du paramètre

FREQUENCY

.

/UID

Force l'agent à générer un nouveau

 

deviceid

 

.

/DMI

Si le numéro de série de l'ordinateur ne peut être reçu 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.

 

/BIOSFUNC

Si le numéro de série de l'ordinateur ne peut être reçu 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.

 

/CONF:[filename]

Demande à l'agent d'utiliser le fichier

[filename]

comme fichier

de configuration au lieu de

Ocsinventory.dat

.

/TEST

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.

 

/IPDISC:

Lance IPDISCOVERY sur le réseau nommé

[net_number]

si le

[net_number]

serveur demande un inventaire. Peut être utilisé avec pour s'assurer de son fonctionnement.

/FORCE

 
 

Ne peut être utilisé avec

/LOCAL

.

/FASTIP

L'agent scanne seulement 5 adresses IP s'il est élu comme hôte IPDISCOVER (à utiliser seulement en déboguage ou en test, pas en production).

OCS INVENTORY NG

INSTALLATION DES AGENTS

3.2. Annexe 2

Arguments

Descriptions

 

/DEPLOY:XXXX

Force le déploiement d'une version

XXXX

spécifique de l'agent. Par

exemple :

/DEPLOY:4030

 

/INSTALL

Demande au lanceur d'installer l'Agent de Service, au lieu de l'Agent Solo.

/URL:[url]

Demande au lanceur de télécharger l'Agent Solo

ocsagent.exe

ou

l'Agent de Service

 

ocspackage.exe

depuis

[url]

(sans le nom de

fichier). Utilisable pour le déploiement de l'Agent dans de multiples domaines Active Directory, mais utilisant un seul serveur de Communication.

/NP

Désactive l'usage des paramètres proxy d'Internet Explorer.

 

/PNUM:X

Spécifie un numéro de port pour communiquer avec le serveur de communication. Par défaut, le port HTTP 80 est utilisé.

/LOCAL

Fait fonctionner l'agent en mode inventaire local. Seul un fichier

{hostname}.ocs

,

en XML compressé contenant les résultats de

 

l'inventaire, sera créé dans le répertoire de l'agent.

 

/NOTAG

Le client ne demande pas à l'utilisateur la valeur

TAG

.

/TAG:"valeur"

Spécifie la valeur

TAG

en ligne de commande.

 

/DEBUG

Créé un fichier log

{hostname}.log

dans le répertoire de l'agent.

/FOLDER:[PATH]

Demande au lanceur d'installer l'agent dans le répertoire

 

d'installation nommé

[PATH]

. Doit être le dernier argument.

3.3. Annexe 3

Arguments

Descriptions

<SETUP DEPENDANCES>

"1"

pour installer automatiquement les dépendances

manquantes,

"0"
"0"

ne pas les installer (l'installeur s'arrêtera

si une dépendance est manquante).

<ADRESSE SERVEUR>

L'adresse IP ou le nom DNS du serveur de communication.

local

pour un ordinateur non connecté au réseau.

<PORT SERVEUR>

Le port du serveur de communication d'OCS Inventory NG s'il est différent du port HTTP 80 standard.

<VALEUR TAG>

Doit être la valeur

 

TAG

, entre quotes.

3.4. Annexe 4

Arguments

Descriptions

 

-local

Fait fonctionner l'agent en mode inventaire local. Seul un fichier

{hostname}.ocs

,

en XML compressé contenant les résultats de

l'inventaire, sera créé dans le répertoire de l'agent.

 

-xml

Crée un fichier XML non compressé

{hostname}.xml

, contenant les

résultats de l'inventaire dans son répertoire.

 

-nosoft

Ne cherchera pas les logiciels installés.

 

-tag="tag"

Dit à l'agent de paramétrer la valeur

TAG

à

"tag"

.

-force

Force l'agent à toujours envoyer les résultats de l'inventaire,

indépendamment du paramètre

FREQUENCY

.

-info

Montre une sortie détaillée du fonctionnement de l'agent.

-debug

Force l'agent à produire plus de détails dans le fichier log, montrant les échanges XML avec le serveur de communication.