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 Safe mode

If Safe mode is enabled, 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:

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

2. Change the following:

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

   <value/>

   </setting>

   with:

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

   <value>7373</value>

   </setting>

The port 7373 is used as an example value only.

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.