G DATA 365 | MXDR

Konfiguration des G DATA Agent

Der G DATA Agent verfügt über verschiedene Konfigurationsmöglichkeiten, die über die Commandline gesteuert werden können.

Sie können die Konfiguration mit den beiden Optionen --install und --config durchführen. Die Option --install erfordert hierbei die SetupID als Parameter und installiert den G DATA Agent neu. Die Option --config setzt die gewünschte Konfiguration und erfordert keinen weiteren Parameter.

Die gdata.agent.exe befindet sich unter Windows innerhalb des Programme-Ordners unter \G DATA\Agent und unter Linux in /opt/gdata/agent/.

Der --install-Befehl funktioniert nur, wenn keine Installation des G DATA Agent vorhanden ist. Demgegenüber muss bei Verwendung des --config-Befehl der Agent schon installiert sein.

Option	Konfiguration	Parameter	Beschreibung
--install		SetupID	Installation mit Setzen der Konfigurationsparameter.
--config			Setzen der Konfigurationsparameter bei bestehenden Installationen.
	--proxypacurl	string	Legt eine Proxy-PAC-URL fest, die für die Backend-Kommunikation verwendet wird.
	--proxyurl	string	Legt eine Proxy-URL fest, die für die Backend-Kommunikation verwendet wird.
	--proxyusername	string	Legt einen Proxy-Benutzernamen fest, der zur Authentifizierung der Backend-Kommunikation verwendet wird.
	--proxypassword	string	Legt ein Proxy-Passwort fest, das zur Authentifizierung der Backend-Kommunikation verwendet wird.

Option

Konfiguration

Parameter

Beschreibung

--install

SetupID

Installation mit Setzen der Konfigurationsparameter.

--config

Setzen der Konfigurationsparameter bei bestehenden Installationen.

--proxypacurl

string

Legt eine Proxy-PAC-URL fest, die für die Backend-Kommunikation verwendet wird.

--proxyurl

string

Legt eine Proxy-URL fest, die für die Backend-Kommunikation verwendet wird.

--proxyusername

string

Legt einen Proxy-Benutzernamen fest, der zur Authentifizierung der Backend-Kommunikation verwendet wird.

--proxypassword

string

Legt ein Proxy-Passwort fest, das zur Authentifizierung der Backend-Kommunikation verwendet wird.

Sie können mehrere Konfigurationen in einem Befehl zusammenfassen.

Beispiele

Beispiel mit --install

gdata.agent.exe --install setupid --proxyurl myProxyURL --proxyusername myUsername --proxypassword myPassword

→ Installiert den G DATA Agent mit den angegebenen Proxy-Einstellungen.

Beispiel mit --config

gdata.agent.exe --config --proxyurl myProxyURL --proxyusername myUsername --proxypassword myPassword

→ Setzt für den installierten G DATA Agent die angegebenen Proxy-Einstellungen.

Fehlercodes

Zur besseren Fehlersuche sind hier die Codes aufgeführt, die bei einem Fehler zurückgegeben werden können. Die Log-Dateien befinden sich unter Windows in \ProgramData\G Data\Agent\agent\Logs und unter Linux in /var/log/gdata/agent/.

Fehlercode	Beschreibung
1001	Fehler, sehen sie sich die Protokolle an, um die genaue Fehlerursache zu ermitteln.
1002	Der Neustart nach der Deinstallation des vorherigen Produkts steht noch aus. Starten Sie das System neu, um das Problem zu beheben.
1003	Die für die Installation erforderliche SetupID wurde nicht angegeben. Versuchen Sie die Installation erneut und geben Sie eine gültige SetupID an.
1004	Das System enthält Artefakte, die die Installation verhindern. Verwenden Sie AV-Cleaner (https://secure.gd/dl-avcleaner) oder entfernen Sie die Artefakte manuell.
1005	Verbindung zu G DATA Cloud Services nicht möglich. Überprüfen Sie ggf. die Proxy-Einstellungen.
1006	Die Kombination der Befehlszeilenparameter ist nicht zulässig.