HOW TO: Configure UniTrac Media Services (UMS)

Summary

This document describes how to configure the UniTrac Media Services (UMS) in UniTrac and Evolution.

Prerequisites

The following is needed before starting the configuration procedure.

• UniTrac 2.26.25 or later
• Evolution 1.1.39296 or later
• FFmpeg multimedia framework. This should be downloaded to the UniTrac server from the Internet (http://ffmpeg.zeranoe.com/builds/win32/shared/). UMS is known to function with version ffmpeg-20150615-git-5b0f55a-win32-shared.7z.
• A Super Admin user account must be created in the UniTrac Administration UI for authentication between Evolution and UniTrac.

DCS Configuration Procedure

This procedure describes how to configure the Device Container Web Service (DCS) components on a UniTrac server running version 2.26.25 or later.

On 32-bit Machines

• Locate the DCS web.config file under C:\Program Files (x86)\UniTrac\DCS\Web.config

On 64-bit Machines

• Locate the DCS web.config file under C:\Program Files\UniTrac\WebApps\DCS\Web.config

Configuration Procedure (UniTrac)

This procedure describes how to configure the UMS components on a UniTrac server running version 2.26.25 or later.

• Open the zipped .7z file using a program like 7-Zip or similar. Extract the contents to C:\Program Files (x86)\ffmpeg\.
• Ensure that the UMS service is configured with the correct path to the exe file by browsing to the UniTrac installation directory and opening CtiUmsSvc.exe.config. The value defined for the key “Transcoder\Path” should match the path to the ffmpeg.exe file, C:\Program Files (x86)\ffmpeg\bin\ffmpeg.exe as configured in step 1. The complete key should appear as follows:

<add key=”Transcoder\Path” value=”C:\Program Files (x86)\ffmpeg\bin\ffmpeg.exe” />

Additional configurable values are illustrated in Appendix A.

• Grant the UMS service account permission to read and write to the temporary folder. UMS

Configuration Procedure (Evolution)

Configure Evolution to Connect to UniTrac DCS

It is necessary to configure Evolution to connect to the UniTrac Device Container Web Service (DCS) when using UniTrac Media Services (UMS) for the display of device media within Evolution.

USE evo_dev

EXEC evo.p_Configuration#Updater @ConfigurationSection = N'Unitrac',@ConfigurationName = 'DCSEndPointUrl',@ConfigurationValue=N'https://192.168.100.100/DCS/DCS.svc',@ConfigurationUpdated='2015-10-15 16:59:02',@ConfigurationDeltaStatusUserID_LastUpdatedBy=1

USE evo_dev

EXEC evo.p_Configuration#Updater @ConfigurationSection = N'Unitrac',@ConfigurationName = 'DCSUsername',@ConfigurationValue=N'sadmin',@ConfigurationUpdated='2015-10-15 01:01:03',@ConfigurationDeltaStatusUserID_LastUpdatedBy=1

USE evo_dev

EXEC evo.p_Configuration#Updater @ConfigurationSection = N'Unitrac',@ConfigurationName = 'DCSPassword',@ConfigurationValue=N'password',@ConfigurationUpdated='2015-10-15 01:01:03',@ConfigurationDeltaStatusUserID_LastUpdatedBy=1

Configuring UMS Compatible Links

These procedures describe how to configure UMS-compatible links to utilize the UniTrac Media Services capability.

SM3K

Appendix A: UMS Configurable Values

The following table lists the configurable key values for the CtiUmsSvc.exe.config file. Each key is listed with its default value. The defaults are coded into the service and are not explicitly defined in the configuration file. Only add new values if you wish to modify a configuration from its default.

A new value can be added to the configuration by using the following format, replacing “Name” with the appropriate name from the table below, and replacing “newValue” with the new desired value for that setting.

<appSettings>

<add key=”Name” value=”newValue” />

</appSettings>