Codenica Insight Agent ist ein kleines Programm, das auf einem Computer installiert wird, der in das Monitoring aufgenommen werden soll. Seine Aufgabe ist es, Daten an Codenica zu übermitteln, die für die Analyse der Arbeit am Arbeitsplatz, der Computeraktivität, verwendeter Anwendungen, Systemereignisse und weiterer in den Monitoring-Einstellungen aktivierter Bereiche benötigt werden. Nach erfolgreicher Installation läuft der Agent im Hintergrund und erfordert keine tägliche Bedienung durch den Computernutzer.

Der Download des Installers befindet sich im oberen Bereich der Monitoring-Ansichten. Im Panel gibt es die Schaltfläche Agent-Installer herunterladen sowie eine aufklappbare Hilfe Wie installiert man den Monitoring-Agent. Der wichtigste Punkt ist, dass das Installationspaket für ein bestimmtes Unternehmen vorbereitet wird. Das bedeutet, dass die Verbindungskonfiguration für Ihre Codenica-Umgebung bereits im Installer enthalten ist.

In der Praxis ist die Installation sehr einfach:

  1. Öffnen Sie eine beliebige Monitoring-Ansicht in Codenica.
  2. Klicken Sie auf Agent-Installer herunterladen.
  3. Entpacken Sie das heruntergeladene ZIP-Paket auf dem Computer, den Sie überwachen möchten.
  4. Starten Sie install-agent.bat als Administrator.
  5. Warten Sie, bis die Installation abgeschlossen ist.

Auf dem Computer muss Microsoft .NET Desktop Runtime 10.0.8 oder neuer installiert sein. Wenn die Runtime auf dem Computer noch nicht vorhanden ist, laden Sie sie von Microsoft herunter: .NET 10 herunterladen. Im Monitoring-Panel gibt es außerdem eine Schaltfläche, die direkt zum Installer für .NET 10.0.8 führt.

Was enthält das Installationspaket des Monitoring-Agenten?

Die heruntergeladene Datei ist ein ZIP-Paket, das für Ihr Unternehmen vorbereitet wurde. Es handelt sich nicht um einen beliebigen generischen Installer. Das System fügt eine Konfigurationsdatei mit den Informationen hinzu, die benötigt werden, um den Agenten mit der richtigen Codenica-Umgebung zu verbinden. Dadurch muss die Person, die den Agenten installiert, die Firmenkennung, Serveradresse oder andere technische Parameter nicht manuell eintragen.

Nach dem Entpacken des Ordners finden Sie darin unter anderem:

  • codenica-insight-agent-installer.exe - den eigentlichen Installer des Programms Codenica Insight Agent.
  • codenica-insight-agent.config.json - die Konfiguration, die für ein bestimmtes Unternehmen und eine bestimmte Codenica-Umgebung vorbereitet wurde.
  • install-agent.bat - die einfachste Startdatei für die Installation auf einem einzelnen Computer.
  • install-agent.ps1 - das PowerShell-Skript, das von der BAT-Datei verwendet wird und auch für Remote- oder automatisierte Installationen nützlich ist.
  • Anleitungsdateien in mehreren Sprachen, die den Inhalt des Pakets und die grundlegende Installationsmethode beschreiben.

Die wichtigste Regel ist einfach: Verwenden Sie für die Standardinstallation install-agent.bat. Diese Datei startet den Prozess in der richtigen Reihenfolge und nutzt die im Paket enthaltene Konfiguration.

Codenica Insight Agent Schritt für Schritt installieren

Die Standardinstallation des Monitoring-Agenten erfordert kein manuelles Kopieren von Dateien in Systemordner. Das Paket enthält ein Skript, das die nötigen Schritte automatisch ausführt. Der Benutzer muss die Installation nur mit den passenden Berechtigungen starten.

  1. Laden Sie das Installationspaket aus dem Monitoring-Panel in Codenica herunter.
  2. Übertragen Sie das Paket auf den Computer, der überwacht werden soll.
  3. Entpacken Sie den gesamten ZIP-Ordner. Starten Sie die Dateien nicht direkt aus der Archivvorschau.
  4. Prüfen Sie, ob sich im entpackten Ordner die Dateien install-agent.bat, install-agent.ps1, codenica-insight-agent-installer.exe und codenica-insight-agent.config.json gemeinsam befinden.
  5. Klicken Sie mit der rechten Maustaste auf install-agent.bat.
  6. Wählen Sie Als Administrator ausführen.
  7. Warten Sie, bis das Skript fertig ist und die Abschlussmeldung anzeigt.

