How can I pass a proxy address during installation?

The following rules apply if you're installing Dynatrace OneAgent or Security Gateway.

The Windows installer allows you to enter a proxy address during installation, so in the majority of cases you don't need to worry about adding extra command line parameters. Command line parameters are particularly useful when you're deploying a Group Policy installation or other automated task.

On both Windows and Linux the installer recognizes the PROXY parameter. The value of this parameter is the proxy server address. Add the port number following a colon, for example 172.1.1.128:8080. For an authenticating proxy you can specify username and password like this username:password@172.1.1.128:8080 where both username and password need to be URL encoded. This is not supported for Security Gateway though. Security Gateway only supports format <IP>:<PORT>. We also support IPv6 addresses.

Parameter names are case sensitive, so use ALL CAPS for parameter names.

Passing a proxy address to the installer

Let's say you're running an openSUSE server, you've downloaded your Dynatrace OneAgent installer to the folder /tmp and your proxy IP address is 10.1.1.5. In such a scenario you would begin the installation like this:

cd /tmp
chmod +x Dynatrace-Agent-Linux-0.5.0-20140217-175809.sh
su -c 'Dynatrace-Agent-Linux-0.5.0-20140217-175809.sh PROXY=10.1.1.5'

On Windows, use the command line and type:

C:\Users\Admin\Downloads>Dynatrace-Security-Gateway-Windows-1.117.228.20170414-100302.exe  PROXY=10.1.1.5

Auto-detect proxy settings

To enable detection of global proxy settings during installation, type auto as the PROXY parameter value. On a Linux server for example, you would type:

su -c 'Dynatrace-Agent-Linux-0.5.0-20140217-175809.sh PROXY=auto'