Mosart NRCS Plugin Guide

Version 1.4 | Published August 05, 2022 ©

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. These three procedures are all performed on your viz Mosart Server machine.

Download

Installation

  1. Install the NRCS Plugin by running the Mosart Web Applications installer
    MosartWebApplications.Bundle-n.n.n.n.exe.
    images/download/thumbnails/92976699/installWA.png

  2. The web applications that will be installed are listed.
    Click Install.
    Any previous versions of the bundled Mosart Web Applications are automatically deleted from the local machine.

  3. After successful installation, the Mosart Web Applications Configuration Tool automatically displays.

    Note: After successful installation, a desktop shortcut provides access to a configuration assistant.
    images/download/thumbnails/92976699/wacon.png

Configuration

  1. Open the Configuration Tool, a dashboard presents current installations and their status.

    images/download/attachments/92976699/openMenu.png



  2. 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/92976699/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/92976699/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/92976699/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/92976699/MosId.PNG

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

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

    images/download/attachments/92976699/configConfirm.png

Enabling HTTPS

Step 1 - Turn HTTPS on in Mosart Web Applications

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

  2. In the top right corner, switch on the HTTPS switch.

  3. Provide certificate and key details (consult with your IT department to obtain this).
    images/download/attachments/92976699/image2022-7-25_12-56-30.png

    Note: This selection also turn on HTTPS for the Mosart Timing Display Guide.

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:\ChannelTemplates.

  2. Fill in the following fields:

    • SignalRUseHttps: true

    • SignalRCertificatePath: <path_to_the_server.crt_created_above>

    • SignalRCertificateKeyPath: <path_to_the_server.key_created_above>

    • SignalRCertificatePassword: <the_passphrase_used_above>

  3. Restart the Remote Panel service

    images/download/attachments/92976699/image2022-7-25_13-0-41.png

Verifying the Installation

  1. After entering NRCS type, 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/92976699/confifConfirmButton.png
      or

    2. following the URL next to the Copy button.
      images/download/thumbnails/92976699/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

At any time you can start the Viz 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.
    images/download/attachments/92976699/configRestart.png

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