OCS Inventory/fr

From SME Server
Revision as of 21:21, 9 May 2021 by Gieres (talk | contribs)
Jump to navigationJump to search


Maintaineur

Stéphane de Labrusse AKA Stephdl

Version

Contrib 9:
smeserver-ocsinventory
The latest version of smeserver-ocsinventory is available in the SME repository, click on the version number(s) for more information.


Tutoriel

Installation

SME9

Vous devez d'abord activer le dépôt Remi-ocsinventory, puis :

yum install smeserver-ocsinventory --enablerepo=remi-ocsinventory,smecontribs
signal-event ocs-update

ou si vous préferrez redémarrer le serveur, faire ensuite :

signal-event post-upgrade; signal-event reboot

Après cela, vous pouvez procéder à l'installation normale selon OCS Inventory#Importing ocsagent.exe in MySQL qui devrait vous amener à http://VotreDomaine/ocs/install.php.

Répondre seulement aux questions, les informations de la base de données (BDD) mysql seront déjà là, vous n'avez pas à les modifier car elles ont été définies.

Puis faire l'installtion normale et à la suite aller sur http://VotreDomaine/ocs/index.php.

Ne pas oublier de changer les identifiant et mot de passe par défaut qui sont admin/admin.

N'oubliez pas non plus de faire :

rm -f  /usr/share/ocsinventory-reports/ocsreports/install.php

SME8

yum install smeserver-ocsinventory --enablerepo=smedev,smetest,smecontribs

then

signal-event ocs-update
signal-event post-upgrade; signal-event reboot


Warning.png Warning:
You must issue first the ocs-update before post-upgrade and reboot


Commandes spéciales

Pour voir la configuration d'OCS, vous pouvez saisir :

config show ocs

Vous pouvez changer quelques paramètres :

   Paramètre DB   |    Options   | Par défaut | Explication
# MaxUpload       | xM           | 100M       | Taille maximale de fichier téléchargé
# InventoryAccess | local/global | global     | Accessibilité du serveur OCS (pour recevoir les inventaires) 
# InventoryDelay  | >1           | 600        | Durée d'attente (sec) pour éviter la surcharge du serveur (Agent cron)
# URL             | new alias    |            | Alias facultatifs pour les interfaces Web ocs et glpi

Installation du client

Le côté client est disponible pour toutes les plateformes. Télécharger la dernière version de client en fonction de votre système d'exploitation (SE).

Après l'installation de l'Agent, vous devez le lancer manuellement pour télécharger votre premier inventaire (car il est mis à jour une fois par jour par défaut).

Pendant que vous installez l'agent, copier le fichier cacert.pem, voir la section SSL ci-dessous.

Agent OCS pour Serveur KOOZALI SME

Si vous voulez inventorier d'autres serveurs KOOZALI SME (sans installer la partie serveur et les interfaces web) :

for sme9

yum install ocsinventory-agent ocsinventory-ipdiscover --enablerepo=remi-ocsinventory

Puis éditer /etc/ocsinventory-agent/ocsinv.conf et modifier les lignes suivantes :

OCSSERVER=MonDomaine.com
OCSTAG=mon_tag

Et à la fin, lancer le premier inventaire manuellement :

ocsinventory-agent -s MonDomain.com -t mon_tag

for sme8

yum install ocsinventory-agent ocsinventory-ipdiscover --enablerepo=smetest,epel
Warning.png Warning:
this will issue a warning, which can be ignored, about : rpmts_HdrFromFdno: Entête V3 DSA signature: NOKEY, key ID 00f97f56

Public key for ocsinventory-ipdiscover-1.01-2.el5.remi.i386.rpm is not installed


Agent OCS pour Windows

Il y a 2 façons différentes d'envoyer des inventaires sur Windows. Télécharger le dernier logiciel client, OCSNG_WIN32_AGENT_1.xx_repack.zip sur le site d'OCS. Cette archive contient 3 exécutables.

Voir la Section 4.1 du fichier d'aide interne d'OCS.

Utilisation du service

Utiliser OCS comme un service est probablement ce que vous ferez.

Lancer l'installation de OcsAgentSetup.exe et fournir les paramètres par défaut du service. OCS-winagent-setup.png


Puis lancer le premier inventaire en saisissant ce qui suit dans la 'execute box':

"C:\Program Files\OCS Inventory Agent\OCSInventory.exe" /server:MonDomaine.com /np /debug /tag:mon_tag

Attendre quelques secondes et aller sur http://mon-serveur/ocs, vous devriez voir votre inventaire d'ordinateurs.

Par défaut, l'Agent contactera le Serveur une fois par jour.

Vous pouvez écraser ce comportement par défaut dans les options de l'interface web d'OCS. Vos modifications seront appliquées au contact suivant du Serveur par l'Agent.


