Documentation:Agent/fr
From OCS Inventory NG
Installer l'agent sur les ordinateurs clients
Il y a deux manières d'inventorier un ordinateur client utilisant l'agent d'OCS Inventory NG :
- Si l'ordinateur client ne peut se connecter au serveur OCS Inventory NG, l'inventaire est fait localement et enregistré dans un fichier XML compressé avec l'extension de fichier ".ocs". L'utilisateur peut alors envoyer ce fichier au moyen d'un courriel, d'un disque USB ou de tout autre manière indiqué par l'Administrateur, ce qui lui permettra de l'importer dans la base de données au moyen du serveur d'Administration.
- Si l'ordinateur client peut se connecter en utilisant le protocol HTTP au serveur de Communication à-travers le réseau, l'agent demandera au serveur de Communication les paramètres pour l'inventaire et enverra le résultat de l'inventaire directement au serveur de Communication.
Sur un système d'exploitation Windows
L'Agent pour Windows d'OCS Inventory NG est capable de travailler en tant que service, démarré automatiquement au démarrage de l'ordinateur. Toutefois, nous fournissons aussi un agent solo ne fonctionnant pas en tant que service, qui peut être lancé au moyen de script de login, de règle GPO Active Directory, de planificateur de tâche ou d'un raccourci dans le menu de démarrage.
N.B. : Nous recommandons que vous utilisiez l'Agent de service, spécifiquement si vous planifiez d'utiliser la fonctionnalité de déploiement de paquet.
Téléchargez et dézippez OCSNG_WIN32_AGENT_1.01.zip. Ce paquet contient 3 fichiers :
- OcsAgentSetup.exe, l'agent installeur avec service Windows inclu. Nous recommandons d'utiliser ce paquet.
- OcsAgent.exe, qui installera l'agent solo sur un ordinateur non connecté à un réseau qui permettra de faire fonctionner l'inventaire manuellement avec l'argument de ligne de commande /LOCAL (ou si vous ne voulez pas utiliser l'agent de service).
- OcsLogon, lanceur de l'agent OCS Inventory NG à utiliser quand vous déployez l'agent au moyen de script de login ou de règle GPO Active Directory sur le domaine. Si l'agent est toujours installé, il fera juste fonctionner l'agent. Dans le cas contraire, il téléchargera le binaire de l'agent depuis le serveur de Communication, l'installera et le lancera.
Quelle version de l'Agent Windows dois-je utiliser ?
En premier, nous allons expliquer comment l'Agent et le Service fonctionnent.
Comment travaille l'Agent Windows ?
Quand l'Agent OCS Inventory NG "OCSInventory.exe" est lancé, il contacte le serveur de Communication en utilisant le protocole HTTP pour lui demander ce qu'il doit faire. Le Serveur peut lui répondre "nothing" (pas le moment pour un inventaire ou aucun paquet à déployer), alors l'agent s'arrête.
Quand l'agent est lancé, il génère seulement l'inventaire et l'envoie.
Autrement, le Serveur peut répondre à l'Agent :
- Envoie un inventaire : l'agent reçoit toutes les propriétés de l'ordinateur et les envoie au serveur en utilisant le protocole HTTP. Le Serveur demande cela si seulement la date du dernier inventaire dans la base de données est plus vieille que l'option de configuration générale "FREQUENCY", spécifiée en jours. (Voir la section intitulée Gérer les options générales d'OCS Inventory NG).
- Découverte du réseau : l'agent reçoit toutes les propriétés de l'ordinateur, scanne son segment de réseau pour découvrir les matériels actifs écoutant le réseau, et envoie ces informations au serveur en utilisant le protocole HTTP. Le Serveur demande cela si seulement il a été choisi de faire fonctionner l'option "IPDISCOVERY". (Voir la section intitulée Utiliser la fonctionnalité de découverte IP).
- Déploie un paquet : l'agent contacte le serveur de déploiement en utilisant le protocole HTTPS pour avoir le fichier d'information, télécharger les fragments de paquets depuis le dépôt, le paquet reconstruit et le lance.
N.B. : L'Agent OCS Inventory NG n'écoute pas le réseau. Cela est toujours initié par le serveur de communication. Ainsi, vous n'avez pas à ouvrir de port dans votre pare-feu personnel. Mais vous pouvez permettre le fichier "OCSInventory.exe" de l'agent d'OCS Inventory NG à contacter le Serveur de Communication ou le Serveur de Déploiement en utilisant HTTP ou HTTPS.
Chaque fois que l'inventaire est fait, l'Agent écrit un fichier de configuration "OCSInventory.dat" dans son propre répertoire où il y met les options de configuration téléchargées depuis le serveur de communication.
Quand il est lancé pour la première fois, l'Agent OCS Inventory NG demandera à l'utilisateur la valeur du TAG (si la fonctionnalité est activée). Un texte d'aide est affiché dans la boite de dialogue à l'identique de celui que vous avez entré lors de la § configuration du serveur de gestion. L'utilisateur peut entrer la même valeur, ou laisser à blanc (vous pourrez mettre-à-jour cette valeur au moyen du serveur d'Administration).
Alors (ou au contraire, si la fonctionnalité TAG n'est pas active), il fera l'inventaire et enverra les résultats de l'inventaire au serveur de Communication par le biais de HTTP.
Comment le Service Windows travaille ?
N.B. : Vous devez avoir les privilèges d'Administrateur pour installer l'Agent d'OCS Inventory NG en tant que service, ou vous devez utiliser le Packager d'OCS Inventory NG pour créer un installeur qui soit capable de fonctionner même si vous n'avez pas les droits d'Administrateur. Réferez-vous à § la section intitulée Téléverser l'Agent pour le déploiement au moyen du lanceur "OcsLogon.exe" ou la documentation du Packager OCS Inventory NG.
L'Agent OCS Inventory NG "OCSInventory.exe" est lancé par le service "OcsService.exe" chaque heure PROLOG_HOUR définie. Il garde trace du compte-à-rebours en secondes dans le fichier "service.ini" (valeur TTO_WAIT) ainsi que le temps de fonctionnement EFFECTIVE.
Le nombre d'heures d'attente est aléatoire à chaque moment d'installation et à chaque moment PROLOG_FREQ défini dans la console d'Administration.
Il fait en sorte que tous les agents n'aient pas à contacter en même temps le serveur de Communication. Le réarrangement aléatoire est définie entre 0 et la valeur PROLOG_FREQ.
Vous pouvez ajuster ces paramètres en considérant la charge du serveur.
Quand l'agent de service est lancé, il est appelé en utilisant les arguments de lignes de commande spécifiés dans la valeur "Miscellaneous" dans le fichier "service.ini".
[OCS_SERVICE] NoProxy=1 Server=my_server_ocs.domain.tld Pnum=80 Miscellaneous=/DEBUG /NP /SERVER:my_server_ocs.domain.tld /pnum:80 PROLOG_FREQ=10 OLD_PROLOG_FREG=10 TTO_WAIT=1505
Comme vous pouvez le voir, le Service est seulement un lanceur qui fera fonctionner l'Agent régulièrement, même s'il n'y a aucun log sur l'ordinateur.
Dois-je utiliser l'Agent de Service ou l'Agent solo
Vous voulez avoir les ordinateurs inventoriés, même si vous n'avez aucun log ? Utilisez l'Agent de Service.
Vous voulez utiliser la fonctionnalité de déploiement de paquets ? Utilisez l'Agent de Service. En tant que tel, le paquet sera téléchargé en tâche de fond, l'utilisateur connecté pouvant continuer à travailler.
Vous ne voulez pas du service d'installation, ou que quelques écritures apparaissent dans la base de registre ? Utilisez l'Agent solo. Toutefois, le déploiement de paquets peut prendre plus de temps quand l'utilisateur est connecté.
En d'autres mots, nous recommandons l'agent de service.
Installer manuellement la version de l'Agent de Service
Faites fonctionner "OcsAgentSetup.exe" sur l'ordinateur client et cliquez sur le bouton [ Suivant > ].
Validez la licence en cliquant sur le bouton [ J'accepte ].
Remplissez les champs de l'adresse et du port du serveur de Communication OCS Inventory NG. Si vous ne voulez pas utiliser les paramètres du proxy de Microsoft Internet Explorer (par exemple, parce que votre proxy requiert l'authentification), cliquez sur l'option "No Proxy". Le champ "Miscellaneous" permet de passer à l'agent des arguments en ligne de commande. (cf § la section intitulée L'Agent et ses arguments de ligne de commande). Alors, cliquez sur le bouton [ Suivant > ].
Choisissez le répertoire de destination, par défaut "C:\Program Files\OCS Inventory Agent\", et cliquez sur le bouton [ Installer ].
Cliquez sur le bouton [ Fermer ] pour enregistrer l'Agent de Service OCS Inventory NG dans le système.
L'Agent est maintenant installé en tant que service automatiquement démarré au démarrage du système sous le compte LocalSystem.
Ceci est la méthode d'installation interactive. Toutefois, le processus requiert que vous le lanciez sur tous les ordinateurs. Heureusement, l'installation peut se faire grâce aux scripts.
N.B. : L'installeur de l'Agent de Service supporte en ligne de commande tous les arguments de l'agent définis dans § la section intitulée L'Agent et ses arguments de ligne de commande.
L'installeur de l'Agent de Service "OcsAgentSetup.exe" peut être appelé avec quelques paramètres de ligne de commande :
- /S pour faire fonctionner l'installation en mode silencieux, sans aucune interaction utilisateur
- /UPGRADE pour mettre-à-jour une installation existante de l'Agent de Service.
- /NOSPLASH pour désactiver l'écran d'accueil,
- /NoOcs_ContactLnk pour désactiver le raccourcis Ocs-Contact dans le menu Demarrer,
- /D= pour spécifier un chemin d'installation, (doit être le dernier paramètre sans ["] Ex: /D=E:\my install folder)
- et tous les arguments de ligne de commande de l'Agent, spécifiquement /SERVER pour spécifier l'adresse du serveur de Communication quand est utilisée l'installation en mode silencieux. (voir § la section intitulée L'Agent et ses arguments de ligne de commande).
Installer manuellement l'Agent Solo (sans le service)
Cette manière est très pratique sur un ordinateur non connecté à un réseau.
L'installeur peut fonctionner avec les droits d'un utilisateur normal, ou mieux avec ceux de l'administrateur système.
Vous avez juste à faire fonctionner l'exécutable ainsi "OcsAgent.exe /LOCAL" pour lancer l'installeur de l'Agent OCS Inventory NG. L'installeur essayera d'installer les fichiers de l'agent OCS Inventory NG dans le répertoire "C:\ocs-ng" ou, si vous n'avez pas les permissions nécessaires pour créer un répertoire à la racine du système, dans un répertoire "ocs-ng" créé dans le répertoire temporaire lié à votre connexion. Alors, il lancera l'agent OCS Inventory NG.
L'Agent demandera à l'utilisateur sous quel répertoire il devra sauvegarder les résultats de l'inventaire.
Lors de son premier lancement, l'agent OCS Inventory NG demandera la valeur du TAG. L'utilisateur pourra entrer la valeur ou laisser à blanc (vous pourrez modifier cette valeur au moyen du serveur d'administration).
Quand l'inventaire sera terminé, l'agent affichera un message à l'utilisateur l'informant où est enregistré le fichier de résultat d'inventaire et son nom.
L'utilisateur a juste à envoyer le fichier à l'administrateur. L'administrateur pourra alors importer les résultats d'inventaire dans la base de données au moyen du serveur d'administration.
Si vous voulez un autre inventaire, vous n'aurez qu'à faire fonctionner "Ocsinventory.exe /LOCAL" depuis le répertoire d'installation de l'agent d'OCS Inventory NG.
N.B. : L'installeur de l'Agent Solo supporte en ligne de commande tous les arguments d'Agent définis dans § la section intitulée L'Agent et ses arguments de ligne de commande.
Déployer l'Agent en utilisant le lanceur OcsLogon.exe au moyen de script de login ou de GPO Active Directory
Le lanceur "OcsLogon.exe" est un petit outil capable de fonctionner dans un script d'ouverture de session ou dans une règle GPO d'Active Directory. Son but est de lancer l'agent OCS Inventory NG sur chaque ordinateur, et si l'Agent n'est pas installé de l'installer.
Le lanceur "OcsLogon.exe" essayera par défaut de se connecter au Serveur de Communication en utilisant le nom DNS suivant "ocsinventory-ng", tout comme quand vous ouvrez votre navigateur internet favori et que vous entriez l'URL http://ocsinventory-ng/ocsinventory.
Pour utiliser une adresse URL différente si vous n'avez pas ajouté ce nom DNS, il faut juste renommer "OcsLogon.exe" par le nom DNS ou l'adresse IP de votre Serveur de Communication (par exemple, "ocsinventory-ng.domain.tld.exe" si vous avez créé pour votre serveur un enregistrement DNS "ocsinventory-ng.domain.tld" ou "192.168.1.2.exe" si votre serveur a pour adresse IP "192.168.1.2"). Le lanceur essayera de se connecter au nom DNS ou à l'adresse IP que vous avez nommé. (http://ocsinventory-ng.domain.tld/ocsinventory ou http://192.168.1.2/ocsinventory).
N.B. : Utilisez toujours la dernière version d'OcsLogon.exe. Vous pouvez obtenir celui-ci avec le dernier paquet OCSNG_WIN32_AGENT_xx.zip
Le lanceur vérifiera une première fois si l'agent OCS Inventory NG est installé, et si il ne l'est pas, il contactera le Serveur de Communication en HTTP pour télécharger les derniers binaires de l'agent et l'installera localement sur l'ordinateur :
- L'Agent Solo dans le répertoire "C:\ocs-ng" par défaut ou, si l'utilisateur connecté n'a pas les permissions de créer un répertoire à la racine du système, dans un répertoire "ocs-ng" dans le répertoire temporaire de l'utilisateur. Si l'Agent Solo est installé, le lanceur le fera fonctionner.
- L'Agent de Service dans le répertoire "C:\Program Files\OCS Inventory Agent" par défaut.
N.B. : Pour déployer l'Agent Solo avec le lanceur, vous avez besoin de téléverser le fichier "ocsagent.exe" de l'Agent Solo avec la Console d'Administration. Pour déployer l'Agent de Service avec le lanceur, vous avez besoin de téléverser le fichier "ocspackage.exe" de l'Agent de Service avec la Console d'Administration. Référez-vous à § la section intitulée Téléverser l'Agent pour le déploiement au moyen du lanceur "OcsLogon.exe".
Pour choisir entre l'Agent Solo ou de Service, il y a juste à spécifier l'argument "/INSTALL" si vous voulez utiliser le Service ou non. Si vous ajoutez l'argument de ligne de commande "/INSTALL", le lanceur utilisera l'Agent de Service. Autrement, il utilisera l'Agent Solo.
Si vous voulez mettre-à-jour l'Agent, vous devez spécifier dans le lanceur la version de la nouvelle version avec l'argument "/DEPLOY:XXXX" où XXXX est la version de l'agent, 4301 pour la version 1.01.
Déploiement de l'Agent au moyen de GPO Active Directory
N.B. : Nous recommandons d'utiliser l'Agent de Service si vous planifiez d'utiliser la fonctionnalité de déploiement de paquets. Pour déployer l'Agent Solo avec le lanceur, vous avez besoin de téléverser le fichier "ocsagent.exe" avec la Console d'Administration. Pour déployer l'Agent de Service avec le lanceur, vous avez besoin de téléverser le fichier "ocspackage.exe" avec la Console d'Administration et d'utiliser l'argument de ligne de commande /INSTALL avec le lanceur. Référez-vous à § la section intitulée Téléverser l'Agent pour le déploiement au moyen du lanceur "OcsLogon.exe".
Ouvrir la console "Utilisateurs et ordinateurs Active Directory".
Faites un clic-droit sur votre nom de domaine Active Directory ou Unité Organisationnelle et sélectionnez "Propriété".
Dans l'onglet "Stratégie de Groupe", créez une nouvelle stratégie, ou éditez une existante.
Vous utiliserez l'une ou l'autre des stratégies, de l'Ordinateur ou de l'Utilisateur. La configuration de la stratégie ordinateur sera lancé au démarrage de l'ordinateur, celle de l'utilisateur lors de sa connexion.
N.B. : Dans notre exemple, vous utiliserez Configuration Ordinateur > Script > Démarrage. L'adresse du Serveur de Communication est 192.168.1.2, parce que nous avons choisi d'installer la version de l'Agent de Service. Si vous avez choisi d'utiliser l'Agent Solo, il sera préférable d'utiliser Configuration Utilisateur > Script > Démarrage, pour permettre à l'agent de fonctionner à chaque fois que l'utilisateur sera connecté.
Ouvrir l'arbre "Configuration Ordinateur" dans le panneau gauche, puis allez à "Paramètres Windows" et "Scripts (démarrage/arrêt)". Alors, double-cliquez sur "Démarrage" dans le panneau droit.
Cliquez sur le bouton "Voir les fichiers" pour afficher les fichiers et scripts exécutables, utilisables par les scripts de démarrage de l'ordinateur.
Copiez le lanceur "OcsLogon.exe" ou renommez-le (dans notre exemple "192.168.1.2.exe") dans le répertoire pour permettre au script de démarrage de l'utiliser.
En suivant, fermez le répertoire "Startup" et cliquez sur le bouton [ Ajouter ], cliquez sur le bouton [ Parcourir ] pour sélectionner le lanceur "OcsLogon.exe" ou celui que vous avez renommé (dans notre exemple "192.168.1.2.exe") et restituez les paramètres du lanceur dans le champ "Paramètres de script" (dans notre exemple, "/S" pour installation silencieuse, "/DEBUG" pour permettre la création de fichier log, "/NP" pour désactiver l'usage des paramètres de proxy d'Internet Explorer, "/INSTALL" pour déployer l'Agent de Service, "/DEPLOY:4029" pour forcer le déploiement de la version 4029, "/SERVER:192.168.1.2" pour utiliser l'adresse IP 192.168.1.2 du Serveur de Communication).
Validez toutes les fenêtres pour activer la règle GPO.
Quand l'ordinateur démarrera (ou quand l'utilisateur se connectera si vous avez utilisé les règles utilisateurs), le lanceur installera et/ou lancera l'agent OCS Inventory NG.
N.B. : Le lanceur OcsLogon.exe peut rencontrer des problèmes pour accéder au Serveur de Communication si vous avez configuré un proxy avec authentification dans les paramètres d'Internet Explorer. Vous pouvez forcer le lanceur à ne pas utiliser les paramètres de proxy avec l'argument de ligne de commande "/NP". Vous pouvez aussi spécifier un port différent pour communiquer avec le Serveur de Communication avec l'argument de ligne de commande "/PNUM:XX" où XX est le numéro de port à utiliser. Lire § la section intitulée L'Agent et ses arguments de ligne de commande.
Déploiement de l'Agent au moyen de script d'ouverture de session
N.B. : Nous recommandons d'utiliser l'Agent de Service si vous planifiez d'utiliser la fonctionnalité de déploiement de paquets. Pour déployer l'Agent Solo avec le lanceur, vous avez besoin de téléverser le fichier "ocsagent.exe" avec la Console d'Administration. Pour déployer l'Agent de Service avec le lanceur, vous avez besoin de téléverser le fichier "ocspackage.exe" avec la Console d'Administration et d'utiliser l'argument de ligne de commande /INSTALL avec le lanceur. Référez-vous à § la section intitulée Téléverser l'Agent pour le déploiement au moyen du lanceur "OcsLogon.exe".
Copiez le fichier "OcsLogon.exe" (ou celui que vous avez renommé) vers le répertoire partagé sur le réseau. Celui-ci doit être lisible par tout utilisateur. Alors, ajoutez un appel à "OcsLogon.exe" (ou celui que vous avez renommé) dans votre script de Login utilisateur.
Voici un exemple de script d'ouverture de session :
@echo off echo Running system inventory, please wait... REM Call to OCS Inventory NG agent for deployment REM Using shared folder MY_SHARE on server MY_SERVER REM Connect to Communication server at address 192.168.1.2 REM Enable debug log with /DEBUG to create OcsLogon.log and computer_name.log REM Force setup agent version 4030 if agent not up to date REM Deploy service version of agent using /INSTALL “\\MY_SERVER\MY_SHARE\192.168.1.2.exe” /DEBUG /NP /INSTALL /DEPLOY:4030 echo Done. Thanks a lot.
N.B. : Pour être conforme avec Windows 9X, vous devez enfermer le nom du chemin vers le lanceur entre double-quotes, autrement Windows 9X ne serait pas capable de l'utiliser, mais restituerait un nom tel que "192~1.exe", le lanceur ne serait pas capable de trouver correctement l'adresse IP ou le nom DNS.
Mettez ce script - nommé "ocs.bat" par exemple - sur votre Contrôleur de Domaine dans le répertoire "%WINDIR%\SYSVOL\Domain\Scripts", où "%WINDIR%" est généralement "C:\WINNT" ou "C:\Windows".
Ensuite, vous devez lier le script d'ouverture de session à chaque utilisateur enregistré dans votre domaine Active Directory. Vous devez utiliser pour cela l'outil "Utilisateurs et ordinateurs Active Directory".
Pour chaque utilisateur, ouvrez ses propriétés et dans l'onglet "Profil", ajoutez le nom du script d'ouverture de session dans le champ "Script d'ouverture de session".
Quand l'utilisateur se connectera, le lanceur installera et/ou lancera OCS Inventory NG.
N.B. : Le lanceur OcsLogon.exe peut rencontrer des problèmes pour accéder au Serveur de Communication si vous avez configuré un proxy avec authentification dans les paramètres d'Internet Explorer. Vous pouvez forcer le lanceur à ne pas utiliser les paramètres de proxy avec l'argument de ligne de commande "/NP". Vous pouvez aussi spécifier un port différent pour communiquer avec le Serveur de Communication avec l'argument de ligne de commande "/PNUM:XX" où XX est le numéro de port à utiliser. Lire § la section intitulée L'Agent et ses arguments de ligne de commande.
L'Agent et ses arguments de ligne de commande
Les versions 4.0.1.0 et supérieures de l'agent OCS Inventory NG inclut quelques arguments de ligne de commande pour permettre de détecter des erreurs.
Une fois que l'agent est installé, vous pouvez le lancer manuellement pour diagnostiquer les problèmes. Utilisez en ligne de commande "C:\ocs-ng\OCSInventory.exe [options]" (pour l'agent solo) ou "C:\Program Files\OCS Inventory Agent\OCSInventory.exe [options]" (pour l'agent de service) où [options] doivent être les arguments de ligne de commandes suivants :
| Arguments | Énoncé |
|---|---|
| /server:[server name] | Demande à l'agent de se connecter au serveur ayant tel nom « [nom serveur] » |
| /np | Désactive l'usage du proxy défini dans les paramètres d'Internet Explorer. |
| /pnum:XX | Spécifie un port IP pour communiquer avec le serveur de communication. Par exemple, vous pouvez forcer l'usage du port 8080 avec l'argument /pnum:8080. |
| /local | Faire fonctionner l'agent en mode inventaire local. Ainsi, l'agent n'essayera pas de communiquer avec le serveur de communication. 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 interagit avec le serveur de communication. |
| /xml | L'agent créera 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 agent to search for installed software also under HKEY_CURRENT_USER registry hive. |
| /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. Autrement, il utilisera par défaut le fichier « Ocsinventory.dat ». |
| /test | L'agent testera seulement la connexion HTTP au serveur de communication et écrira un fichier « ok.ok » si tout est bon. Peut-être utilisé seulement avec les arguments /DEBUG, /NP et /PNUM (désactivé avec tous les autres). |
| /ipdisc:[network number] | Force l'agent à faire fonctionner la fonctionnalité IPDISCOVERY sur le réseau nommé « [network number] » si le serveur demande un inventaire. Il peut être utilisé en conjonction avec /FORCE pour s'assurer de son fonctionnement. Ne peut être utilisé avec /LOCAL. |
| /fastip | L'agent scanne seulement 5 IPs s'il est élu comme hôte IPDISCOVER (à utiliser seulement en déboguage ou en test, pas en production). |
Quand vous utilisez le lanceur "OcsLogon.exe" pour déployer ou faire fonctionner l'agent, vous pouvez utiliser les arguments de lignes de commandes suivants :
N.B. : Vous pouvez aussi ajouter tous les arguments supportés par l'agent OCS Inventory NG.
| Arguments | Énoncé |
|---|---|
| /DEPLOY:XXXX | Force le déploiement d'une version XXXX spécifique de l'agent. Utilisez "/DEPLOY:4030" pour mettre-à-jour l'agent à la version 4.0.3.0 |
| /INSTALL | Demande au lanceur d'installer l'Agent de Service, au lieu de l'Agent Solo. |
| /URL:[download_url] | Demande au lanceur de télécharger l'Agent Solo "ocsagent.exe" ou l'Agent de Service "ocspackage.exe" depuis "[download_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 du proxy défini dans les paramètres 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é. Vous pouvez forcer l'usage du port 8080 par exemple avec l'argument "/PNUM:8080". |
| /LOCAL | Faire fonctionner l'agent en mode inventaire local. Ainsi, l'agent n'essaiera pas de se connecter au serveur de communication. Un fichier "{hostname}.ocs" contenant les résultats de l'inventaire, en XML compressé, 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 ! |
Sur un système d'exploitation Unix
L'Agent *nix peut seulement être installé localement. Vous ne pouvez pas déployer l'agent au moyen du réseau comme cela est possible pour l'agent Windows. Toutefois, vous pouvez choisir durant l'installation d'activer la mise-à-jour automatique de l'agent si vous choisissez la méthode d'inventaire par protocole HTTP.
N.B. : Vous devez avoir les privilèges d'Administrateur pour installer le serveur d'administration.
Requis
Pré-requis pour Linux
L'agent OCS Inventory pour Linux requiert :
- dmidecode version 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
N.B. : Il vaut mieux utiliser pour l'intégrité de votre système les paquets précompilés de votre distribution si ceux-ci sont disponibles. Sur Fedora/RedHat, vous devez utilisez l'outil "yum" pour installer les modules requis suivants : * 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 Sur Debian, vous devez utiliser l'outil "apt-get" pour installer les modules suivants : * 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
Le nouveau script d'installation "setup.sh" est capable d'installer ses dépendances si elles ne sont pas disponibles. Toutefois, il ne mettra jamais à jour un module déjà installé. Si un des modules est à une version inférieure à celle requise, vous devez vous-même le mettre-à-jour.
N.B. : L'installeur n'installera pas les dépendances requises aux composants. Par exemple, Net::SSLeay requiert qu'OpenSSL soit installé. S'il n'est pas installé, l'installation de Net::SSLeay échouera ainsi que celle de l'agent OCS Inventory NG.
Ainsi, le script installer produit un fichier log "setup.log". Si vous rencontrez une erreur durant l'installation de l'agent OCS Inventory NG, svp référez-vous à ce fichier pour avoir le message d'erreur détaillé.
Installer l'Agent interactivement
Sur Linux
Téléchargez "OCSNG_LINUX_AGENT_1.01.tar.gz" depuis le site web d'OCS Inventory NG.
Décompressez-le :
- tar -xzvf OCSNG_LINUX_AGENT_1.01.tar.gz
Faites fonctionner l'installeur "setup.sh". Durant la phase d'installation, les choix par défaut sont présentés entre crochets [ ]. Par exemple, "[y]/n" signifie que "y" - yes/oui - est le choix par défaut et que "n" - no/non- est l'autre choix possible.
- cd OCSNG_LINUX_AGENT_1.01
- sh setup.sh
N.B. : L'installeur écrit un fichier log "ocs_agent_setup.log" dans le même répertoire. Si vous rencontrez une erreur, svp référez-vous à ce fichier log pour obtenir le message d'erreur détaillé.
Vous avez alors le choix entre deux méthodes pour générer l'inventaire :
- http : l'ordinateur est connecté au réseau et il est capable d'atteindre le Serveur de Communication par le biais du protocole HTTP.
- local : l'ordinateur n'est pas connecté au réseau, l'inventaire sera généré dans un fichier qui sera envoyé manuellement à l'opérateur OCS Inventory NG.
Entrez "http" ou validez si votre ordinateur peut atteindre le serveur de communication, ou "local" pour activer le mode local.
Entrez l'adresse du serveur de communication.
Entrez le port du serveur de communication OCS Inventory NG, ou validez si le serveur de communication fonctionne sur le port HTTP 80 standard.
Entrez une valeur TAG.
L'installeur vérifiera le binaire de l'interpréteur PERL, le compilateur C/C++ et l'utilitaire Make. Si un de ces composants manque, l'installeur s'arrêtera.
L'installeur vérifiera :
- 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
S'ils ne sont pas trouvés, il demandera si vous voulez l'installer. Entrez "y" ou validez si vous voulez installer les modules requis. Si vous entrez "n", l'installeur s'arrêtera là.
Si tout est OK, ou vous avez choisi d'installer les dépendances, l'installeur fera alors les opérations suivantes :
- Décompresse, configure, construit, et installe dmicode si besoin est,
- Décompresse, configure, construit, et installe Compress::Zlib si besoin est,
- Décompresse, configure, construit, et installe XML::Simple si besoin est,
- Décompresse, configure, construit, et installe Net::IP si besoin est,
- Décompresse, configure, construit, et installe LWP (libwww-perl) si besoin est,
- Décompresse, configure, construit, et installe Digest::MD5 si besoin est,
- Décompresse, configure, construit, et installe Net:SSLeay si besoin est,
- Compile le binaire IPDISCOVER,
- Configure le module PERL de l'agent OCS Inventory NG,
- Construit le module PERL de l'agent OCS Inventory NG,
- Installe le module PERL de l'agent OCS Inventory NG dans le répertoire standard des bibliothèques PERL,
- Créé un lien symbolique "/usr/sbin/ocsinv" pour faire fonctionner l'agent OCS Inventory NG manuellement,
- Créé le répertoire des logs de l'agent OCS Inventory NG (/var/log/ocsinventory-NG par défaut),
- Configure la rotation quotidienne des logs de l'agent OCS Inventory NG (fichier /etc/logrotate.d/ocsinventory-client par défaut),
- Créé le fichier de configuration "ocsinv.conf" de l'agent OCS Inventory NG dans le répertoire "/etc/ocsinventory-client",
- Créé le fichier d'information administratif "ocsinv.adm" de l'agent OCS Inventory NG dans le répertoire "/etc/ocsinventory-client" pour enregistrer les valeurs TAG et autres valeurs administratives,
- Créé une tâche cron pour lancer l'agent OCS Inventory NG chaque jour (par défaut, le fichier /etc/cron.d/ocsinventory-client),
- Lance l'agent OCS Inventory NG pour s'assurer que tous les paramètres sont OK.
Ce qui suit est un simple fichier de configuration de l'agent OCS Inventory NG :
<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>
Déployer l'Agent au moyen de script d'installation sans interaction utilisateur
Sur Linux
Téléchargez "OCSNG_LINUX_AGENT_1.01.tar.gz" depuis le site web d'OCS Inventory NG.
Décompressez-le :
- tar -xzvf OCSNG_LINUX_AGENT_1.01.tar.gz
Lancez l'installeur "setup.sh" avec les arguments de ligne de commande suivants :
- cd OCSNG_LINUX_AGENT_1.01
- sh setup.sh <SETUP DEPENDANCES> <ADRESSE SERVEUR> [<PORT SERVEUR> <VALEUR TAG>]
où les valeurs des arguments sont :
- <SETUP DEPENDANCES> doit être "1" si vous voulez activer automatiquement l'installation des dépendances oubliées, "0" pour désactiver (l'installeur s'arrêtera si une dépendance est manquante).
- <ADRESSE SERVEUR> doit être l'adresse IP ou le nom DNS du serveur de communication. Si vous planifiez d'installer l'agent en mode local sur un ordinateur non connecté à un réseau, vous devez paramètrer la valeur sur "local".
- <PORT SERVEUR> doit être le port du serveur de communication d'OCS Inventory NG si vous n'utilisez pas le port HTTP 80 standard.
- <VALEUR TAG> doit être la valeur TAG, entre quotes.
Les arguments de ligne de commandes <SETUP DEPENDANCES> et <ADRESSE SERVEUR> sont requis. Les autres paramètres sont optionnels, mais si vous paramétrez la valeur TAG, vous devez aussi spécifier le paramètre optionnel prévu <PORT SERVEUR>.
Exemples :
- sh setup.sh 1 ocsng.domain.tld installera l'agent, les dépendances manquantes si nécessaire, et se connectera au serveur de communication OCS Inventory NG "ocsng.domain.tld".
- sh setup.sg 0 ocsng.domain.tld 8080 installera l'agent, sans les dépendances manquantes, et se connectera au serveur de communication OCS Inventory NG "ocsng.domain.tld" sur le port 8080.
- sh setup.sh 192.168.1.2 8080 "ma valeur TAG" installera l'agent, sans les dépendances manquantes, et se connectera au serveur de communication OCS Inventory NG ayant l'adresse IP "192.168.1.2 sur le port 8080, et paramétrera la valeur TAG avec "ma valeur TAG".
N.B. : L'installeur écrira un fichier log "ocs_agent_setup.log" dans le même répertoire. Si vous rencontrez une erreur, svp référez-vous à ce fichier pour avoir le message d'erreur détaillé.
L'Agent et ses arguments de ligne de commande
Si vous rencontrez des erreurs, l'agent produit un fichier log dans le répertoire "/var/log/ocsinventory-client".
Toutefois, l'agent supporte aussi quelques arguments de ligne de commande. Vous pouvez les utiliser quand vous lancez manuellement l'agent en utilisant la commande "ocsinv" :
| Arguments | Énoncé |
|---|---|
| -local | Fait fonctionner l'agent en mode local, sans aucune connexion au serveur de communication. Il vous sera demandé un répertoire de destination où l'agent déposera les résultats de l'inventaire dans un fichier XML compressé ayant l'extension ".ocs". |
| -xml | L'agent créera un fichier XML non compressé ayant l'extension ".ocs", contenant les résultats de l'inventaire. Il vous sera demandé un répertoire de destination où l'agent déposera le fichier. Si vous ne l'utilisez pas en conjonction avec l'argument "-local", l'agent essaiera de se connecter au serveur de communication. |
| -nosoft | Ne pas rechercher les logiciels installés. |
| -tag="ma valeur tag" | Dit à l'agent de paramétrer la valeur TAG à "ma valeur 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. |
