Viz Mosart Media Router Guide

Version 5.4 | Published October 04, 2023 ©

The Media Router Service Configuration

The service configuration XML file contains the following information:

  • Services: A list over the protocols that will be active. The following protocols are available:

  • Database: The Media Router database specification.

    • Currently supported is a file repository where the Media Router database is stored as a single xml file. Default named MediaRouterDB.xml

  • Service Properties: A set of properties controlling the behavior of the corresponding services

  • Properties: A set of properties controlling the behavior of the Media Router Service (MosartMediaRouterService)

Example Service Configuration

The Media Router service configuration is stored in a single xml file as shown below:

MediaRouterServiceConfig.xml
<?xml version="1.0" encoding="utf-8" ?>
<MediaRouterConfig>
<!-- MMR SERVICES: CONFIGURATION OF ACTIVE PROTOCOLS -->
<Services>
<Service type="MosartMediaRouterService" />
<Service name="vsm" type="ProBelMediaRouterSerialService" configuration="Type=ProBelMessageServerTransporter;Port=8123" />
<Service type="RestMediaRouterService" />
</Services>
<!-- MMR Database configuration using single xml file -->
<Database type="File" name="File" configuration="MediaRouterDB.xml" />
<!-- SERVICE PROPERTIES -->
<ServiceProperties name="vsm"> <!-- use name attribute to identify corresponding service -->
<item name="Mode" value="Router"/>
<item name="UpdateCurrentSalvoCrosspoints" value = "true"/>
<item name="DisableControllerStatusResponse" value = "true"/>
</ServiceProperties>
<!-- MosartMediaRouterService PROPERTIES -->
<Properties>
<!-- MMR MASTER / SLAVE PROPERTIES -->
<item name="Id" value="MR1" />
<item name="PreferredMaster" value="True" />
<item name="Slave" value="Name=MR2;Server=localhost;Port=8192" />
<item name="AutoFailover" value="True" />
<!-- MOSART SERVER REDUNDANCY PROPERTIES -->
<item name="MirrorMode" value="True" />
<item name="MirrorModeMaster" value="Active" />
<item name="SynchronizedMirroring" value="False" />
<!-- GENERAL PROPERTIES -->
<item name="AutoTake" value="False" />
<item name="BackupOnStartUp" value="True" />
<!-- MMR REST PROTOCOL PROPERTIES -->
<item name="UseAuthorisation" value="False" />
</Properties>
</MediaRouterConfig>

MosartMediaRouterService

One service item of type “MosartMediaRouterService” shall be part of the list of services in order to communicate with Viz Mosart Services. Configuration of the MosartMediaRouterService is done using the Properties section of the MMR service configuration file. The following properties are available:

Property

Description

Default

AutoFailover

Set to true if a slave in a master/slave redundancy setup shall take over control automatically when detecting connectivity problems to the master

true

AutoTake

Set to true if all pending crossspoints automatically should be considered as valid. I.e. a corresponding crosspoints set in the CurrentSalvo

false

BackupOnStartUp

If set a backup of the MMR database will automatically be made when the MMR service is started. Backup files are placed in a directory named MediaRouter. The directory is located in the same directory as the MMR database.

true

Id

Unique identity of the MMR Service instance. Used when two MMR Service instance are used in a master/slave redundancy setup.

GUID

LocalServer

For testing only. Set to true if the MMR service should run locally without any valid network attached.

false

MirrorMode

Set to true to activate mirror mode. If mirror mode is activated then all crosspoints set on a Mosart server in a redundancy setup will also be sent to the other Mosart server. Hence ensuring that the configuration of the two Mosart servers are equal.

false

MirrorModeMaster

In mirror mode, determines when crosspoints set for one Mosart server in a redundancy setup should be reflected to the other Mosart server.

Options:

  • Active - only crosspoints set on the currently active Mosart server will be reflected to the other.

  • LowestOrder - only crosspoints set on the Mosart server with lowest order number will be reflected to the other. The order number is set in the MMR database configuration.

Active

PreferredMaster

In a MMR redundancy setup set this to true for the MMR Service instance which should be the main or master service.

false

Slave

Connectionstring to the other MMR instance in a master/slave redundancy setup. Syntax:

“Name=<id>”;Server=<hostname>;Port=<port>” where:

  • id - Shall equal the Id property of the other MMR instance

  • hostname - is the hostname of the other MMR instance

  • port - is the tcp/ip listening port of the other MMR instance

empty = no redundancy setup

SynchronizedMirroring

If set and in mirror mode any crosspoint set on a Mosart server will be reflected to the other Mosart server. Regardless whether the Mosart server is active or not.

false

UseAuthorisation

