Mosart Web Applications Guide

Version 1.6 | Published August 10, 2023 ©

Setup and Administration

This section describes setup and post-installation configurations, usually performed by a system administrator.

Before the NRCS operators can work with Viz Mosart templates using the Plugin, the system administrator must complete a one-time setup.

Setting up the NRCS Plugin

Perform all three procedures, Download, Installation and Configuration.

Download

  • Collect the latest software bundle from Vizrt's customer FTP at https://download.vizrt.com/
    by navigating to /
    products/VizMosart/Latest Version/WebApplications/.

Note: If upgrading, make sure an existing instance of the Mosart Web Applications Configuration Tool is not open.

Installation

The Mosart Web Applications bundle shall be installed on the Viz Mosart server.

  1. Run the downloaded file MosartWebApplications.Bundle-n.n.n.n.exe.
    images/download/thumbnails/120724460/installWA.png
    The web applications that will be installed are listed.

    Note: The Installer places two applications on the local machine

    1. Vizrt Mosart Web Applications

    2. Vizrt Mosart Web Applications Configuration Tool

  2. Click Install.
    Any previously installed versions of the Mosart Web Applications are automatically upgraded.

  3. After successful installation, a Mosart Web Applications Configuration Tool automatically displays.
    images/download/attachments/120724460/configStart.png

    Note: A desktop shortcut to Mosart Web Applications Configuration Tool is added by default.
    images/download/thumbnails/120724460/wacon.png

  4. Port settings (optional)
    Where security policies restrict ports firewall ports, these are the necessary port numbers for Mosart Web Applications:

    1. Web Apps REST API
      http: 55142.
      https: 55143.

    2. Remote Control Service (Used by the Timing Display and Rundown Viewer)
      http: 55167.
      https: 55168.

  5. Follow the Configuration section to continue setup.

Configuration

images/download/attachments/120724701/installNRCS.png

  1. If the warning CONFIGURATION REQUIRED appears in the NRCS Plugin panel, click Configure.
    Follow the guidelines below:

    Step

    Description

    (1) Template location

    Select whether your Viz Mosart templates are defined in a local file or on a separate database.
    images/download/attachments/120724701/template.png

    (2) Template access

    Local: Usually C:\channeltemplates\

    A check is made for existence at the stated destination, for all three files:

    • channeltemplates.xml

    • avconfig.xml

    • newsroomsettings.xml
      If all are found, a confirmation text Valid folder is displayed.
      Click Next.

      images/download/attachments/120724701/valid.png

    Database: URL (Host + DB name) and DB access credentials

    (3) NRCS type

    Select the NRCS system you are using.
    Supported systems are ENPS, iNEWS, Octopus.

    Any NRCS that can handle html plugins should work (select Other), but the above 3 are supported.

    images/download/attachments/120724701/NRCStype.png

    • mos id

    Mandatory field if you select NRCS type ENPS, Octopus or Other.
    (not used in iNews).

    To find yourMos ID

    1. In the Manus Administrator console, type SETTINGS.

    2. From the configuration panel that opens, look for MosId.

    3. The value is defined in the column to the right (in this example mosart.mos)

      images/download/attachments/120724701/MosId.PNG

    For more details, see the Viz Mosart Administrator Guide, section Manus Administrator > Settings Editor MOS > NRCS Configuration.

  2. Setup is complete and a confirmation menu summarizes your details.

    images/download/attachments/120724701/finishNRCS.png
  3. Click Finish.

Additional Server Settings

Web server hostname

At startup, the Configuration Tool attempts to autodetect the web server hostname and if successful, pre-populates the field.

For some setups, the Configuration Tool's web server pre-populated hostname will differ from the f ully qualified domain name (FQDN). For example, the hostname gets automatically pre-populated as web-apps, yet the FQDN is web-apps.example.com.

To enable network communication with Mosart Web Apps

You can enable other machines on the network to reach Mosart Web Apps .

  1. From the Configuration Tool menu bar, click the Settings (gear) icon.
    The Server Configuration menu appears.

    images/download/attachments/120724701/hostSettings.png
  2. In Web server hostname, enter the FQDN.

  3. Click Save.

Enabling HTTPS

The Web Applications suite optionally supports HTTPS authentication for the applications running under it, with a centralized interface to help with certificate configuration.

Note: Depending on the application, some additional configuration may be needed in the connected applications (for example Viz Mosart itself) to enable HTTPS communication.

Step 1 - Activate HTTPS in Mosart Web Applications

  1. Launch the Viz Mosart Web Applications Configuration Tool (a desktop shortcut is usually available by default).

  2. In the top right corner, select the Settings (gear) icon.
    The Server Configuration menu appears.

  3. Select Use HTTPS.

    Note: This selection turns on HTTPS for the NRCS Plugin, Mosart Timing Display and Rundown Viewer.

  4. Provide certificate, key and authentication details (consult with your IT department to obtain this).

    images/download/attachments/120724701/settings.png

  5. Click Save.

Step 2 - Turn HTTPS on in Mosart Remote Dispatcher Service

  1. Copy the file "C:\Program Files (x86)\Mosart Medialab\Mosart Server\ConfigurationFiles\RemoteDispatcherServiceConfig.xml" to "C:\ProgramData\Mosart Medialab\ConfigurationFiles".

  2. Fill in the following fields, using the same three values from the HTTPS Configuration menu shown above :

    • SignalRUseHttps: true

    • SignalRCertificatePath: <Certificate File entered above>

    • SignalRCertificateKeyPath: <Private Key entered above>

    • SignalRCertificatePassword: <Password entered above>
      images/download/attachments/120724701/image2022-7-25_13-0-41.png

  3. Restart the Remote Control Service.

Verifying the Installation

  1. After entering NRCS type above, clicking Next starts a background Windows service, Mosart REST API (a combination of the REST API and the NRCS Plugin).

  2. You can check that the NRCS Plugin is accessible by either:

    1. In the Configuration Tool, clicking Open.
      images/download/thumbnails/120724701/confifConfirmButton.png
      or

    2. following the URL next to the Copy button.
      images/download/thumbnails/120724701/configLink.png

      The Plugin URL comprises the machine name, port number 55142, NRCS type and (when supported) mos id in the form: http://machine-name:55142/plugin?nrcs={type}&mosid={mosid}

  3. To complete the integration, configure the NRCS side, according to the appropriate NRCS as described in section Integrating with an NRCS, where you will use the copied URL.

Troubleshooting

Web Apps Service reports as offline

At any time you can start the Mosart Web Applications Configuration Tool and check operating status.

A common error is when a Windows service has failed.

  • Try restarting the service with the Restart button.
    images/download/attachments/120724804/configRestart.png

  • You can also rewrite any previously entered values with the Reconfigure button.

Bypass the Mosart Web Applications Configuration Tool to access Web Apps

In failure situations, you can use your web browser to communicate with the Mosart Web Apps (instead of the Configuration Tool).

NRCS Plugin

  1. From the Configuration Tool, copy the NRCS link (click Copy).

    images/download/attachments/120724804/copyURL.png


    The URL has the form similar to: http://<your-hostname>:55142/plugin/?nrcs=ENPS&mosid=mosart

  2. Open you web browser and paste the URL in to see the NRCS Plugin.

Rundown Viewer

  • Edit the URL to: http://<your-hostname>:55142/rundown

Timing Display:

  • Edit the URL to: http://<your-hostname>:55142/timingdisplay/editor

Firewall Ports