Pour le dépannage, regarder le fichier log dans C:\Program Files\OCS Inventory Agent\COMPUTER_NAME.log.


Utilisation autonome

Vous pouvez aussi faire des inventaires sur Windows sans installer le service.

Le client autonome OCS est séparé en 2 exécutables :

  • ocsagent.exe - Ce fichier contient tous les fichiers nécessaire pour le lanceur ;
  • OcsLogon.exe - Ce fichier est l'exécutable autonome (le lanceur).

Naturellement, ocsagent.exe doit être décompressé avant le lancement de l'exécutable autonome.

Ceci peut être fait en exécutant directement ocsagent.exe: les fichiers seront décompressés dans c:\ocs-ng.

Vous pouvez également importer ce fichier dans la base de données MySQL d'OCS de façon que l'exécutable autonome puisse le télécharger au besoin. Ceci est documenté dans la section Importation MySQL.

La ligne de commande est la même que pour le service :

"C:\chemin_vers_le_fichier\OcsLogon.exe" /server:MonDomaine.com /np /debug /tag:mon_tag

Pour des inventaires plus faciles et plus rapides, vous pouvez aussi renommer cet exécutable autonome au nom de votre domaine (ne pas oublier .exe) :

"C:\chemin_vers_le_fichier\MonDomaine.com.exe" /np /debug /tag:mon_tag

Pour le dépannage, regarder le fichier log dans C:\ocs-ng\COMPUTER_NAME.log


Importer ocsagent.exe dans MySQL

Le principal avantage de cette méthode est que vous pouvez envoyer l'exécutable autonome par Internet très rapidement ou même mettre l'exécutable autonome sur une disquette comme il ne fait que 65 KB ! Comme votre vieux lecteur de disquette paraît puissant maintenant ?

