How to pass a proxy address during OneAgent installation on Windows

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.

The OneAgent installer recognizes the --set-proxy (recommended since version 1.185) or PROXY parameters. The value of these parameters 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. 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've downloaded your OneAgent installer to the C:\Users\Admin\Downloads folder and your proxy IP address is 10.1.1.5. In such a scenario you would begin the installation like this:

C:\Users\Admin\Downloads>Dynatrace-OneAgent-Windows-1.171.0.exe  --set-proxy=10.1.1.5

Change proxy after installation

If you need to change the proxy address after installation, use --set-proxy in the OneAgent command-line interface.