Documentation:UnixAgent/fr

From OCS Inventory NG
Jump to: navigation, search

Agent OCS pour les systèmes UNIX/LINUX

L'agent OCS Inventory NG pour Linux peut être installé uniquement localement. Impossible pour le moment de déployer cet agent par le réseau comme celà est possible avec l'agent Windows. En revanche, vous pouvez choisir lors de l'installation d'utiliser les mises à jour automatiques de l'agent, si ce dernier utilise la méthode d'inventaire par HTTP.

Warning: Vous devez avoir les privilèges root pour effectuer cette installation.


Prérequis

Modules requis:

  • PERL 5.8
    • Module Perl XML::Simple
    • Module Perl Compress::Zlib
    • Module Perl Net::IP
    • Module Perl LWP::UserAgent
    • Module Perl Digest::MD5
    • Module Perl Net::SSLeay
    • Module Perl Mac::SysProfile pour MacOSX
  • dmidecode
  • lspci sur Linux et *BSD (paquet pciutils)
  • L'utilitaire Make
  • Un compilateur C/C++ comme GNU GCC

Modules optionnels:

    • Module Perl Proc::Daemon
    • Module Perl Proc::PID::File if Proc::Daemon is installed
    • Module Perl Crypt::SSLeay
    • Module Perl Net::SNMP
    • Module Perl Nmap::Parser
    • Module Perl Module::Install
    • Module Perl Net::CUPS
  • Nmap (v3.90 ou supérieure)


Note: Pour l'intégrité du système, il est conseillé d'utiliser les paquets pré-compilés de votre distribution s'ils sont disponibles.


Sur Fedora/Redhat, vous pouvez utiliser l'utilitaire “yum” pour installer les modules requis:

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

Modules optionnels: ces modules sont disponibles sur le dépot EPEL. N'oubliez pas d'ajouter ce dépôt dans votre système ou de télécharger chaque paquet individuellement depuis le dépôt

yum install perl-Crypt-SSLeay
yum install perl-Net-SNMP
yum install perl-Proc-Daemon
yum install perl-Proc-PID-File
yum install perl-Sys-Syslog
yum install pciutils
yum install smartmontools
yum install monitor-edid

Sur Debian, vous pouvez utiliser l'utilitaire “apt-get” pour installer les modules requis:

apt-get install dmidecode
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 

Modules optionnels:

apt-get install libcrypt-ssleay-perl (pour utiliser SSL)
apt-get install libnet-snmp-perl (pour utiliser la fonctionnalité de scans SNMP)
apt-get install libproc-pid-file-perl
apt-get install libproc-daemon-perl
apt-get install net-tools
apt-get install libsys-syslog-perl
apt-get install pciutils
apt-get install smartmontools
apt-get install read-edid
apt-get install nmap

L'agent UNIX 2.0 ne s'installe plus avec le script “setup.sh” comme dans les versions précédentes. Lors de la compilation, la configuration et les informations concernant les dépendances sont retournées sur la console. En revanche, cela n'installera ou ne mettra à jour en aucun cas un module. Si un module a une version antérieure à celle requise, vous devez le mettre à jour vous même.

Warning: L'installeur n'indique pas les composants requis pour les dépendances. Par exemple, Net::SSLeay requiert openssl pour être installé. S'il n'est pas installé, l'installation de Net::SSLeay échouera et l'agent OCS Inventory NG ne sera pas installé.


C'est pourquoi un fichier de log est généré. Si vous rencontrez une erreur lors de l'installation de l'agent, référez vous à ce fichier pour avoir le message d'erreur détaillé.

Installation non-interactive de l'agent

Téléchargez “Ocsinventory-Agent-2.0.x.tar.gz” depuis le site web d'OCS Inventory NG ( http://www.ocsinventory-ng.org/fr/telechargement/telecharger-agent.html ).

1. Décompressez le.

tar –xvzf Ocsinventory-Agent-2.0.x.tar.gz
cd Ocsinventory-Agent-2.0.x

2. Vérifiez la configuration de Perl avec le script Makefile.PL. Il vérifie la configuration de Perl, les librairies, ... et il génère le Makefile. C'est lors de cette vérification que nous allons définir une variable d'environnement temporaire pour passer en mode non interactif.

env PERL_AUTOINSTALL=1 perl Makefile.PL

Exemple :