Administratorrechte sind erforderlich, weil der Agent einen Windows-Dienst installiert, Programmdateien in Program Files schreibt und die Konfiguration in ProgramData erstellt. Wenn die BAT-Datei ohne diese Rechte gestartet wird, stoppt die Installation und fordert dazu auf, sie erneut als Administrator auszuführen.

.NET 10.0.8 oder neuer ist erforderlich

Für Codenica Insight Agent ist Microsoft .NET Desktop Runtime 10.0.8 oder neuer erforderlich. Das ist eine kostenlose Systemkomponente von Microsoft, mit der Desktop-Anwendungen auf Basis von .NET ausgeführt werden können. Es ist nicht nötig, die vollständige Entwicklungsumgebung oder das SDK zu installieren, wenn der Computer nur den Agenten ausführen soll.

Wenn Sie nicht sicher sind, ob die Runtime bereits installiert ist, behandeln Sie dies am einfachsten als ersten Vorbereitungsschritt für den Computer. Laden Sie die aktuelle Runtime von der offiziellen Microsoft-Website herunter: .NET 10.0 - downloads. In Codenica enthält die Installationshilfe außerdem die Schaltfläche .NET 10.0.8 herunterladen, die den direkten Installer für Windows x64 öffnet.

  • Mindestens erforderliche Version: .NET Desktop Runtime 10.0.8.
  • Sie können eine neuere Version derselben Linie installieren, wenn Microsoft ein aktuelleres Paket bereitstellt.
  • Auf einem typischen Windows-x64-Computer wählen Sie Windows Desktop Runtime x64.
  • Nach der Installation der Runtime kehren Sie zum Agentenordner zurück und starten install-agent.bat.

Was passiert nach dem Start der BAT-Datei?

Die Datei install-agent.bat startet ein PowerShell-Skript, das die eigentliche Installation ausführt. Zuerst prüft es, ob es mit Administratorrechten läuft. Danach bereitet es den Konfigurationsordner des Agenten vor, kopiert codenica-insight-agent.config.json an den vom Programm verwendeten Speicherort und speichert die Datei als agentsettings.json. Erst danach wird der EXE-Installer gestartet.

Während der Installation wird ein Windows-Dienst mit dem Namen CodenicaInsightAgent erstellt. Der Dienst startet automatisch und ist für den Betrieb des Agenten im Hintergrund verantwortlich. Nach der Installation sollte der Agent selbstständig mit der Arbeit beginnen, und neue Daten werden entsprechend der Monitoring-Konfiguration und dem Synchronisationszeitplan an das System übertragen.

Die wichtigsten Speicherorte nach der Installation:

  • C:\Program Files\Codenica Insight Agent - der Standardordner des Programms.
  • C:\ProgramData\Codenica\InsightAgent - der Ordner für Daten, Konfiguration und Logs.
  • C:\ProgramData\Codenica\InsightAgent\Config\agentsettings.json - die eigentliche Konfigurationsdatei, die nach der Installation verwendet wird.
  • C:\ProgramData\Codenica\InsightAgent\Logs - der Ordner für technische Logs.

Woran sollte man bei der Installation des Monitoring-Agenten denken?

Die Installation ist einfach, aber einige Regeln helfen, typische Probleme zu vermeiden. Die wichtigste betrifft die Reihenfolge, in der Dateien gestartet werden: Beginnen Sie nicht mit dem EXE-Installer allein, weil sich die Firmenkonfiguration in einer separaten JSON-Datei befindet. Die BAT-Datei sorgt dafür, dass diese Konfiguration vor der Programminstallation an den richtigen Ort kopiert wird.

  • Starten Sie codenica-insight-agent-installer.exe nicht als erste Datei.
  • Entfernen Sie codenica-insight-agent.config.json nicht aus dem entpackten Ordner.
  • Ändern Sie die Konfiguration nicht manuell, wenn Sie nicht genau wissen, welches Ergebnis Sie erreichen möchten.
  • Starten Sie install-agent.bat als Administrator.
  • Stellen Sie vor der Installation sicher, dass auf dem Computer die erforderliche .NET Desktop Runtime 10.0.8 oder neuer vorhanden ist.
  • Für eine Remote-Installation können Sie install-agent.ps1 verwenden, es muss jedoch aus einem Ordner gestartet werden, der den EXE-Installer und die Konfigurationsdatei enthält.

Nach erfolgreicher Installation werden zukünftige Versionen von Codenica Insight Agent automatisch aktualisiert. Dadurch müssen weder der Computernutzer noch der Administrator bei jeder Agentenaktualisierung manuell einen neuen Installer herunterladen.