G DATA 365 | MXDR

Configuration of the G DATA Agent

The G DATA Agent has various configuration options that can be controlled via the command line.

You can perform the configuration with --config. The --config option sets the desired configuration and requires no additional parameters (apart from those necessary for the desired configuration).

The gdata.agent.exe file is located in Windows in the Programs folder under \G DATA\Agent and in Linux in /opt/gdata/agent/.

Option	Configuration	Parametertype	Description
--config			Setting the specified configuration parameters for existing installation.
	--proxypacurl	string	Sets a PAC URL that is used for backend communication.
	--proxyurl	string	Sets a proxy URL that is used for backend communication.
	--proxyusername	string	Sets a proxy username that is used to authenticate backend communication.
	--proxypassword	string	Sets a proxy password that is used to authenticate backend communication.

Option

Configuration

Parametertype

Description

--config

Setting the specified configuration parameters for existing installation.

--proxypacurl

string

Sets a PAC URL that is used for backend communication.

--proxyurl

string

Sets a proxy URL that is used for backend communication.

--proxyusername

string

Sets a proxy username that is used to authenticate backend communication.

--proxypassword

string

Sets a proxy password that is used to authenticate backend communication.

You can combine multiple configurations in a single command.

Example using --config

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

→ Sets the specified proxy settings for the installed G DATA Agent.

Error codes

For better troubleshooting, the error codes that may be returned are listed here. The log files are located in Windows in \ProgramData\G Data\Agent\agent\Logs and in Linux in /var/log/gdata/agent/.

Error code	Description
1001	Failure, take a look into logs for further investigation.
1002	Pending reboot of previous product uninstallation. Restart the system to solve the problem.
1003	The setup ID required for installation has not been specified. Retry installation providing the valid SetupID.
1004	System contains artifacts which prevents the installation. Remove the artifacts manually. You can see which artifacts are still present in the agent log (C:\ProgramData\G DATA\Agent\agent\Logs).
1005	Unable to connect to G DATA Cloud Services. Check your proxy settings if necessary.
1006	The combination of command line parameters is not permitted.