Codenica Insight Agent est un petit programme installé sur l’ordinateur qui doit être inclus dans le monitoring. Son rôle est de transmettre à Codenica les données nécessaires à l’analyse du travail sur le poste, de l’activité de l’ordinateur, des applications utilisées, des événements système et des autres zones activées dans les paramètres de monitoring. Après une installation correcte, l’agent fonctionne en arrière-plan et ne demande aucune action quotidienne à l’utilisateur de l’ordinateur.

Le téléchargement de l’installateur se trouve dans la partie supérieure des vues de monitoring. Le panneau contient le bouton Télécharger l’installateur de l’agent ainsi qu’une aide déroulante Comment installer l’agent de monitoring. Le point essentiel est que le package d’installation est préparé pour une entreprise précise. Cela signifie que la configuration de connexion à votre environnement Codenica est déjà incluse avec l’installateur.

En pratique, l’installation est très simple :

  1. Ouvrez n’importe quelle vue de monitoring dans Codenica.
  2. Cliquez sur Télécharger l’installateur de l’agent.
  3. Extrayez le package ZIP téléchargé sur l’ordinateur que vous souhaitez monitorer.
  4. Lancez install-agent.bat en tant qu’administrateur.
  5. Attendez la fin de l’installation.

L’ordinateur doit disposer de Microsoft .NET Desktop Runtime 10.0.8 ou version ultérieure. Si le runtime n’est pas encore présent sur l’ordinateur, téléchargez-le depuis le site Microsoft : télécharger .NET 10. Le panneau de monitoring contient également un bouton menant directement à l’installateur .NET 10.0.8.

Que contient le package d’installation de l’agent de monitoring ?

Le fichier téléchargé est un package ZIP préparé pour votre entreprise. Ce n’est pas un installateur générique quelconque. Le système y ajoute un fichier de configuration contenant les informations nécessaires pour connecter l’agent au bon environnement Codenica. Ainsi, la personne qui installe l’agent n’a pas besoin de saisir manuellement l’identifiant de l’entreprise, l’adresse du serveur ni d’autres paramètres techniques.

Après extraction du dossier, vous y trouverez notamment :

  • codenica-insight-agent-installer.exe - l’installateur réel du programme Codenica Insight Agent.
  • codenica-insight-agent.config.json - la configuration préparée pour une entreprise et un environnement Codenica précis.
  • install-agent.bat - le fichier de lancement le plus simple pour une installation sur un seul ordinateur.
  • install-agent.ps1 - le script PowerShell utilisé par le fichier BAT, également utile pour une installation distante ou automatisée.
  • Des fichiers d’instructions en plusieurs langues décrivant le contenu du package et la méthode d’installation de base.

La règle principale est simple : pour une installation standard, utilisez install-agent.bat. C’est lui qui lance le processus dans le bon ordre et utilise la configuration jointe au package.

Installation de Codenica Insight Agent étape par étape

L’installation standard de l’agent de monitoring ne nécessite pas de copier manuellement des fichiers dans les dossiers système. Le package contient un script qui effectue automatiquement les actions nécessaires. L’utilisateur doit seulement lancer l’installation avec les droits appropriés.

  1. Téléchargez le package d’installation depuis le panneau de monitoring dans Codenica.
  2. Transférez le package sur l’ordinateur qui doit être monitoré.
  3. Extrayez tout le dossier ZIP. Ne lancez pas les fichiers directement depuis l’aperçu de l’archive.
  4. Vérifiez que le dossier extrait contient bien ensemble les fichiers install-agent.bat, install-agent.ps1, codenica-insight-agent-installer.exe et codenica-insight-agent.config.json.
  5. Cliquez avec le bouton droit sur install-agent.bat.
  6. Choisissez Exécuter en tant qu’administrateur.
  7. Attendez que le script termine son travail et affiche le message final.

Les droits administrateur sont requis, car l’agent installe un service Windows, écrit les fichiers du programme dans Program Files et crée la configuration dans ProgramData. Si le fichier BAT est lancé sans ces droits, l’installation s’arrête et demande d’être relancée en tant qu’administrateur.

