Wechseln zu:Navigation, Suche
Wiki

XDR/Installationshinweise: Unterschied zwischen den Versionen

Aus Securepoint Wiki
← Zum vorherigen Versionsunterschied
K 1 Version importiert
KKeine Bearbeitungszusammenfassung
 
Zeile 5: Zeile 5:




</div>{{Select_lang}}{{TOC2|limit=3}}
</div><!--{{Select_lang}}-->{{TOC2|limit=3}}
{{Header||new=Produkt|Menu={{Menu-XDR||Endpunkte}} {{Reiter|Installation neuer Endpunkte}} }}
{{Header||new=Produkt|Menu={{Menu-XDR||Endpunkte}} {{Reiter|Installation neuer Endpunkte}} }}


Aktuelle Version vom 6. August 2026, 09:00 Uhr





























In dieser Seite werden die Variablen für unterschiedliche Sprachen definiert.
Diese Seite wird auf folgenden Seiten eingebunden





































































Einrichtung von Agenten auf Endpunkten
notempty
Dieser Artikel bezieht sich auf eine Beta-Version
-
Aufruf: Resellerportal Menü  Securepoint XDR XDR-Portal device_hub Endpunkte Installation neuer Endpunkte

Installation

Dieser Artikel beschreibt, wie man unter Windows, Linux oder MacOS Agenten auf Endpunkten installiert und konfiguriert.


Windows

