Pilot Data Server Administrator Guide

Version PDS-8.3 | Published October 17, 2018 ©

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-mentioned 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.

    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.

URL Path Prefix Support in Pilot Data Server

To install a Pilot Data Server with a prefix, the installer has to be executed in the following manner:

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.

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, the installer has to be executed in the following manner:

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 will override the Pilot Data Server setting Base Path if it is set.