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 using either the --install or --config option. The --install option requires the SetupID as a parameter and reinstalls the G DATA Agent. The --config option sets the desired configuration and does not require additional parameters.

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

The --install command only works if the G DATA Agent is not already installed. In contrast, when using the --config command, the agent has to be installed.

Option	Configuration	Parameter	Description
--install		SetupID	Installation with setting the specified configuration parameters.
--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

Parameter

Description

--install

SetupID

Installation with setting the specified configuration parameters.

--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.

Examples

Example using --install

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

→ Install the G DATA Agent with the specified proxy settings.

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. Use AV-Cleaner (https://secure.gd/dl-avcleaner) or remove the artifacts manually.
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.