Pilot Data Server Administrator Guide

Version PDS-8.8 | Published December 21, 2021 ©

Proxy Support

The Pilot Data Server can be installed along with a proxy/reverse-proxy server. The proxy server must populate the following headers in order for the Pilot Data Server to serve the appropriate hostname, port and protocol in its responses:

  • X-Forwarded-Host

  • X-Forwarded-Port

  • X-Forwarded-Proto

Use a proxy server with the above headers configured. If the X-Forwarded headers are not configured in the proxy server, then the proxy server must be configured to pass the Host header it received from the client to the Pilot Data Server.

Tip: Read the relevant proxy server manual for more information about this configuration.

Using URL Path Prefix Support in Pilot Data Server

The purpose of a URL path prefix is to be able to host a Pilot Data Server with a different hosting URL than the default one. One use case is to make the Pilot Data Server able to work under a reverse-proxy server.

To install a Pilot Data Server with a prefix, execute the the installer as follows:

C:\>msiexec /i c:\temp\PilotDataServerInstaller-x64.msi CONNECTION_METHOD="Oracle" ORACLE_USERNAME="pilot" ORACLE_PASSWORD="pilot" ORACLE_DATA_SOURCE="bgovcp1/vizrtdb" BASE_PATH="pds" /log install.log

Here, the prefix is pds which is specified by the BASE_PATH switch.

Using Base URL Support in Pilot Data Server

If the Base URL switch is used while installing the Pilot Data Server, the host URL will be re-written to the Base URL for every response.

To install a Pilot Data Server with a Base URL, execute the the installer as follows:

c:\>msiexec /i c:\temp\PilotDataServerInstaller-x64.msi CONNECTION_METHOD="Oracle" ORACLE_USERNAME="pilot" ORACLE_PASSWORD="pilot" ORACLE_DATA_SOURCE="bgovcp1/vizrtdb" BASE_URL="http://something.com/pds" /log install.log

The Base URL must be an absolute URL string.

Note: Using Base URL overrides the Pilot Data Server setting Base Path, if the Base Path is set.