Agenten auf Windows - Endpunkten installieren

  • Die Installation des Agenten erfolgt auf Windows-Endpunkten bei Einzel-Installationen per GUI oder per Kommandozeile.
  • In größerem Umfang kann der Agent per Script, zum Beispiel über eine Gruppenrichtlinie, ausgerollt werden.

  • Eine Setup-Datei sowie die erforderliche Setup ID findet sich im Menü device_hub Endpunkte Reiter Installation neuer Endpunkte
  • Wenn der MXDR Agent auf einer ARM-Architektur installiert werden soll, ist Windows 11 zwingend erforderlich!
  • Wichtige Informationen zur Verwendung von Vorlagen
    Der MXDR Agent darf nicht auf Vorlagen installiert werden, die danach zum Klonen auf anderen Systemen verwendet werden.
    Die Installation des MXDR Agents muss immer nach einem Klon-Vorgang durchgeführt werden, um eine eindeutige Identifizierung von Vorfällen zu gewährleisten.
  • Sollte der Securepoint AV Pro oder ein anderer Anti-Viren Client installiert sein, ist dieser vorher zu deinstallieren. Anschließend musss ein Neustart des Systems erfolgen, bevor die Installation des MXDR Agents durchgeführt werden kann.

    • Installation via .msi Datei

    Wenn man während der Installation eine grafische Benutzeroberfläche bevorzugt, doppelklickt man entweder die .msi Datei oder man verwendet beim Aufruf der msiexec.exe nicht die Parameter /exenoui oder /qn. Anschließend folgt man den Anweisungen im GUI.

     

    1. Man lädt sich die gewünschte Installationsdatei in der Ansicht "Installation neuer Endpunkte" herunter
    2. Dann öffnet man eine Eingabeaufforderung mit administrativen Rechten
    3. Wechsel in das Verzeichnis, in dem sich die Setup-Datei befindet
    4. Es gibt zwei Möglichkeiten den Installationsaufruf zu starten: direkt über die .msi Installationsdatei oder über die msiexec.exe:
      1. Aufruf über msiexec.exe: msiexec.exe /i "gdata_agent_setup.msi" SETUPID="guid" /qn
      2. Aufruf .msi Installationsdatei: gdata_agent_setup.msi /q SETUPID="guid"
    5. Dann bestätigt man die Eingabe. Der MXDR Agent wird nun auf dem System installiert. Abschließend muss der Rechner neu gestartet werden, um die Installation abzuschließen.
  • Die vorgestellten Aufrufe sind rudimentär und sorgen für die Installation ohne weitere Konfiguration. Alle Konfigurationsparameter, wie z.B. Proxy-Einstellungen, kann man im folgenden Abschnitt Parameter für Installation mit msi Datei nachlesen
    •  
    Parameter für Installation mit msi Datei
    Parameter Beschreibung Hinweis
    /qn Führt die Installation im Silent-Mode ohne Benutzerinteraktion durch. msi Parameter
    /q (/quiet) Führt die Installation im Silent-Mode durch. msi Parameter
    /l*V "C:\log\Setup.log" Erstellt eine Protokolldatei am angegebenen Pfad. Der Pfad ist optional, wenn nur eine Datei angegeben wird, wird die Protokolldatei im gleichen Pfad erstellt, wo die Installation ausgeführt wird. msi Parameter
    /x{ProductCode} Deinstallation des angegebenen Produkts. Kann auch mit dem Silent-Parameter kombiniert werden. msi Parameter

    Der ProductCode befindet sich in der Registry:
    HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall{ProductCode} Man sucht nach dem Publisher-Schlüssel mit dem Wert G DATA oder DisplayName mit Agent. Zusätzlich gibt es einen Schlüssel namens AI_MSI_ProductCode mit dem ProductCode.

    SETUPID="guid" "Lizenzschlüssel" (Setup ID) muss für die silent Installation angegeben werden. Bei der Einrichtung über die Benutzeroberfläche ist die Seite mit den Informationen zur Setup ID bereits ausgefüllt.
    PROXYPACURL="curl" Fügt beim Aufruf von agent.exe den Parameter hinzu. Übergibt Proxypacurl an gdata.agent.exe als optionalen Parameter.
    PROXYPASSWORD="password" Fügt beim Aufruf von agent.exe den Parameter hinzu.
    PROXYUSERNAME="username" Fügt beim Aufruf von agent.exe den Parameter hinzu.
    PROXYURL="url" Fügt beim Aufruf von agent.exe den Parameter hinzu.
    PROXYBYPASS="bypass" Fügt beim Aufruf von agent.exe den Parameter hinzu. Liste von Hosts, an die Anfragen nicht über den Proxy geleitet werden. Beispielsweise test.gdata.de oder auch *.gdata.de.

    Installation mit .exe Datei

    notempty
    Die nachfolgend beschriebene Installation ist deprecated (veraltet). Wir empfehlen den oben beschriebenen Weg zu wählen.


    Anleitung anzeigen
    Anleitung ausblenden
    Klicken für dauerhafte Anzeige
    Installation mit GUI

    • Man lädt sich die gewünschte Installationsdatei in der Ansicht "Installation neuer Endpunkte" herunter

    • Dann öffnet man die Installationsdatei und wählt die gewünschte Sprache aus













    Abb.1
    • Start der .exe mit Doppelklick und
    • Bestätigen der Meldung der Benutzerkontensteuerung (UAC)
    Abb.2
  • Auswahl der Sprache
    • Abb.3
  • Start der Installation
    • Abb.4
  • Nun wählt man einen Zielordner für die Installation aus
    • Abb.5
  • Jetzt gibt man die Setup ID ein, die man von G DATA bekommen hat.
    Diese ist im G DATA Web-Portal in der Ansicht "Installation neuer Endpunkte" einsehbar.
    • Abb.6
  • Start der Installation mit Weiter
  • Der G DATA Agent kann noch konfiguriert werden, etwa um Proxyeinstellungen zu setzen.
  • Abschließend muss der Rechner neu gestartet werden, um die Installation abzuschließen.
    • Installation per Kommandozeile
    1. Man lädt sich die gewünschte Installationsdatei in der Ansicht "Installation neuer Endpunkte" herunter.
    2. Dann öffnet man eine Eingabeaufforderung mit administrativen Rechten.
    3. Man wechselt in das Verzeichnis, in dem sich die Setup-Datei befindet.
    4. Start des Setups mit folgendem Befehl:
      1. [NameDerSetupDatei].exe /i /s /id=????????-????-????-????????????
      2. Man ersetzt ????????-????-????-???????????? durch die Setup ID. Diese ist im G DATA Web-Portal in der Ansicht "Installation neuer Endpunkte" einsehbar.
    5. Bestätigung der Eingabe. Der Agent wird nun auf dem System installiert. Der G DATA Agent kann noch konfiguriert werden, etwa um Proxyeinstellungen zu setzen. Final startet man den Rechner neu, um die Installation abzuschließen.


    Konfiguration des G DATA Agents

    Die Konfiguration kann mit --config durchgeführt werden.
    Die Option --config setzt die gewünschte Konfiguration und erfordert keinen weiteren Parameter (abseits der für die gewünschte Konfiguration erforderlichen).
    Beispielaufruf: gdata.agent.exe --config --proxyurl myProxyURL --proxyusername myUsername --proxypassword myPassword

    Parameter Beschreibung
    --config Setzen der Konfigurationsparameter bei bestehenden Installationen
    --proxypacurl Legt eine Proxy-PAC-URL fest, die für die Backend-Kommunikation verwendet wird
    --proxyurl Legt eine Proxy-URL fest, die für die Backend-Kommunikation verwendet wird
    --proxyusername Legt einen Proxy-Benutzernamen fest, der zur Authentifizierung der Backend-Kommunikation verwendet wird
    --proxypassword Legt ein Proxy-Passwort fest, das zur Authentifizierung der Backend-Kommunikation verwendet wird
    --proxybypass Legt vor der Installation einen Proxy-Bypass fest, der für die Backend-Kommunikation verwendet werden soll

    Linux

  • Der G DATA Agent darf nicht auf Vorlagen installiert werden, die danach zum Klonen auf anderen Systemen verwendet werden. Die Installation des G DATA Agent muss immer nach einem Klon-Vorgang durchgeführt werden, um eine eindeutige Identifizierung von Vorfällen zu gewährleisten.
  • Sollte man den Securepoint AV Pro Client installiert haben, muss dieser vorher deinstalliert werden.Anschließend führt man einen Neustart des Systems durch, bevor man die Installation des G DATA Agents durchführt.
    • Anleitung zur Installation des G DATA Agenten unter Linux
    • Man lädt sich sich die gewünschte Installationsdatei in der Ansicht "Installation neuer Endpunkte" herunter.
    • Man wechselt zunächst auf den Root-Benutzer: su -
    • Je nachdem, ob man ein Debian-System hat, oder die Installation mit RPM ausführt, unterscheiden sich die Installationsaufrufe leicht.

    .deb Datei (Debian-basierte Systeme):
    SETUPID=<setupid> apt install ./gdata-agent-amd64.deb

  • Eine Setup-Datei sowie die erforderliche Setup ID findet sich im Menü device_hub Endpunkte Reiter Installation neuer Endpunkte
  • In einigen Fällen erhält man bei der Installation des G DATA Agent für Linux auf Debian-basierten Systemen folgende Meldung: N: Download is performed unsandboxed as root as file …​ couldn’t be accessed by user '_apt'. Es handelt sich nur um einen Hinweis, keinen Fehler, "N" steht für Notice. Sie haben wahrscheinlich die Datei als Root heruntergeladen und anderen Benutzern wurden keine Zugriffsrechte auf die Datei gewährt. APT versucht die Installationen in einer Sandbox durchzuführen und dies durch den Benutzer "_apt". Wenn dieser Benutzer aber keinen Zugriff auf die Datei hat, erhält man die angegebene Meldung und die Installation wird stattdessen durch Root durchgeführt. Der Agent wird trotzdem installiert, dies ist also kein Fehler, sondern nur ein Hinweis. Umgehen kann man die Meldung einfach, indem man anderen Benutzern (Other) auf die Datei vor der Ausführung Leserechte vergibt: sudo chmod 644 ./gdata-agent-amd64.deb oder man verwendet gleich dpkg statt apt zur Installation des Paketes: sudo dpkg -i ./gdata-agent-amd64.deb
    • .rpm Datei:
    SETUPID=<setupid> rpm -i ./gdata-agent-x86_64.rpm
    • Optional können an dieser Stelle die Proxy-Einstellungen wie PROXYPACURL, PROXYURL, PROXYUSERNAME und PROXYPASSWORD als Parameter dem Installationsaufruf beigefügt werden.

      Installationsbeispiel für Debian-basierte Systemen:
      SETUPID=<setupid> PROXYURL=<myProxyURL> PROXYUSERNAME=<myUsername> PROXYPASSWORD=<myPassword> apt install ./gdata-agent-amd64.deb

      Installationsbeispiel für RPM:
      SETUPID=<setupid> PROXYURL=<myProxyURL> PROXYUSERNAME=<myUsername> PROXYPASSWORD=<myPassword> rpm -i ./gdata-agent-x86_64.rpm

    • Die Installation ist hiermit abgeschlossen. Man kann den G DATA Agent noch konfigurieren, etwa um Proxyeinstellungen zu setzen.


    macOS

  • Zur eindeutigen Identifizierung wird der FQDN des Systems, auf dem der G DATA Agent installiert werden soll, verwendet. Stellen Sie bitte sicher, dass auf dem macOS-System der HostName (nicht ComputerName oder LocalHostName!) entsprechend gesetzt ist.
  • Wichtige Informationen zur Verwendung von Vorlagen
    Der MXDR Agent darf nicht auf Vorlagen installiert werden, die danach zum Klonen auf anderen Systemen verwendet werden.
    Die Installation des MXDR Agents muss immer nach einem Klon-Vorgang durchgeführt werden, um eine eindeutige Identifizierung von Vorfällen zu gewährleisten.

    • Installation per GUI













    Abb.1
    Man klickt auf die Installationsdatei und führt diese aus
    Abb.2
    Man gibt die Setup ID ein.
    Diese kann man im G DATA Web-Portal in der Ansicht "Installation neuer Endpunkte" einsehen.
    Abb.3
    Anschließend kann man optional einen Proxyserver konfigurieren.
    Wenn man keinen Proxyserver verwendet, lässt man die Felder leer.
    Abb.4
    Es folgt die Auswahl, für welche Benutzer die Installation erfolgen soll.
    Aufgrund der Art der Software ist es nur möglich, den Agent für alle Benutzer zu installieren.
    Man klickt auf Fortfahren.
    Abb.5
    Im Anschluss muss das Volumen, auf dem die Installation erfolgt, gewählt werden.
    Wie im Schritt davor gibt es auch hier keine Auswahlmöglichkeit.
    Man klickt auf Installieren
    Abb.6
    Der Installationsprozess startet nun.
    Nach erfolgreichem Abschluss der Installation erhält man eine Bestätigung, dass der Agent erfolgreich installiert wurde
    Abb.7
    Die Installationsvorbereitung läuft
    Abb.8
    Als letzten Schritt muss man dem "G DATA Agent" und dem "G DATA MESP Service" noch Festplattenvollzugriff (FDA) erteilen.
    Hierzu geht man in den Einstellungen zu "Datenschutz & Sicherheit" und setzt den entsprechenden Toggle für beide Applikationen.


    Installation per Kommandozeile

    • Man lädt sich sich die gewünschte Installationsdatei in der Ansicht "Installation neuer Endpunkte" herunter.

    • Am Ort der Installationsdatei muss bei der Ausführung eine Datei gdata.agent.cfg vorhanden sein oder erstellt werden, mit folgendem Inhalt:
    SETUPID="setupid"
    PROXYPACURL="pacurl"
    PROXYURL="proxyurl"
    PROXYUSERNAME="proxyusername"
    PROXYPASSWORD="proxypassword"
    PROXYBYPASS="proxybypasslist"

    "setupid" ist nun mit der Setup ID (mit den Apostrophen), die man im G DATA Web-Portal in der Ansicht "Installation neuer Endpunkte" einsehen kann. Bis auf diesen Eintrag sind alle Einträge optional und müssen nur angelegt werden, wenn ein Proxyserver konfiguriert werden soll.

    • Nun öffnet man die Kommandozeile

    • Anschließend gibt man den folgenden Befehl ein:
    sudo installer -pkg gdata-agent-universal.pkg -target /

    • Jetzt gibt man den Applikationen "G DATA Agent" und "G DATA MESP service" vollen Festplattenzugriff (FDA). Dazu öffnet man "Datenschutz & Sicherheit" in den Einstellungen und setzt die entsprechenden Toggle.


    • Die Installation ist nach erfolgreichem Ausführen des Befehls und dem Vergeben des Festplattenvollzugriffs abgeschlossen.

    Abgerufen von „https://wiki.securepoint.de/index.php?title=XDR/Installationshinweise&oldid=111793“