Information

• Manufacturer: Genetec (+1 514.332.4000)
• Product: Security Center
• Type: VMS

Supported Features

• Video
  • Live
    • Pass-Through
  • Recorded
    • Playback *1
    • Pre-Alarm *1
• Camera Control
  • PTZ
  • Presets
• Get Config
• Sync

*1 Playback and Pre-Alarm Recording are only available if your cameras are set to the "Continuous" record mode in Genetec so that there is recorded footage available for Sureview to fetch. If this mode cannot be used for any reason then there is an advanced configuration that allows Pre-Alarm Recording to be used but not Playback (see "External Configuration" section below)

Components and Communication

External Configuration

1) Sureview License installed

You must obtain the SureView part in order for our integration to connect to Genetec Security Center. The part number depends on your connection requirements, the options are:

• GSC-1SDK-SUREVIEW-SVS - This is for a single connection. You can choose multiple connections if you have a failover setup. Ideal for smaller, single server installations.
• GSC-SDK-SUREVIEW-SVS - This is for unlimited connections. Ideal for larger, multi-server installations.

The license part must be obtained from Genetec and applied to your Genetec Directory server.

2) Media Gateway role installed

You must install the Media Gateway role onto your Genetec Directory server and set it to listen on port 654. To do this:

1. In Config Tool go to "Video" then click to add an entity and choose "Media Gateway"
2. In the screen that appears give it a name then click Next and then Create to create it
3. After it is added, click it and view the "Properties" screen and ensure the port is set to 654

3) Cameras are set to record continuously

In order to be able to use the Playback and Pre-Alarm Recording features of the Sureview integration, all cameras in Genetec must be set to the "Continuous" record mode which ensures that it is recording footage for the time you may wish to view.

NOTE: if for some reason you cannot use the "Continuous" record mode and instead have to use either the "Manual" or "On motion / Manual" record modes then there is an advanced mode that can be enabled by SureView support staff whereby you have to create an Alarm in Genetec for each Camera with pre-recording set which the Sureview integration will then trigger when looking to fetch Pre-Alarm video. Note that this is not recommended as it is a custom feature and does NOT allow the use of Playback in Sureview (because without Continuous recording the Genetec is not recording all the time allowing you to just ask for recorded video from any time).

SureView support note: if using the advanced "alarm trigger" mode to get pre-alarm recording when not using Continuous recording you must:

1. Add the following setting to the SVDevices worker and Proxy worker configs to set the integration to trigger the alarm in Genetec when doing pre-recording: <add key="GenetecSCTriggerAlarmForPreRecord" value="true" />
2. Set that in the DB that the integration type does not support Playback (as without Continuous recording, there is no recorded footage at any time to be fetched)

4) Camera streams set up in Genetec

The quality changing of the Sureview integration interacts with the different streams in Genetec as follows:

• Selecting the "Lowest" or "Low" quality settings in Sureview requests the "Remote" stream in Genetec
• Selecting the "Medium" quality setting in Sureview requests the "Live" stream in Genetec
• Selecting the "High" or "Highest" quality settings in Sureview requests the "Recording" (Archiving) stream in Genetec

Ensure the streams are configured in Genetec appropriately for the video quality you wish to receive at each level.

5) User login for Sureview

You must have a username for Sureview to use (whether a Windows user linked to Active Directory or a Genetec user account) which ideally is a member of the "Administrators" group in Genetec or at the very least has the following permissions set:

• Application privileges:
  • Log on using the SDK = Allow
  • Federation = Allow
• Administrative privileges:
  • Logical entities:
    • View area properties = Allow
  • Physical entities:
    • View camera properties = Allow
  • Alarm management:
    • View alarm properties = Allow
• Task privileges:
  • Alarm management:
    • Alarm report = Allow
• Action privileges:
  • Cameras:
    • View live video = Allow
    • View playback = Allow

NOTE: If using the advanced "alarm triggering" option to allow pre-alarm recording explained above then the user MUST be a member of the Administrators group.

6) Server prepared for the Sureview Router to be installed

