Upgrading to a Version of Viz Mosart that includes Story Recorder

Story Recorder was introduced with Viz Mosart 5.0, so the first step will be to install the new software bundle.

1. Stop the service Mosart Logging Service.

2. Install the new software bundle taking into account the previous note regarding the installation order.

Enabling the Story Recorder Log Adapter

1. In the Manus Administrator console, type settings and verify that Logging > In use is set to True:
   

   

2. Check if you have the following two files in your working folder, Channeltemplates or ProgramData\Mosart Medialab\ConfigurationFiles\.
   If yes, go to the next step.
   If not, copy

   1. AsRunLogRepositoryConfig.xml

   2. LogAdapterStoryRecorderConfig.xml
      from C:\Program Files (x86)\Mosart Medialab\Mosart Server\ConfigurationFiles into your working folder.

3. Open AsRunLogRepositoryConfig.xml in an editor and add or uncomment the following line:

   <Adapter type="LogAdapterStoryRecorder" name="LogAdapterStoryRecorder" configuration="LogAdapterStoryRecorderConfig.xml" assembly="LogAdapterStoryRecorder.dll" />

4. Open LogAdapterStoryRecorderConfig.xml in an editor and configure the following settings:

   
   

   Setting	Description
   RemoteDispatcherHost	The host for service Mosart Remote Dispatcher (MosartRemoteControlService) is always local, running on the Mosart server machine. Default: localhost . No other value should be given.
   RemoteDispatcherPort	The port where the Mosart Remote Dispatcher service (MosartRemoteControlService) resides. This should be the same as configured in RemoteDispatcherServiceConfig.xml. Default: 8090 (locally on the Mosart server machine).
   BackupHost	The hostname of the Mosart backup server.
   BackupPort	The port for connecting to the Backup Story Recorder Adapter. This should be the same on both the main and backup Mosart machine. Default: 5001.
   EdlWatchFolder	Location of a shared folder to which Viz Mosart has access and monitored (watched) by your EDL transcoder. In the figure above, this folder is named EDL watch folder . This setting can not be empty and can be any shared network path where both Viz Mosart and the EDL transcoder have access (for example, \\somehostname\\EDL). The folder must have read and write permissions for the Mosart Server Logging Service. Viz Mosart does not clean up any files created in this folder. See more details in section Housekeeping.
   EdlLocalFolder	Location of a local folder where Viz Mosart drops the Story recorder EDL files. This folder is a secure 'backup' for the EdlWatchFolder. The EDL transcoding node does not have access to this folder, but if ever the EDL files fail to be generated in the EdlWatchFolder because of say, connection issues, the user can later manually copy the files to the EDL transcode node. The setting can not be empty and it must be a different location than the EdlWatchFolder (for example, C:\MMLogs\EDL or \\mosart_server_hostname\MMLogs\EDL). This folder must have read and write permissions for the Mosart Server Logging Service. Viz Mosart does not clean up any files created in this folder. See more details in section Housekeeping.
   StoryRecorderSnippetClipsFolder	When a retake of a story item is performed, a rendered snippet around the cut point will be placed in this folder shortly after the item was retaken. If this property is not configured or left empty, no snippet of the cut can be created. The location should be a network shared folder where the user running Mosart Server Logging Service has read and write access and the user running Mosart GUI has at least read access. (for example, \\somehostname\StoryRecorderSnippetClips) In the figure above, this is Snippet cut clips. To set up a snippet recorder see Enabling Snippet Generation at the Cut Point. Default: empty. This implies that a snippet recorder is optional.
   SnippetGenerationRequestDelay	How long in seconds after the retake process started, that generation of the snippet clip (from around the cut) shall begin. (The retake process is the last part from the following chain of actions : Show is paused → Pre-roll is taken on-air → Pre-roll auto-takes the item to be retaken). See section Story Recorder of the Viz Mosart User Guide). Default and minimum recommended: 15 seconds.
   SnippetLengthForEachRecording	The amount of time (in timecode format) from each recording to be included in the snippet clip. Default: 00:00:05:00 (5 seconds from each recorded clip).
   RecordingClipNamePrefix	Prefix added to the recording clips generated during a Story Recorder session using the configured video recorder. This is used by Viz Mosart to easily identify the recorded clips for housekeeping. (Only clip file names prefixed with this value will be subject to Viz Mosart housekeeping.) Default: SRVizrt.
   RecordingFolder	Location of the video server's file system folder where it stores recordings created by Story Recorder. In the figure above, this folder is named Harmonic Spectrum FS. (for example, \\somehost\fs0\clip.dir). This location is defined on the video server side. This folder must have read and write permissions for the user running Mosart Server Logging Service which performs housekeeping tasks.
   RecordingRetentionDays	Number of days to keep the recording clips (minimum 1 day) on the video server. An empty, zero or a negative value means the housekeeping of the intermediate recording files is disabled, there is no deletion of the intermediate files. If enabled, the housekeeping task is run every time Mosart Server Log Service is (re)started and keeps running at regular intervals defined by RecordingRetentionDays setting. Note that the recorded clips can be very large files easily filling the disk space. See also section Housekeeping. Default: 0 (disabled).
   PrerollTemplate	The name of the variant of the pre-roll template. This will be used to automatically create the pre-roll template in the current studio setup. Default: PREROLL. Note: If another package template with this same name exists on your system which was manually created, delete or rename it. The pre-roll template for Story Recorder must retain its default minimal characteristics and can not contain additional control parameters. This unique minimal template can be reused after an upgrade.
   MinPrerollDuration	The minimum and default preroll duration in seconds that the Preroll template will insert. This time needs to be sufficient for the video server to reset and be ready to record, after being paused. Typically 10-15 seconds. The preroll duration can be increased by the user in the Story Recorder UI, see Minimum Pre-Roll Duration. Default: 10.
   MaxPrerollDuration	The maximum preroll duration in seconds that the Preroll template will insert. (See MinPrerollDuration above.) Default: 30.