.NET 10.0.8 ou version ultérieure est requis

Codenica Insight Agent nécessite Microsoft .NET Desktop Runtime 10.0.8 ou version ultérieure. Il s’agit d’un composant système gratuit de Microsoft qui permet d’exécuter des applications desktop basées sur .NET. Il n’est pas nécessaire d’installer l’environnement de développement complet ni le SDK si l’ordinateur doit uniquement exécuter l’agent.

Si vous ne savez pas si le runtime est déjà installé, le plus simple est de le considérer comme la première étape de préparation de l’ordinateur. Téléchargez le runtime actuel depuis le site officiel de Microsoft : .NET 10.0 - downloads. Dans Codenica, les instructions d’installation contiennent également un bouton Télécharger .NET 10.0.8, qui ouvre l’installateur direct pour Windows x64.

  • Version minimale requise : .NET Desktop Runtime 10.0.8.
  • Vous pouvez installer une version plus récente de la même ligne si Microsoft propose un package plus actuel.
  • Sur un ordinateur Windows x64 classique, choisissez Windows Desktop Runtime x64.
  • Après l’installation du runtime, revenez au dossier de l’agent et lancez install-agent.bat.

Que se passe-t-il après le lancement du fichier BAT ?

Le fichier install-agent.bat lance un script PowerShell qui effectue l’installation réelle. Il vérifie d’abord s’il fonctionne avec les droits administrateur. Ensuite, il prépare le dossier de configuration de l’agent, copie codenica-insight-agent.config.json dans l’emplacement utilisé par le programme et l’enregistre sous le nom agentsettings.json. Ce n’est qu’après cela qu’il lance l’installateur EXE.

Pendant l’installation, un service Windows nommé CodenicaInsightAgent est créé. Le service démarre automatiquement et assure le fonctionnement de l’agent en arrière-plan. Après l’installation, l’agent devrait commencer à fonctionner seul, et les nouvelles données commenceront à parvenir au système selon la configuration du monitoring et le calendrier de synchronisation.

Les emplacements les plus importants après l’installation :

  • C:\Program Files\Codenica Insight Agent - dossier par défaut du programme.
  • C:\ProgramData\Codenica\InsightAgent - dossier des données, de la configuration et des journaux.
  • C:\ProgramData\Codenica\InsightAgent\Config\agentsettings.json - fichier de configuration réel utilisé après l’installation.
  • C:\ProgramData\Codenica\InsightAgent\Logs - dossier des journaux techniques.

À quoi faut-il penser lors de l’installation de l’agent de monitoring ?

L’installation est simple, mais quelques règles permettent d’éviter les problèmes les plus courants. La plus importante concerne l’ordre de lancement des fichiers : ne commencez pas par l’installateur EXE seul, car la configuration de l’entreprise se trouve dans un fichier JSON séparé. Le fichier BAT veille à copier cette configuration au bon endroit avant l’installation du programme.

  • Ne lancez pas codenica-insight-agent-installer.exe comme premier fichier.
  • Ne supprimez pas codenica-insight-agent.config.json du dossier extrait.
  • Ne modifiez pas manuellement la configuration si vous ne savez pas exactement quel résultat vous voulez obtenir.
  • Lancez install-agent.bat en tant qu’administrateur.
  • Avant l’installation, vérifiez que l’ordinateur dispose du .NET Desktop Runtime 10.0.8 ou version ultérieure requis.
  • Pour une installation distante, vous pouvez utiliser install-agent.ps1, mais il doit être lancé depuis un dossier contenant l’installateur EXE et le fichier de configuration.

Après une installation correcte, les prochaines versions de Codenica Insight Agent seront mises à jour automatiquement. Ainsi, ni l’utilisateur de l’ordinateur ni l’administrateur n’ont besoin de télécharger manuellement un nouvel installateur à chaque mise à jour de l’agent.