Used to activate authorisation for the MMR REST protocol (4)

false

ProBelMediaRouterService

Used to add control of Media Router via the Probel SW-P-08 protocol. The ProBel service itself is configured using a corresponding ServiceProperties section or via the connection string given by the “configuration” attribute. The following properties are available:

Property

Description

Default

Name

Identifies the service and the corresponding ServiceProperties section. Note that Name is also used to tag log messages related to the service.


Type

Identifies the how to communicate with the controlling ProBel device. The following options are available:

ProBelMessageClientTransporter - In this case Media Router connects to the controlling device using a tcp/ip connection. Use Server and Port properties to configure the tcp/ip connection. This is the most common type when connection to a VSM system.

ProBelMessageSerialTransporter - Same as ProBelMessageClientTransporter but uses a serial connection. Use ComPort to identify the COM port.

ProBelMessageServerTransporter - In this case Media Router listens to connecting devices supporting the ProBel protocol. I.e. Media Router acts like a real router. Use the Port property to specify the listening port. This is common type when connecting to a BFE-KSE system.


Port

Used by Client and Server Transporter types to identify the tcp/ip port.

10000

ComPort

Used by Serial Transporter type to identify the serial COM port

COM1

Server

Used by Client Transporter type to identify the host of the controlling ProBel device.

localhost

Mode

Identifies how crosspoint changes from the controlling device shall be handled. Only crosspoints that will change the current state of Media Router will lead to any configuration changes.

The following options are available:

Router - In this case the Media Router is treated as a physical router:

  • The Media Router salvo “CurrentSalvo” is used for comparison for crosspoint changes.

  • ProBel CrosspointConnected (04) messages are sent to the Probel controlling device to notify any crosspoint changes.

  • The client (like vsm / BFE-KSE) shall query Media Router for its internal state after a successful connection. This shall be done using any of the following SW-P-08 commands:

    • Crosspoint Interrogate Message (01)

    • Crosspoint Tally Dump Request Message (21)

ControlPanel - In this case the Media Router is treated by the ProBel controlling device as “a control panel” used to visualize the current state:

  • The Media Router salvo “PendingSalvo” is used for comparison.

  • ProBel CrosspointConnect (02) messages are sent to the Probel controlling device to notify any crosspoint changes.

  • Media Router shall query the client (like vsm / BFE-KSE) for its initial state after a successfull connection. This shall be done using the following SW-P-08 command:

    • Crosspoint Tally Dump Request Message (21)

Router

UpdateCurrentSalvoCrosspoints

If set will copy any changes to the Media Router “PendingSalvo” to the Media Router “CurrentSalvo”. This is normally used when Mode=”Router” and when it is desirable to treat the pending salvo as the current state.

False

DisableCrosspointChange

If set to true notification of crosspoint changes to the ProBel controlling device is disabled. Otherwise all crosspoint changes are forwarded to the controlling ProBel device according to the value of the Mode property

False

StateSalvo

Specifies the internal Media Router salvo used to track changes for ProBel responses. If set to empty string the internal Media Router salvo will be selected according to the value of the Mode property.

CurrentSalvo

SignalSalvoChangeDelay

Minimum delay between crosspoint messages from the ProBel controlling device for treating the messages to be part of the same salvo.

100 ms

DisableControllerStatusResponse

If set to true will disable any response to the SW-P-08 command: Dual Controller Status Request Message (08). Required when connected to vsm

False

DefaultSourcePort

Port used in Crosspoint Tally Dump Message (22) to denote a not connected destination outport.

-1

RestMediaRouterService

Enables the control of Media Router using Viz Mosart Media Router REST protocol.

Default url for Media Router REST commands is as follows:
http://[hostname]:[port]/MosartMediaRouter/Rest.svc/<command>?<params>

where:

  • hostname: Host name where the Media Router service is running

  • port: TCP/IP port for the Media Router REST service. Default: 8094

  • command: REST command to be processed

  • params: Optional parameters for the command.

The port may be changed via the MMediaRouterService.exe.config configuration file as part of the Media Router service installation.

Command

Description

clients

Retrieves information of all clients.

sources

Retrieves information of all sources.

inports

Retrieves information of all inports or inports connected to a given source

outports

Retrieves information of all outports or outports connected to a given client

salvos

Retrieves information of a single or multiple salvos

current

Retrieves information of the current state of the router

pending

Retrieves information of the pending state of the router

config

Retrieves information of the current or salvo specific configuration for a given client

crosspoints

Retrieves information of changed crosspoints from a given timestamp

setcrosspoint

Sets a specified crosspoint

setsalvo

Fires a specified salvo

status

Returns current Media Router status

For a complete list of REST commands see the Media Router REST Protocol.