Configuring a Proxy

If you would like to run your Collector through a proxy, use the following process for installation:

Linux / macOS (Option 1 - Environment Variable)

The install script will not prompt you for any proxy information, so the appropriate flags must be added for proxy configuration unless on macOS or Linux using the http_proxy or https_proxy environment variables.

Linux / macOS (Option 2 - Script Parameters)

• Run the installation with the following parameters.
  • -x Proxy hostname
  • -U Proxy username (optional)
  • -P Proxy password (optional)

*Note: The example below assumes your proxy server is proxyserver.mydomain.tld on port 3128 Also, make sure to replace YOUR-SECRET-KEY with your company's secret key, which can be obtained from https://bindplane.bluemedora.com/collectors/new

SECRET_KEY=YOUR-SECRET-KEY sh -c "$(curl -x https://proxyserver.mydomain.tld:3128 -fsSl https://bindplane.bluemedora.com/collectors/unix_install.sh)" unix_install.sh -x https://proxyserver.mydomain.tld:3128

Windows

• Download the installation script from a web browser that has the appropriate proxy configuration specified in the OS from https://bindplane.bluemedora.com/collectors/windows_install.ps1

• Start the installation with the following parameters.

  • -x Proxy hostname
  • -pu Proxy username (optional)
  • -pp Proxy password (optional)

Example: Command Line

*Note: The example below assumes your proxy server is proxyserver.mydomain.tld on port 3128 Also, make sure to replace YOUR-SECRET-KEY with your company's secret key, which can be obtained from https://bindplane.bluemedora.com/collectors/new

@powershell -NoProfile -ExecutionPolicy Bypass -Command "$env:SECRET_KEY = 'YOUR-SECRET-KEY'; ./windows_install.ps1; BindPlane-Windows-Install -x https://proxyserver.mydomain.tld:3128"