G DATA XDR

Configuration of the G DATA Agent

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

You can perform the configuration using --config. The --config option applies the desired configuration and does not require an additional parameter (beyond those required for the desired configuration).

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

Option	Configuration	Parameter type	Description
--config			Sets the configuration parameters for existing installations.
	--proxypacurl	string	Sets a proxy 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.
	--proxybypass	string	Sets a proxy bypass before installation that is intended to be used for backend communication.

Option

Configuration

Parameter type

Description

--config

Sets the configuration parameters for existing installations.

--proxypacurl

string

Sets a proxy 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.

--proxybypass

string

Sets a proxy bypass before installation that is intended to be used for backend communication.

You can combine multiple configurations in a single command.

Example with --config

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

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

Error Codes

To support troubleshooting, the codes that can be returned in the event of an error are listed here. The log files are located on Windows in \ProgramData\G Data\Agent\agent\Logs and on Linux in /var/log/gdata/agent/.

Error code	Description
1001	Error. Review the logs to determine the specific cause.
1002	A restart after uninstalling the previous product is still pending. Restart the system to resolve the issue.
1003	The Setup ID required for the installation was not specified. Try the installation again and provide a valid Setup ID.
1004	The system contains leftover artifacts that prevent installation. Remove the artifacts manually. You can determine which artifacts are still present from the Agent log (C:\ProgramData\G DATA\Agent\agent\Logs).
1005	Unable to connect to G DATA cloud services. Check the proxy settings if applicable.
1006	The combination of command-line parameters is not permitted.