Skip to main content

HOW TO: Configure Indigo Photo/Audio

Jerry Murray
  • Updated

PURPOSE

This document describes the server-side configuration steps necessary to enable the Indigo Photo/Audio functionality within Evolution.

DEFINITIONS

  • Indigo Photo/Audio (IPA) is a capability of UniTrac’s SM3K link with Corp Ten’s Indigo mobile application.
  • UMS references the UniTrac Media Services components that are responsible for handling media files.
  • DCS references the Device Container Web Service API that enables UniTrac to manage user access to UMS media objects.

REQUIREMENTS

  • An operational UniTrac server with the SM3K link service enabled.
  • An operational Evolution server.
  • Local Administrator access to the UniTrac and Evolution servers.
  • Sysadmin access to the Evolution database.
  • An Android or iPhone mobile device with Indigo installed and licensed for use with Photo/Audio capability.

PROCESS – UNITRAC

Configure User Accounts

IPA requires two UniTrac user accounts.

  • The default sadmin account must exist and it must be enabled with a valid password that meets server complexity requirements. This must be the default account as creating a new account with the same name will not work. If the default sadmin account has been deleted on your server, contact Tech Support.
  • An impersonation user account named EvoImpProxyUser must be created within the UniTrac user interface, and granted Super Admin

Note that depending on the security configuration of your UniTrac server, these accounts may expire periodically. This will cause IPA to stop working as expected. In the event that the accounts expire, use the Reset User feature for the account on the UniTrac Users page.

Install FFmpeg

IPA uses the free ffmpeg media converter.

  • Download the latest Windows version of ffmpeg for your operating system and install or extract on the UniTrac server. Note the path to exe after installation.
  • Open the exe.config file, located within the UniTrac installation directory.
  • Locate the <appSettings> section and the Transcoder/Path key Set this value to the full path of ffmpeg.exe. Example:

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

  • Save the config file before exiting.

Create Temp Folders

IPA stores temporary files in several areas on the Windows server while media is being processed. In a separated installation, these folders should be created on the Link & Web Services server.

  • Validate the configured identity for UniTrac services by launching the Services control panel and locating CtiUmsSvc. Note the value of the the LogOnAs In a typical installation this value is a local user account named UTServices however this can be configured differently during UniTrac installation. The rest of this instruction will reference UTServices however if your server is using a different service account, be sure to use that name instead.

       

  • Create a new folder on the C:\ drive named SM3KMediaTemp
    • Note that the name of this folder can be changed to anything you’d like, however the full path cannot have any spaces.
    • Modify the security properties of SM3KMediaTemp to add UTServices with Modify and Write permissions.
  • Create a new folder on the C:\ drive named UniTracMediaServices
    • Note that the name of this folder can be changed to anything you’d like. Spaces are permitted but we’ve omitted them for consistency.
    • Modify the security properties of UniTracMediaServices to add UTServices with Modify and Write permissions.

Update UniTrac Configurations

The relevant UniTrac services must be configured to point to the newly created directories.

  • Launch the Windows Registry Editor and browse to HKLM\SOFTWARE\UniTrac\UniTrac Services\CtiSM3KSvc. Locate the string value for MediaTemp and modify the value to set the path of your new temp folder.

                        

  • Open the DCS config file located within \UniTrac\WebApps\DCS.
  • Locate the <appSettings> section and the PATH key within. Set this value to the full path of the temp folder we just created. Be sure to include the trailing back slash. Example:

<add key="PATH" value="C:\UniTracMediaServices\"/>

  • Save the config file before exiting.

Update Firewall Settings

The Evolution server must be able to reach the UniTrac server over HTTPS (TCP 443). Update any hardware firewalls and the Windows software firewall as necessary.

PROCESS – EVOLUTION

Configure Database

Evolution must be configured to connect to the DCS web service endpoint on UniTrac and provided with the proper credentials.

  • Paste or transcribe the following SQL statement into a New Query editor window within SQL Server Management Studio on the Evolution database server.

 

USE evo_dev

UPDATE Configuration SET ConfigurationValue = 'https://<UniTracURL>/DCS/DCS.svc' WHERE ConfigurationName = 'DCSEndpointUrl'

UPDATE Configuration SET ConfigurationValue = 'EvoImpProxyUser' WHERE ConfigurationName = 'DCSUsername'

UPDATE Configuration SET ConfigurationValue = '<Proxy User Password>' WHERE ConfigurationName = 'DCSPassword'

  • Update the value for <UniTracURL> to match the internally accessible URL of your UniTrac server. Ensure that /DCS/DCS.svc remains appended to the end of the server URL, as this is the pointer to the service that Evolution must talk to.
  • Set the ConfigurationValue for DCSUsername to 'EvoImpProxyUser', or modify the username between the single quotes to match the new username that you created above.
  • Update the value for <Proxy User Password> to match the password set for EvoImpProxyUser above.
  • Once the noted modifications to the SQL statement are complete, execute the statement.

 

 

That concludes the necessary server configurations for Indigo Photo/Audio.

Related articles

Comments

0 comments

Article is closed for comments.