Mise en place du plugin

Sur le serveur, voici les deux dossiers qui contiennent le plugin

  • /usr/share/ocsinventory-reports/ocsreports/extensions/dcustate
  • /etc/ocsinventory-server/perl/Apache/Ocsinventory/Plugins/Dcustate

Transférer le dossier extrait de l’archive sur le serveur OCS via scp ou winscp dans le home de l’utilisateur root
Exemple avec dcustate, à adapter suivant le besoin
Faites ces actions en root

cd /usr/share/ocsinventory-reports/ocsreports/extensions
unzip ~/dcustate.zip
chgrp -R www-data dcustate
  • Allez sur OCS dans la partie extension / extension manager
  • Choisissez le plugin dans la liste puis cliquez sur install
  • Le plugin va apparaître dans la liste
  • Activez-le
  • Déconnectez-vous puis reconnectez-vous à OCS (site web) le plugin devrait être ajouté dans plugin

Retourner sur le serveur en ssh

cd /usr/share/ocsinventory-reports/ocsreports/tools
python3 install_plugin.py

Where is the plugins location [/usr/share/ocsinventory-reports/ocsreports/extensions/](appuyez sur entrée)

[0] => uptime
[3] => winupdate
[4] => dcustate

**(sélectionner le numéro puis entrée) 4 dans notre cas**

The server is installed on the same server ? [y]/n
**(Appuyer sur entrée)**

Where is the server location [/etc/ocsinventory-server]
**(Appuyer sur entrée)**

dcustate been successfully installed ! Don't forget to restart your Apache server

Redémarrer le server apache

systemctl restart apache2

Verifier que le plugin est bien ajouté dans OCS

Allez sur un poste au hasard puis dans other (autre en FR) et cherchez le plugin dcustate, il ne devrait pas contenir de données, car vous n'avez pas encore déployé le plugin sur les postes ou serveurs

Deploiement du plugin sur les postes

Attention avant de deployer le plugin sur tous les postes faite un essai sur un ou deux poste pour vérifier que votre plugin fonctionne

  • Connectez-vous sur l’interface OCS
  • Allez dans Deployment / Build
  • Choisissez Windows / Others / Store file / folder
  • Package Name: dcustate (dans mon cas)
  • Description : voir les MAJ à installer pour DCU
  • Path : C:\Program Files\OCS Inventory Agent\Plugins
  • Cliquez sur choisir un fichier
  • Choisissez le fichier présent dans l’archive / agent
  • En général, c'est un fichier ps1
  • Si vous avez plusieurs fichiers il faudra les zipper (.zip) et choisir l’archive créée
  • Maintenant, allez dans Deployment / activate
  • Cliquez sur le V (vert) à droite de votre package créé précédemment
  • Cliquez sur OK
  • Allez dans All computer
  • Afficher 1000 entrées
  • Cochez la case à côté des titres pour sélectionner tous les ordinateurs
  • Allez tout en bas de la page et cliquez sur Deploy
  • Mass assignment : For selection
  • Use the advanced options of … : NO
  • Cliquez sur Validate
  • Sélectionnez votre package (dcustate dans mon cas)
  • Cliquez sur Add selected package
  • Une barre verte apparaît pour indiquer sur combien de PC votre déploiement a été validé
  • Retourner dans Deployment / Activate
  • Vous verrez le nombre de notifications et d’installations effectuées
  • Si vous souhaitez avoir un graphique, cliquez sur l’icône en forme de graphique bleu à gauche

Fonctionnement de l'agent

L’agent exécute les scripts 1 à 1 qui sont présents dans C:\Program Files\OCS Inventory Agent\Plugins.
Quand il lance les scripts, il met tous les retours affichés dans le terminal, même les retours de commande lors de l'exécution d’exe (faire attention à cela)

Ce fichier est supprimé après l’envoi à OCS, si ce fichier n’est pas valide alors ocs ne le supprime pas, vous pourrez donc le consulter pour voir les erreurs
C:\ProgramData\OCS Inventory NG\Agent\NOMDUSCRIPT.ps1.xml

A savoir :
Si vous lancez des exécutables extérieurs, comme Dell Command Update (DCU) (j’ai eu le problème avec lui)
Dans le script, lancez l’application avec la commande suivante, cela évite qu’OCS ne récupérait les sorties du cmd lors de l'exécution
$null = Invoke-Expression " & '$chemin\dcu-cli.exe' /scan -report=${tempfolder}"

Il faut savoir que tout tourne autour de la BDD de ocs, que ce soit l’envoi de données de votre script ou ce que vous remonte l’interface OCS

Vérification des informations

Une fois les premiers agents déployés
Allez sur l'un des postes ou l'agent a été déployé, other (ou autre en FR) et dans le pluging DCUSTATE vous devriez avoir les informations remontées

Attention les informations ne remontent pas après l'installation du plugin, elle seront remontées au redémarrage du service