5. Any changes in the configurations above require a restart of the service Mosart Server Logging Service.

Configuring Video Server Settings for Playout and Recording

The video server is used for both playout of clips during the show and the recording of the story. Ports are configured for both dirty and clean recording.
These port settings on the video server depend on defined signal inputs and are not defined from Viz Mosart. To enable Story Recorder, some small changes must be made on the Viz Mosart side.

Enabling Snippet Generation at the Cut Point

This setup is optional and generates a few seconds (configurable) of verification video, intended to reveal the integrity of a fresh cut, after a story item has been paused and then retaken. This snippet creation employs Vizrt's versatile transcoder, Coder.

1. Download the most recent .exe version of Coder from the customer FTP, by navigating to
   /products/VizOne/Latest Versions/Individual Installers and Docs/Coder/Latest Version.

2. You need only install the Coder Worker .
   Install Coder on the same machine as the Viz Mosart Server. Coder's default installation location is in C:\Program Files\Vizrt\Coder.
   

   Note: If you install Coder anywhere but the default location, you must then update the following configuration, to specify the new path to the Coder executable, amlbatch.exe:
   
   
   This config file is C:\Program Files (x86)\Mosart Medialab\Mosart Server\CoderTools.dll.Config.

3. On the machine that runs the Viz Mosart GUI, define a default media player for *.mxf files (for example, VLC).

4. On the machine that hosts the Mosart server, in your working folder (ChannelTemplates or ProgramData), locate the file LogAdapterStoryRecorderConfig.xml.
   If not already set in step (4) earlier, provide values for:

   1. StoryRecorderSnippetClipsFolder

   2. SnippetGenerationRequestDelay

   3. SnippetLengthForEachRecording.

5. Restart both the

   1. Mosart Log Service (Windows Services menu)
      and

   2. Viz Mosart UI.

Managing Naming of the Final Clip Show

This step is optional. By default, naming of the show (and EDL files) is derived from the rundown name.

As a convenient option, you can instead provide a flexible and predictable naming scheme through a mapping field defined in the NRCS story.
Viz Mosart will then pick up this value and use it as the base for file naming, including the final show clip name. This is explained in Configure the NRCS and Viz Mosart for automatic naming of the Final Clip Show below.

