Connection to Viz Pilot Database

The Pilot Data Server requires a connection to a Viz Pilot database with a schema of 5.7 or later. You also need a Pilot Data Server for each database instance, meaning you cannot share a Pilot Data Server. Configure using a full connection string with hostname and SID.

Set up the Pilot Data Server user account

The Pilot Data Server service can be run from two different user accounts, depending on where it will access files.

If the Pilot Data Server is used without any Object Store storage, or if the Object Store storage is on the same computer as the Pilot Data Server, then set up as follows:

1. Run the Pilot Data Server service under the default LocalSystem Account.
   Alternatively, if the Pilot Data Server requires access to remote files, and the computers are in a domain, then set up as follows:

2. Create a new Domain User Account. This needs to have:

   • Administrator access to the computer that runs the Pilot Data Server,

   • Share access on the computer that hosts the Object Store files,

   • File system access to the actual files in the share.

3. Change the service configuration to run the service as the Domain User.

4. Set a complex password for this user, and set it to never expire. If the password expires, the service needs to be reconfigured to run with the new password.

5. Run the Pilot Data Server service under the new Domain User Account.

   Note: The scenario where the Pilot Data Server requires access to remote files, but the computers are not in a domain, is not supported.

Configuring the Pilot Data Server port

The default Pilot Data Server port is 8177. To change it do the following:

1. On the Pilot Data Server machine, open the configuration file in a text editor:

   %ProgramFiles%\vizrt\Data Server\PilotScriptRunnerHostService.exe.config

2. Add or replace the following <settings> tag:

   <applicationSettings>

   <DataServer.Properties.Settings>

   <setting name="Port" serializeAs="String">

   <value>8177</value>

   </setting>

   ...

Configuring the STOMP port

The default STOMP (Change Notifications API) port is 9876. To change it, do the following:

1. On the Pilot Data Server machine, open the configuration file in a text editor:

   %ProgramFiles%\vizrt\Data Server\PilotScriptRunnerHostService.exe.config

2. Change the following:

   <setting name="ChangeServerPort" serializeAs="String">

   <value>9876</value>

   </setting>

   with:

   <setting name="ChangeServerPort" serializeAs="String">

   <value>7373</value>

   </setting>

   The port 7373 is used as an example value only.

   Note:

   Follow this link to go to the STOMP Protocol Specification.

Configuring the Script Runner

Update Services are mechanisms that allow template data to be updated right before going on air, e.g. stock values, player statistics etc. Viz Pilot’s update service is called Script Runner.

The Script Runner will use port 1981 by default. To change this, do the following:

1. On the Pilot Data Server machine, open the configuration file in a text editor:

   • %ProgramFiles%\vizrt\Data Server\PilotScriptRunnerHostService.exe.config

2. Change the port by modifying the following line:

   <add baseAddress="http://localhost:1981" />

3. Save the file.

4. Restart the service Vizrt Script Runner from the Windows Services window.

Configuring the Pilot Data Server for HTTPS

If HTTPS is configured, all endpoints of the Pilot Data Server can be accessed using the HTTPS protocol. To enable it, do the following:

1. Open the configuration file in a text editor as an administrator:

• c:\Program Files\vizrt\Pilot Data Server\PilotAppServerHostService.exe.config

2. Replace the following:

<setting name="SecurePort" serializeAs="String">
   <value/>
</setting>

with:

<setting name="SecurePort" serializeAs="String">
   <value>7373</value>
</setting>

• The port 7373 is here used as an example value only. The port number can be any number from 1024 to 49151. Choose a number that is not already in use.

3. A certificate that is mapped to the port number you provided is required on the PDS host machine. To install a certificate:

• Create a self-signed certificate using the IIS Manager.

• Next, install the certificate into Trusted Root Certification Authorities in the Certificate Manager, which is accessed through certmgr.msc.

• You should then copy the Thumbprint of the certificate, which can be found by opening it and checking under "Details", for later use.

• You then need your Application ID, which can be found by entering this command in the command prompt:

  {{netsh http show sslcert}}

• Next, enter the following commands with your information in a command prompt with Administrator Privileges:

  netsh http add urlacl url=https://+:(YOUR PORT NUMBER)/ user=Everyone
  
  C:\> netsh http add sslcert ipport=0.0.0.0:(YOUR PORT NUMBER) certhash=(YOUR CERTIFICATE'S THUMBPRINT) appid={(YOUR APPLICATION ID)}

4. In Pilot Edge you must set the "pilot" URL parameter to use the new pathway to the PDS. The parameter must include the entire URL of the HTTPS pathway, such as "https://bgo-eddie-vm:7373/".

Modify the Pilot Data Server database settings

1. Run the installer, and select the Change option.

2. Update the database connection information:

   • Connect string, Username and Password.

3. Click Close.

4. Restart the service Vizrt Pilot Data Server from the Windows Services window.

   IMPORTANT! If database settings are changed in the configuration files manually, any subsequent changes done through the installer will overwrite the manual changes. It is strongly recommended that users do not manually change anything related to the database in the configuration file.

Redundancy and Failover for Pilot Data Server

Pilot Data Server has been designed without built-in redundancy, but it does, however, support being used with off-the-shelf third-party HTTP load balancers. As the name suggests, a load balancer's main function is to distribute requests among multiple servers. Multiple servers provide redundancy, and most load balancers come with an option to only route requests to servers that respond, which provides failover.

Both Barracuda Load Balancer ADC and HAProxy have successfully been used in front of Pilot Data Server.