Documentation Center

Service Host Administrator Guide

Version 1.4 | Published August 14, 2019 ©

Upgrading from Channel Recorder 1.0

The biggest difference between Channel Recorder versions 1.0 and Channel Recorder with Service Host 1.4 is that Service Host is now the front end controller. Starting with Channel Recorder version 1.1, Channel Recorder is considered a plugin of Service Host. This means that the Channel Recorder is managed by Service Host through the web interface that it provides. With Service Host you can:

  • Register a new instance.

  • Remove an existing instance.

  • Start an existing instance.

  • Stop an existing instance.

  • Provide an initial configuration to an instance.

For more information, refer to the Service Host documentation.

Matrox DSX.Utils

Channel Recorder with Service Host 1.4 requires Matrox DSX.utils version 10.1.020.24098.

Configuration File

For users upgrading from Channel Recorder 1.0, the only required step is the translation of the configuration into the new format. Previously, the configuration was provided via a simple text file located in %programdata%/vizrt/Channel Recorder.

This file might contain the following:

COMMAND_HANDLER PORT SET 6810
MAIN BOARD SELECT A523502
MVCP PORT 10000
CONFIG SET RINGBUFFERSIZE 60
MAIN CLOCKTYPE GENLOCK
MAIN CONNECTOR SELECT A
CONFIG SET FILEEXTENSION OFF
CONFIG SET PRIORITY REALTIME
CONFIG SET CLIP_ROOT D:/
CONFIG SET TIMEOUT 5000
CONFIG SET AUDIOCHANNELS 4
CONFIG SET CODEC XDCamHD
CONFIG SET CONTAINER XDCAMMXF
CONFIG SET TIMECODE TIME_OF_DAY
CONFIG SET TDIRENABLE FALSE
CONFIG SET VBI OFF

In Channel Recorder 1.3, the configuration is provided via an xml file located in %programdata%/vizrt/ServiceHost. The configuration file name is the Service Name used when registering the Channel Recorder instance. This xml file can be edited directly, however, it is highly recommended that you use the Service Host web interface.

Note: All configuration settings that were in 1.0 are still present with the same parameters and similar names.

You must use the Service Host web interface and configure Channel Recorder appropriately to achieve the same behavior as in the old version. Configuration is described in Channel Recorder Configuration.

Note: Do not forget to restart the instance after any changes to the configuration.

Log File

As with the configuration file, the log file is now located in %ProgramData%/vizrt/ServiceHost instead of %programdata%/vizrt/Channel Recorder.

The old file used to configure the logging mechanism is gone. The only option in the new version is to change the logging level. Refer to the Service Host Section in Channel Recorder Configuration.