In addition, the user can also manually enter a name for the show's final clip, in the Story Recorder UI. This will overwrite the value given in NRCS.

Pre-Roll Duration

The pre-roll period must be long enough for the video server hardware to reset itself and be ready to continue recording, after a pause.

Automatic Pause at Show End

As an option, you can automatically pause the show and recording.

Failover

This step is optional and it assumes that Viz Mosart is already set up with redundancy as described in section Redundancy.
This means that:

• Both the Viz Mosart main and backup server have same configurations for at least Mosart Administrator, AV Automation, Media Administrator and Overlay Graphics Interface.

• AV Automation is configured for mirroring on both main and backup servers (with main pointing to backup and main pointing to main):

• The Viz Mosart UI is configured to connect to the backup server:

For Story Recorder, there are additional steps:

• Story Recorder is configured on both main and back in the same way. For simplicity, once main has been configured for Story Recorder mode as describe in section Enabling the Story Recorder Log Adapter, copy AsRunLogRepositoryConfig.xml and LogAdapterStoryRecorderConfig.xml in your working folder from the backup server (Channeltemplates or ProgramData).

• Open LogAdapterStoryRecorderConfig.xml from Mosart main server in an editor and provide the hostname and port to the backup server (BackupHost and BackupPort) as described in Enabling the Story Recorder Log Adapter, step 4.

• Open LogAdapterStoryRecorderConfig.xml from Mosart backup server in an editor and provide the hostname and port to the main server (same BackupHost and BackupPort settings) as described in Enabling the Story Recorder Log Adapter, step 4.

• Both main and backup machines have Plura card installed and Viz Mosart configured to connect to Plura as described in Frame Accurate System Operations.

• (Optional) If Snippet generation around the cut point has been set up for main, this should be set up in the same way for backup. Install Viz Coder on both main and backup server.
  The snippet folder configured in LogAdapterStoryRecorderConfig.xml where the Viz Mosart UI has access, needs to be configured to be the same on main and backup.

• Same calibration settings from AV Automation: Devices > Properties > Genlock tab should be configured for main and backup.

Failure to Enable Story Recorder Session

When the user switches on SR in the UI, you see:

Check these scenarios, in this order:

• Viz Mosart Server and Mosart UI or Mosart Audio Player are on the same machine and the server was not installed last.
  If you installed the server before the UI or Mosart Audio Player, Mosart Log Service will incorrectly point to a copy of MMAsRunLogService.exe that is located in the Mosart UI or Mosart Audio Player folder installation. Instead, this should point to the MMAsRunLogService.exe located in Mosart Server installation folder:

To fix this, you should either stop the Mosart Log Service from Services and start it as console from Mosart Medialab\Mosart Server\ MMAsRunLogService.exe (although you will still have same problem after a machine restart) or re-install the applications in this order: first the UI/Mosart Audio Player and then Server.

After Mosart Log Service is started, enable SR again.

• Verify that the (new) Story Recorder Log Adapter, and the config LogAdapterStoryRecorderConfig.xml are setup according to section above, Enabling the Story Recorder Log Adapter, around step (3).

A common oversight is that someone forgot to un-comment the lines for Enabling the Story Recorder Log Adapter for Story Replay functionality in AsRunLogRepository.xml.


For additional help, refer to the general topic Troubleshooting Log Adapters.

• If the Viz Mosart UI is connected to a Mosart server on another machine, make sure there is no VirtualBox or similar configured on the Mosart server machine.
  

  

Recording Ports not Found

If when you switch on SR, you get errors about No recorders configured for Story Recorder, this indicates that the connection to the video server that performs the recorder is faulty.

• Ensure you set up Viz Mosart, with correct configuration settings selected, as explained above in To configure video server recorder ports for Story Recorder.

Even if the configured recording ports are enabled for Story Recorder as described above, you may also get this error message after switching to a different video server salvo.

After switching to a different salvo, perform the following steps:

1. Check that there are recorder port(s) configured and enabled for Story Recorder as explained above in To configure video server recorder ports for Story Recorder.