Please install Crypt::SSLeay if you want to use SSL.
Please install nmap or ipdiscover if you want to use the network discover feature.
Please install Proc::Daemon and Proc::PID::File if you want to use the daemon monde.

3. Compilation

make
make install

Installation interactive de l'agent

Téléchargez “Ocsinventory-Agent-2.0.x.tar.gz” depuis le site web d'OCS Inventory NG ( http://www.ocsinventory-ng.org/index.php?page=2-0-rc1 ).

1. Décompressez le.

tar –xvzf Ocsinventory-Agent-2.0.x.tar.gz
cd Ocsinventory-Agent-2.0.x

2. Vérifiez la configuration de Perl avec le script Makefile.PL. Il vérifie la configuration de Perl, les librairies, ... et il génère le Makefile.

perl Makefile.PL

Exemple :

Please install Crypt::SSLeay if you want to use SSL.
Please install nmap or ipdiscover if you want to use the network discover feature.
Please install Proc::Daemon and Proc::PID::File if you want to use the daemon monde.

3. Compilation

make
make install
Note: L'installeur écrit dans le fichier de log “ocs_agent_setup.log” se situant dans le même répertoire. Si vous rencontrez une erreur lors de l'installation de l'agent, référez vous à ce fichier pour avoir le message d'erreur détaillé.


Une vérification est effectuée lors de l'installation sur le binaire d'interprétation Perl, sur le compilateur C/C++ et sur l'utilitaire make. Si l'un de ces composants est manquant, l'installation sera interrompue.

L'installeur va vérifier:

  • le binaire dmidecode.
  • le module Perl Compress::Zlib
  • le module Perl XML::Simple
  • le module Perl Net::IP
  • le module Perl LWP::UserAgent
  • le module Perl Digest::MD5
  • le module Perl Net::SSLeay

Si l'un d'eux n'est pas trouvé, il vous proposera de l'installer. Entrez “y” pour valider son installation. Si vous entrez “n”, l'installation sera interrompue.

Début de la configuration. Choisissez entre configurer l'agent maintenant ou plus tard.

Unixagent1.jpg

Sélectionnez le chemin du répertoire contenant le fichier de configuration

Unixagent2.jpg

Validez la création du répertoire, et définissez l'adresse du serveur OCs Inventory NG (adresse IP ou nom d'hôte)

Vous allez avoir maintenant le choix entre 3 méthodes pour générer l'inventaire

  1. http: l'ordinateur est connecté au réseau et est en mesure de communiquer avec le serveur via le protocole HTTP. utilisé par défaut
  2. https: l'ordinateur est connecté au réseau et est en mesure de communiquer avec le serveur via le protocole HTTPS. Vous devez configurer SSL sur votre serveur et copier le certificat dans le répertoire de l'agent pour utiliser cette méthode
  3. local: l'ordinateur n'est pas connecté au réseau et l'inventaire sera généré dans un fichier pour être envoyé manuellement au moteur OCS Inventory NG. Cette option doit être définie manuellement dans ocsinventory-agent.conf comme cela :
 local=/tmp

Pour les deux autres méthodes :

 Syntaxe : http[s]://ocsinventory-ng-server[:port]/ocsinventory

Exemples :

serveurOCS.domaine.local
https://w.x.y.z
serveurOCS.domaine.local:1234
https://serveurOCS.domaine.local

Unixagent3.jpg

Choisissez si vous voulez utiliser l'authentification apache, et si vous voulez appliquer un TAG administratif

Unixagent4.jpg

Choisissez si vous voulez créer une tâche cron (tâche planifiée) pour la remontée de l'inventaire, définissez et validez le répertoire des fichiers de l'agent.

Unixagent5.jpg

Choisissez si vous voulez supprimer l'ancienne version de l'agent.

Unixagent6.jpg

Choisissez si vous voulez utiliser les fonctionnalités de déploiement d'applications et de scans SNMP, et choisissez d'envoyer l'inventaire tout de suite.

Unixagent7.jpg

Si le fichier accountinfo n'existe pas, il sera créé, et l'inventaire sera envoyé au serveur.

Unixagent8.jpg


Voici un simple fichier de configuration pour l'agent UNIX/Linux

<CONF>
	<DEVICEID>computer.domain.tld-2006-02-27-13-59-47</DEVICEID>
	<DMIVERSION>2.2</DMIVERSION>
	<IPDISCOVER_VERSION>3</IPDISCOVER_VERSION>
	<OCSFSERVER>my_ocs_com_server.domain.tld:80</OCSFSERVER>
