Gateway Administrator Guide

Version 5.0 | Published January 08, 2018 ©

Gateway Server

Configuring the Gateway server can be done locally on the server host, where the Media Sequencer with the MOS gateway functionality is installed, or remotely from a client machine using the Gateway Controller web-application. In both cases the web interface application will be used.

Activate the Gateway Server

Connect to the Gateway at host <ADDRESS> (substitute <ADDRESS> with the actual hostname or ip-address) by browsing to the following web address:

http://<ADDRESS>:8580/app/gatewaycontroller/gatewaycontroller.html

The first time the Gateway server is used, it needs to be initialized. Click the Start button, and the Media Sequencer will be enabled as a Gateway server. When the Gateway server is enabled the Running indicator will indicate connection.

images/download/attachments/33948161/activateserver.png

Backend Config

The Viz Pilot database is a key part of any Gateway server installation. The Gateway server forwards the MOS Object messages to the newsroom system to synchronize metadata about the Pilot Data elements.

Pilot Data Server

The Pilot Data Server option can be used to connect to both of Viz Pilot's currently supported database backends: Graphic Hub and Oracle.

The Pilot Data Server notifies Gateway about changes in the database (using a Stomp based protocol with fallback to doing polling of the Pilot Data Server's change log). Gateway generates the MOS Object messages that are sent to the the NCS to synchronize meta data about the Pilot Data Elements.

images/download/attachments/33948161/image2017-10-24_14-26-22.png

  1. Click the Backend Config tab

  2. Select Pilot Data Server

  3. Enter the base URL with the port number: hostname:8177

Oracle

The Oracle option is mainly to be used with Viz Pilot setups that are not running Viz Pilot's Data Server version 7 or later.

Stored procedures on the Oracle database backend notifies the Gateway about changes of Pilot Data elements in the database. Gateway generates the MOS Object messages that are sent to the NCS to synchronize meta information about the Pilot Data elements.

images/download/attachments/33948161/image2017-10-24_14-27-36.png

  1. Click the Backend Config tab

  2. Click Oracle

  3. Enter the SID, Username, Password and Schema Name for the database.

    Note:

    The database Schema-name is case-sensitive.

  4. Check the Log DB Messages (optional).

  5. Click Apply Settings Button.

  6. Click the Restart button for changes to take effect on the Gateway server.

The procedure above should connect the Gateway server to the Viz Pilot database, switch the DB connected indicator to green, and enable the Gateway server to receive messages from the database.

IMPORTANT!

Before installing the Gateway Controller Client, make sure an Oracle Database Client is installed and working. The Oracle Client version should match the Oracle Database in use. If using a 64-bit Gateway the Oracle Client must be 64-bit. Oracle uses the Windows PATH environment variable to select which Client to use if there are several Oracle Clients installed.

Newsroom Servers

Click the NCS Server Config tab to configure the newsroom servers. Configuration is done per newsroom system.

images/download/attachments/33948161/adncsid.png

If no newsroom system is added to the Gateway server, do the following:

  1. Click the Add New button and the Create New NCS dialog appears.

  2. Enter the NCS ID, and click OK

  3. Select the newly-added entry from the list of newsroom systems.

In the Basic Settings frame, change the following:

  1. Enter the server IP and MOS ID. The rest are optional settings.

  2. In the Advanced Settings frame, different settings can be enabled or disabled depending on the newsroom system in use.

  3. When done click the Apply Settings button.

  4. Click the Restart button for changes to take effect on the Gateway server.
    Repeat the steps above to add all the needed newsroom systems.

Tip:

If the newsroom systems have the same setup, select a newsroom system from the list and click the Duplicate button.

Routing

images/download/attachments/33948161/image2017-10-24_16-17-54.png

Click the Routing tab to manually configure routing of running orders, also known as rundowns and playlists, to the control station.

  1. Add the roChannel name and control station IP and click the Add Route button

  2. For the routing to take effect, click the NCS Server Config tab and check the Enable Autoactivation box for the newsroom system that the running orders are automatically routed from.

  3. When done, click the Apply Settings button.

  4. Click the Restart button for changes to take effect on the Gateway server.

Failover

images/download/attachments/33948161/image2017-10-24_16-19-38.png

The failover setting allows the Viz Gateway server to send its messages to more than one NCS system. For failover to work, the newsroom system must be setup with a main and backup server accordingly.

Set up and main and backup server

  1. Add a main and a backup NCS from the drop-lists

  2. Click the Add Failover Pair button

  3. The setting is set to Active after adding a pair

  4. The Always use Main NCS ID setting should be left inactive unless using the Sobey NSC system

  5. Click the Restart button for changes to take effect on the Viz Gateway server.

    Note:

    Currently, this feature is only supported by ENPS and Sobey.

Control Station Backup

images/download/attachments/33948161/image2017-10-24_16-20-36.png

The Control Station Backup setting allows Gateway to send each message that has been targeted to both a specific control station and a backup control station simultaneously.

To configure:

  1. Add the IP address for the main and Backup Control Station and click the Add Backup button.

  2. Click the Restart button for changes to take effect on the Gateway server

    Note:

    It is possible to configure a system where two control stations are backup for each other.

As an example, let’s say we have two Media Sequencers as control stations: servers A and B. Now we take the actions in the table below:

Action

Result

Set server A as Main, B as Backup using the “Add Backup” button.

A is now Main, B is Backup.

Keep the definitions from the step above, and now add B as Main and A as Backup.

Both control stations A and B are updated with MOS messages, both are running.

From a Viz client, such as Trio or Pilot, connect to B and request a MOS playlist.

Control station B becomes Main control station now.Whichever control station requests MOS playlist first, becomes Main control station.The MOS playlist becomes available to both of the control stations.

Shut down control station B.

Control station A becomes Main and start receiving and sending all the updates. Gateway does not receive any message from Control station B.