2. Restart AV Automation or force a reconnect to the new video server (use Ctrl+ Shift + V).
   This step should be done regardless whether the previous step was necessary or not.

Failure to Start Recording or Story Items not Recorded in Story Recorder Panel

Recording does not start and no story items appear in the Story Recorder panel.

• Verify in Viz Mosart Manus Administrator that logging is enabled:
  Open Media Administrator and type settings.
  

  

• On the machine hosting the Viz Mosart server, check that service Viz Mosart Logging Service is up and running (as service or console).
  If running as a service, verify that it points to MMAsRunLogService.exe from the Viz Mosart server installation folder.

• If the Viz Mosart Logging Service is restarted while other applications are running OK, then an action in the Viz Mosart UI (for example, reloading the rundown) must be performed to reestablish the connection to the Viz Mosart Logging Service.
  Until a Viz Mosart UI action is made, no events are logged in the AsRunLog for the first story item taken on-air.
  This leads to Story Recorder not functioning correctly. For example, recording may appear to start OK, but no story items show up in Story Recorder panel.

• If the Viz Mosart Logging Service is restarted when the Overlay Graphic Interface is being used for controlling the graphics systems, it must be restarted in order to re-establish the connection.
  Until the Overlay Graphic Interface is restarted, no graphic-related log events are logged in AsRunLog for the first graphic encountered in the rundown, meaning Story Recorder will be unable to backtrack the graphic.

  Note: After any Mosart Logging Service (re)start, as a rule of thumb, always restart AV Automation and the Overlay Graphics interface.

• Make sure Mosart Logging Service does not run both as service and console at the same time.
  To fix, stop both and then start either as a console or as a service.

Naming of Final Clip Show from NRCS not appearing in Story Recorder UI

You have set up your NRCS to provide Viz Mosart with a base naming for your final clip produced with Story Recorder, but the naming is not displayed in the Story Recorder panel.

Viz Mosart parses the MOS object corresponding to a story, and on the first primary story item found in the rundown it will add the show final clip show given in NRCS.

• Examine the underlying XML:
  Do Ctrl + Shift + Alt + double click in the Viz Mosart UI on the first story item in the rundown to open this window and verify if the value given from NRCS is present:
  

  

If this is not present, here are possible causes:

• The name is read from the first story in the NRCS rundown. Check the status of the first story.
  If for example it has been set to float, and is not displayed in Viz Mosart, you will need to add the name to whatever story in the NRCS is now the first story.

• If another story is Set As Next from Mosart UI, then you will need to add the name to this story in the NRCS which is now the first story.

• If the Show Final Clip name was changed in NRCS during a Story Recorder session, this will be taken into consideration only at the next Story Recorder session (disable Story Recorder mode and enable again for a new show).

Unreliable genlock. See more details in AV Automation status bar

If this warning is shown in the Story Recorder panel while running a show or in pause mode, this means that Viz Mosart detected problems in the configured clock source (refer to Frame Accurate System Operations) and automatically fell-back to the internal clock source.

The AV Automation status bar will also indicate that there is an issue with the selected clock source:

If the warning is shown infrequently, then the message can be safely ignored and the show can continue as planned.

Viz Mosart has a built-in safety mechanism which takes care of intermittent or lost external genlock and/or timecode signal (refer to section Genlock and Timecode Reliability in the topic Frame Accurate System Operations).

If the warning appears frequently or it is persistent, the genlock signal and/or timecode signal have become unreliable and must be fixed.

Genlock is not enabled

In the Story Recorder panel, this warning means the genlock has not be activated for Viz Mosart. Refer to topic Frame Accurate System Operations for details on how to activate Genlock mode.

Story Recorder can be used without having proper genlock setup and a timecode reader card installed on the Mosart Server machine, but only for testing. In this case, the time of the day will be used.

However, in order for Story Recorder to generate high quality final clip shows, frame accuracy is a requirement.

Retake position no longer valid. Please set retake point

• This is a user error, described in the Viz Mosart User Guide , under topic Story Recorder Mode.

Timeline can not be paused while pre-rolling

• This is a user error, described in the Viz Mosart User Guide , under topic Story Recorder Mode.