</CONF>
Figure 5 : Fichier de configuration simplifiée de l'agent ocsinv.conf pour un ordinateur connecté au réseau.

Déployer l'agent sans interaction utilisateur à partir du script d'installation

Actuellement impossible dans sa version 2.0. Cette fonctionnalité sera intégrée en version 2.1.

Commutateurs de ligne de commande de l'agent

Si vous rencontrez un problème, l'agent génèrera un fichier de log dans le répertoire “/var/log/ocsinventory-client”.

Cependant, l'agent accepte aussi des commutateurs de ligne de commande. Vous pouvez les utiliser tant que vous lancez l'agent manuellement en utilisant la commande de “ocsinv”:


Commutateurs de ligne de commande
Significations
--local Lance l'agent en mode local, sans aucune connexion avec le serveur de communication. Vous serrez interrogé sur le répertoire de destination quand l'agent génèrera le résultat de l'inventaire dans un fichier XML compressé en fichier d'extension .ocs.
--xml L'agent crée un fichier XML non compressé qui contient le résultat de l'inventaire. Vous serez interrogé sur le répertoire de destination du fichier généré par l'agent. Si cette option n'est pas utilisée avec --local, l'agent tentera de se connecter au serveur de communication pour remonter son inventaire.
--tag=”ma valeur de tag” Définissez la valeur du paramètre TAG avec “ma valeur de tag”.
--force Forcez l'agent à toujours envoyer le résultat de l'inventaire, indépendamment du paramètre FREQUENCY.
--debug Forcez l'agent à générer un fichier de log plus détaillé, montrant les échanges XML avec le serveur de communication.
--nosoftware Ne recherche pas dans la liste des logiciels installés.
--info Visualisez en sortie le détail de l'exécution de l'agent.
--proxy=”PROXY SERVEUR” Spécifiez un proxy.
--lazy Pas plus d'un contact avec le serveur durant le PROLOG_FREQ et effectue un exit si rien n'est à faire.
--daemon Lancez ocsinventory-agent en tâche de fond. Le module Perl Proc::Daemon est requis.
--basevardir=”chemin” Option utilisée pour spécifier un répertoire de destination de stockage des fichiers.
--logfile=”chemin” Option utilisée pour enregistrer les messages de log dans un fichier et supprimer les STDERR.
--user=”utilisateur” Option utilisée pour spécifier un utilisateur à l'authentification du serveur.
--password=”mot de passe” Option utilisée pour spécifier un mot de passe à l'authentification du serveur.

Pour plus d'informations, utilisez

man ocsinventory-agent

Compatibilité

FreeBSD

Version de l'OS Compatibilité Fonctionne avec agent Commentaires
5.x OUI Agent Unix unifié 1.01 32 & 64 bits
6.x OUI Agent Unix unifié 1.01 32 & 64 bits
7.x OUI Agent Unix unifié 1.01 32 & 64 bits
8.x doit être testé

OpenBSD

Version de l'OS Compatibilité Fonctionne avec agent Commentaires
4.5 OUI Agent Unix unifié 1.01 32 & 64 bits
4.6 OUI Agent Unix unifié 1.01 32 & 64 bits


Procédure d'installation

export PKG_PATH="http://ftp.arcane-networks.com/pub/OpenBSD/4.5/packages/i386/"
export OCS_VERSION="1.1.2"
mkdir /var/lib
pkg_add nmap
pkg_add dmidecode
pkg_add pciutils
pkg_add p5-libwww
pkg_add p5-XML-Simple
pkg_add p5-Net-IP	
pkg_add p5-Proc-Daemon
cd
mkdir ocs
wget http://launchpad.net/ocsinventory-unix-agent/1.1.x/ocsinventory-unix-agent-$OCS_VERSION/+download/Ocsinventory-Agent-$OCS_VERSION.tar.gz
tar xvzf Ocsinventory-Agent-$OCS_VERSION.tar.gz
cd Ocsinventory-Agent-$OCS_VERSION
perl Makefile.PL
make
make install

AIX

Version de l'OS Compatibilité Fonctionne avec agent Commentaires
4.x OUI Agent Unix unifié 1.01
5.x OUI Agent Unix unifié 1.01
6 OUI Agent Unix unifié 1.01

Solaris

Version de l'OS Compatibilité Fonctionne avec agent Commentaires
> 8 OUI Agent Unix unifié 1.01