Ceci permet aussi de mettre à jour les fichiers archivés dans ocsagent.exe sur vos clients (qu'ils soient service ou executable autonome).

Un empaqueteur est disponible sur le site internet d'OCS. Ceci vous permettra de repaqueter ocsagent.exe avec vos propres modifications (par exemple un certificat SSL !) OCS-packager.png


La première chose dont vous avez besoin est de copier ocsagent.exe (modifié ou pas) dans /usr/share/ocsinventory-reports/ocsreports/files/.

Puis, vous pouvez importer ce fichier dans la BDD. Aller à http://MonDomaine.com/ocs/install.php

Utiliser pour cela l'identifiant 'ocs' pré-configuré : OCS-installphp.png


Si vous recevez un message d'alerte (impossible de modifier la BDD), rafraîchir la page et vous devriez avoir une importation résussie. OCS-installphp-ocsagent.png


ocsagent.exe est maintenant dans la BDD !

Warning.png Attention :
install.php a remis le mot de passe d'ocs à 'ocs'. Re-appliquez vos modifications avec la commande suivante :
signal-event domain-modify

Cela remettra aussi chmod à 440 pour dbconfig.inc.php.


Vous pouvez maintenant utiliser OcsLogon.exe seul, il téléchargera/mettra à jour ocsagent.exe au besoin !

Si vous voulez retirer ocsagent.exe de votre BDD, effacez simplement le fichier du serveur et relancez install.php. Cela effacera le fichier de la BDD.

Agent OCS pour Linux

Télécharger le tar.gz linux générique, le décompresser, lire le README, et, en tant que root, exécuter le script d'installation.

Vous pouvez avoir besoin de paquets perl supplémentaires, utiliser vos outils de gestion de paquets pour rechercher les dépendances manquantes en fonction du README ou des messages d'erreur. Voir la section 4.2 dans le fichier d'aide interne d'OCS. Pour exécuter un inventaire :

ocsinventory-client.pl -server=server.net -tag=network3

Vérifiez l'heure (le PC sera-t-il en fonctionnement ?) et la commande envoyée dans :

/etc/cron.d/ocsinventory-client

Utilisation d'OCS Inventory NG

La documentation complète peut être trouvée dans le fichier d'aide ocs, l'icône d'aide dans l'interface ocs.

Accès

L'interface web de rapport d'OCS est accessible à http://VotreServeur/ocs

Afin de se connecter, veuillez choisir votre langue (drapeaux dans le coin supérieur droit) OCS login page.png
Identifiant : admin
Mot de passe : admin


Warning.png Attention :
pour des raisons de sécurité, changer le mot de passe admin après votre première connexion, icône en haut à droite à côté de la déconnexion !


Les inventaires peuvent être faits depuis le WAN mais l'interface web est disponible par défaut depuis le seul réseau interne pour raisons de sécurité. Voir les Sections 5 & 6 dans le fichier d'aide interne d'OCS pour l'aide aux rapports et à l'administration.

Découverte des IP

La fonctionnalité de découverte des IP permet à OCS Inventory NG de découvrir sur le réseau tous les appareils connectés au réseau. Pour cela, le serveur Communication demande un nombre des ordinateurs les plus « actifs » utilisant l'agent OCS Inventory NG pour scanner leurs addresses MAC dans leur sous-réseau à chaque exécution. Voir la Section 7 dans le fichier d'aide interne d'OCS.

Modifier le comportement par défaut

Vous pouvez vouloir écraser le comportement par défaut de la découverte des IP.

Pour forcer un ordinateur à la découverte de son IP, ouvrir simplement son inventaire. Cliquer sur l'icône Personnalisation et mettre à jour le comportement de découverte des IP. OCS-ipdiscover-step1.png


Maintenant, choisir l'IP de l'ordinateur sélectionné et sauvegarder vos modifications. OCS-ipdiscover-step2.png


Vous devriez maintenant voir vos modifications.

OCS-ipdiscover-step3.png
A ce stade, la découverte de l'IP fonctionnera la prochaine fois avec l'agent !

Lancer manuellement l'inventaire pour forcer la découverte de l'IP ou attendre 24 heures pour le prochain inventaire.


Ajouter des réeaux et des catégories de périphériques

Cliquer maintenant sur Sécurité et aller sur Configuration. OCS-ipdiscover-step4.png


Ajouter vos propres réseaux/sous-réseaux. Tous les champs sont obligatoires. OCS-ipdiscover-step5.png


Nous pouvons aussi ajouter des catégories. Faisons-le ! Cliquer sur 'Types de périphériques réseau'. OCS-ipdiscover-step6.png


Utilisation

Revenir à Sécurité et cliquer sur Information réeau. Maintenant que votre réseau est créé, vous devriez voir la découverte des IP travailler...

Cliquer sur périphériques non-inventoriés. OCS-ipdiscover-step7.png


Maintenant tout ce que vous avez à faire est d'enregistrer les nouveaux périphériques ! OCS-ipdiscover-step8.png


OCS-ipdiscover-step9.png


Deploying packages

OCS Inventory NG includes package deployment feature on client computers. From the central management server, you can upload packages which will be downloaded through HTTP/HTTPS and launched by agent on client computer. See Section 8 in the internal OCS help file.

This feature is LAN ONLY

SSL certificate

Deployment feature uses SSL to authenticate Agents.

To allow the Agent to authenticate with the Server, you need to copy the cacert.pem file in your agents' installation directory

This file is located in /home/e-smith/ssl.crt/

Using default cacert.pem

If the file /home/e-smith/ssl.crt/cacert.pem can not be found, the RPM install will create it by copying your original SME certificate into this file. This is a quick and a simple method.

Copy the cacert.pem file in your agents' installation directory. Skip to next section!

Using a custom certificate

If you've followed this howto to create a valid certificate, you can use this certificate with OCS Deployment feature.

Download cacert.org certificate with the following command:

wget http://www.cacert.org/certs/root.crt

And replace the old file with the following command:

cp root.crt /home/e-smith/ssl.crt/cacert.pem

Copy this file into your agents' installation directory.

Deployment menu

Open OCS' web interface and click on Deployment icon. OCS-deployment-menu.png


Building a deployment packages

Deployment packages can be either .zip files (Windows) or tar.gz files (Linux)

Don't try to deploy other file type.

There are many options to deploy packages, for an overview see the ocs website for detail see section 8.3 of the help file, for Tips and tricks see Pablo Iranzo's site OCS-buildpackage.png


After creating the deployment package, you should get this successful screen: OCS-success-build.png


Activating deployment packages

Once a package is added, you need to activate it. OCS-activate-package1.png


Provide paths to download folder. As this feature is LAN ONLY, provide internal name or IP address for both fields.

Be careful, this path will be resolved by the agent (value localhost forbidden here!)

OCS-activate-package2.png


Don't pay attention to the warning messages when activating, Just click Yes. OCS-activate-package3.png


You can also ignore any warning messages when deleting a package, the package is removed.

Activated deployment packages

Here you will be able to see activated packages... OCS-activated-package.png

Deploying your packages

All should be ready to go now!

The final step is to affect the created package to computers...

Here's a quick howto for deploying the package on a single computer.

To learn how to deploy on multiple computers, see section 8.5 of the help file.


Open the desired computer's inventory on click on Config icon and add a new package OCS-deploy-single-pc1.png


You should see all activated packages, affect the one you want and confirm changes OCS-deploy-single-pc2.png


Back at Config page, you should now see affected packages and their states. OCS-deploy-single-pc3.png


Next time the Agent contacts the server, it is notified of the package, and sometime later should be deployed! As usual, you can manually launch the agent to force the update.

See section 8.1 of the help file to understand how download works