Configure the Windows or Linux Player

Before you configure the Windows or Linux Player for DOOH, ensure that you meet the following requirements:

• You’ve installed the standard Windows Player or Linux Player.

• You’ve connected the player to the IXM Platform.

• You’ve installed the latest config settings for the player on the server.

Install the DOOH add-on

To use SSP on the Windows or Linux Player, you must install the DoohPlaybackService add-on.

You can install this add-on from the server via an update package or locally on the player. For information on the update package, please contact your Grassfish account manager.

To install the add-on manually, perform the following steps:

1. Store the installation package in any folder on the player.

2. Open a command prompt as administrator. 

3. To install the package, run a bootstrap command. Enter the command that matches your player's operating system: 

   • For Windows, enter: C:\GVClient\tools\current\gfBootstrap\gfBootstrap [path to]\DoohPlaybackService_version_win-x64.zip

   • For Linux, enter: sudo/opt/grassfish/tools/current/gfBootstrap/gfBootstrap [path to]/DoohPlaybackService_version_linux-x64.zip

4. Restart the player service or reboot the player for your changes to take effect.

Install Mosquitto for MQTT

The add-on communicates with the Windows or Linux player via Message Queuing Telemetry Transport (MQTT). To do this, Mosquitto must be installed as a broker for the MQTT protocol.

For the Linux Player, MQTT is already included in the installation package by default.

For the Windows Player, you can install MQTT from the server via an update package or locally on the player:

• For information about the update package, please contact your Grassfish Account Manager.

• To manually install Mosquitto on Windows, open the mosquitto-1.6.9-install-windows-x64.exe file from the installation package and install it.

Enable MQTT

You must configure the player or its configuration group in the IXM Platform to enable the connection to the MQTT broker. Perform the following steps:

1. In the IXM Platform, go to go to the player configuration or configuration group:

   • For an individual player, go to Channels > Location. Double-click on your player and select Edit next to Configuration in the Edit player window.

   • For a configuration group, go to Administration > Player > Configuration groups and double-click on the configuration group.

2. In the Edit configuration group window, select Display extended modules.

3. Configure the following settings:

   • Under Common > Backend, select Enable connection to mqtt broker.

   • Under Overseer > Tool, select Control installed mosquito service.

   • Under Server, set accesslevel for servertoken to Standard or Full.
     

     

4. Click Save to save your changes.

5. Restart the player service or reboot the player for your changes to take effect.

Enable SSP

You must enable and configure SSP in the player configuration or configuration group. Before you do so, ensure that you read the following prerequisites.

Prerequisites

• You can set an airtime ratio for SSP content on the player to specify how much airtime goes to SSP advertisements, just like you can set airtime for DOOH.

• In total, the SSP airtime percentage and DOOH airtime percentage must not exceed 100%.

• By default, filling up with SSP spots is enabled and SSP airtime is set to 0%. This means that unused DOOH airtime is used for SSP if SSP spots are available regardless of SSP airtime.

To enable and configure SSP, perform the following steps:

1. In the IXM Platform, go to the player configuration or the configuration group: 

   • For an individual player, go to Channels > Location. Double-click on your player and select Edit next to Configuration in the Edit player dialog.

   • For a configuration group, go to Administration > Player > Configuration groups and double-click on the configuration group. 

2. In the Edit configuration group window, select DOOH > SSP.

3. In the Settings pane, select enable SPP.

4. Optionally, change the timeout for SSP API requests (milliseconds). If the SSP API request takes longer than the timeout, the system cancels it.

5. Optionally, change the timespan to be considered for the SSP calculation(seconds). If calculating the SSP spot playouts takes longer than the timeout, the system cancels it.
   

   

6. Click Save to save your changes.

7. Restart the player service or reboot the player for your changes to take effect.