Before the Sureview Router service can be installed the following must be done on the Genetec Directory server:

1. A certificate must be added to the server and then applied to port 443 on your Genetec Directory server using "netsh http add sslcert ipport=0.0.0.0:443 ...". This certificate can be self-signed and does not have to come from a real certification authority.
2. The user account that the Sureview Router service will run as must be allowed to listen on port 443 using "netsh http all urlacl url=https://+:443/ ..." (see the "Service Account Domain User" support page for more info)

7) Sureview Router service installed

The Sureview "Genetec SC Router" service must be installed on your Genetec Directory server.

Important: The Genetec SC Router must be installed in the Genetec Security Center Root Directory.

This will depend on where Genetec Security Center has been installed but will normally have a file path similar to:

D:\Program Files\Genetec Security Center 5.8

The Genetec SC Router has the following configuration:

8) Ports 443 and 654 open from Sureview server

After installing the Genetec "Media Gateway" role and the Sureview "Genetec SC Router" service on the Genetec Directory server then you must be able to telnet to ports 443 and 654 on the Genetec Directory server from the Sureview Device servers (using an IPv4 address because the Genetec Media Gateway service currently does not support IPv6).

Sureview Configuration

Devices can either be added to Sureview via GetConfig or Sync (recommended as new cameras will be added to Sureview automatically whereas GetConfig can only be run once and will not be updated as new cameras are added).

The following information must be provided for the Device or Sync System in Sureview Setup:

*NOTE: when using Sync, after the first sync has run then the Sync entry will be updated to replace the Area name you specified with the internal identifier of that area inside Genetec. This allows you to rename the area as much as you like in Genetec without it affecting Sureview which will now be using the ID of the area rather than the name. 

Troubleshooting

Missing Recorded Video

Check in the Router logs - you will see:

• the text "Command received: CameraPlayback(CameraId=[camera guid], Start=[video start time], End=[video end time]) -> StreamId=[stream guid]" (do a text search for "CameraPlayback" to find it)
• and then lower down the text "VideoPlayer([same stream guid]) Start ended. Finished=[X], State=[Y], Took=[Z]s"

Whereby:

• If "Finished=False" then Genetec did not respond with recorded video within the timeout set in the VideoPlayerTimeout config setting - perhaps increase the timeout in the config and also ensure you are running at least Genetec 5.7 SP5 which fixes an issue they had with playback sometimes taking a long time to fetch.
• If "State=StartTimeDoesNotExist" then Genetec responded saying the requested time is not available - check that Genetec is set to record continuously
• If "StateChanged: Error" and/or  "Error details: Code=InitializationError, Details=Could not create a media component service" the Genetec Service may have an error. Restarting the Genetec Services and then the Router service should resolve. 
• If "Finished=True" and "State=GotGoodFrame" then the playback request succeeded within the timeout with "Took=[Z]s" showing you how long it took Genetec to respond with the requested recorded video

License Exceeded Errors

Your Genetec license needs to support as many connections as you wish to use. You can see how many things are connected by opening Genetec's Config Tool program, going to "System status", selecting "Applications" from the drop-down, and looking for which servers have SDK connections open.

SVGenetecSCRouter throws Windows Event Log Exceptions

Application: SVGenetecSCRouter.exe
Framework Version: v4.0.30319
Description: The process was termianted due to an unhandled exception.
Exception Info: System.Xml.XmlException

This can happen if the Genect SC Router has been installed into the wrong root directory. 

The Sureview "Genetec SC Router" service must be installed on your Genetec Directory server into the Genetec Security Center Root Directory.

This will depend on where Genetec Security Center has been installed but will normally have a file path similar to:

D:\Program Files\Genetec Security Center 5.8

 Action 'CameraStartLive()' failed: No processable streams found.

Action 'CameraStartLive()' failed: No processable streams found.

If this error is seen when trying to start  a Genetec camera then it may mean that you need to set usestreamanalysis=true in the Extra Value (if you have used Get Config or Sync it might be set to usestreamanalysis=false)