The following is a system-to-system integration that requires an integration license and may require additional support than a standard SureView integration.
The configuration of the integration in SureView is simple and follows a standard set of functionality that is exposed by the SureView API and in this document. However these advanced systems have a wide variety of custom settings that can affect the performance of this integration. As such it’s important to budget for professional services from the SureView support team to assist in configuring your system to work with SureView and also to tailor the integration if needed to your unique custom setup. Please contact your sales representative for details about our professional services.
Integration Summary
What is Avigilon? It is a Video Management Software (VMS) system.
Integration Description: The Integration is an advanced system-to-system integration and is a VMS platform that allows a user to view live camera along with recorded camera footage, perform remote tasks such as relay activation/deactivation, perform audio communication and supports multiple alarm types. A variety of this functionality can be used via the SureView platform, Please see the features list for a full breakdown of this.
Supported Features
- Live Video
- PTZ
- Audio Transmit
- Get Config
Supported Avigilon Versions
- ACC Enterprise Edition with Avigilon Control Center Version 5.8, 6 or 7
- ACC Standard Edition with Avigilon Control Center Version 5.8, 6 or 7
Note: ACC Core Edition is not supported
Components and Communication
From |
To |
Port |
Use |
SureView Device Server |
Avigilon ACC Server(s) |
38880/38881 TCP |
Commands |
SureView Device Server |
Avigilon ACC Server(s) |
51000 UDP & TCP |
Video |
SureView Device Server |
cloudlink.sureviewops.com |
443 TCP |
Connection to SureView Ops |
SureView Device Server |
download.sureviewsystems.com |
443 TCP |
SureView Software Updates and install packages |
Prerequisites
SureView Device 'CloudLink' Server - Minimum Spec
- OS: Windows Server 2012 (or newer) Standard edition (or higher).
- CPU: 16GHz total
- RAM: 8GB total
- HDD: 100GB
- Type: Virtual or Physical (Virtual recommended to allow growth)
- Redundant Hardware: the PSUs, NICs, and HDDs of the physical server must be redundant
- Network Access: the following network access is required...
- To SureView Ops at "cloudlink.sureviewops.com:443"
- To the SureView installer in online mode: "download.sureviewsystems.com:443
SureView Device 'CloudLink' Server Setup
Your Ops device server will be configured by your SureView representative in a remote or guided session. Speak with them to arrange a time where this connection can be established.
Configuration
The following are the steps required to configured Avigilon to work with the Sureview.
Before you begin
Before you configure your Avigilon system to work with Sureview make sure you have the following:
- A fully licensed Avigilon ACC 'Control Center' server (see Supported Avigilon Versions)
- A configured SureView Device 'CloudLink' Server with
- "Avigilon V6" integration installed(if using Avigilon ACC6 or Avigilon ACC7)
- "Avigilon V6" integration installed (if using Avigilon ACC5)
- DirectX version 9 Intalled
- To install the needed DirectX version 9 use the following Installer. The installer downloads a 93 Mb file during install.
- If an Online Install If that is not an option, the full file can be downloaded separately for offline install
- Camera Streams set to H.264 - SureView Ops Ops only permits video encoded as H.264 to be streamed from cameras and video systems.
SureView Device Setup
Note: Avigilon is an advanced integration and must be configured using the using advanced "Device Setup" page and the "Device Configuration" feature.
Field | Value |
Title | The friendly name of the Avigilon Server you are connecting to |
Area | The Area/site that the Avigilon devices/cameras will be added to |
Type | Avigilon Control Center Version 6 or 7 Select "Avigilon V6" Avigilon Control Center Version 5 Select "Avigilon V5" |
Ops Link | The name of your connected SureView Device "Cloud Link" server |
Host | The local IP or Host address of the Genetec Directory Server where the Sureview Router service is installed (from the perspective of the SureView Device 'CloudLink' server |
Port | The Base Port of the ACC (See Troubleshooting) |
Username | The username used to log into the ACC client |
Password | The username used to log into the ACC client |
Device Indexes/Device Identifiers | The connection string for the Area, this will be automatically populated by the Get Configuration feature (So leave blank during initial setup) |
Troubleshooting
Camera Stream Issues
SureView Ops Ops only permits video encoded as H.264 to be streamed from cameras and video systems. Please ensure that the Avigilon Camera Streams are set to H.264 within the Avigilon Software.
If a different stream type has been selected it can cause unexpected issues within the SureView Camera stream such as a camera failing to stream any video or the camera stream staring but cutting out after a short time.
My device is using too much bandwidth
The Avigilon has been updated with optimized CPU usage on cloud servers, and this is achieved using built in Bandwidth Limitation. In order to manually set the limit for this, you will need to add the following config setting into the Sureview Device Service worker config file (Inside the Sureview install folder on the SureView Device 'CloudLink' Server , open "/DeviceServer/DeviceWorker.exe.config").<appSettings>
<!-- The value to restrict the bandwidth of Avigilon devices in bytes per second (Bps), 0 is unlimited, default or null is 1MBps -->
<add key="AvigilonBandwidth" value="131072" />
</appSettings>
If the value is set as '0' then the bandwidth will be unrestricted, however if this value is not included in the config file then the default value of 1 Megabit per second is used.
My ACC base port is incorrect
To discover your ACC servers base port, or to adjust it. Navigate to the machine/server hosting the ACC server. Open up the Avigilon Control Center 5 Admin Tool. Under the settings tab select Network. This will open up the Network dialog that will show what ports the ACC is using.
What camera resolutions are supported in the Integration by default?
By using the camera quality setting in Sureview you can request different camera quality from Avigilon. The following describes the corresponding resolution settings
Highest = 4CIF [704x576]
High = DCIF [528x384]
Medium = CIF [352 x288]
Low = SCIF [256x192]
Lowest = QCIF [176 x144]
Setting the video pixels against each quality setting
Inside the Device.Worker.exe.config (on the SureView Device 'CloudLink' Server) add a quality setting and pixel ratio for those you wish to override.
The key should bee added between <appSettings> and </appSettings>
Highest, High, Medium, Low, and Lowest are the available options. Only one override per quality settings.
Examples:
<add key="AvigilonV6_PixelQuality_HighestQualityPixel" value="1920x1080" />
<add key="AvigilonV6_PixelQuality_HighQualityPixel" value="1280x720" />
<add key="AvigilonV6_PixelQuality_LowestQualityPixel" value="180x100" />
The format above must be followed in order for the override to take place, otherwise the existing defaults will be used. The values added into value must be integers and be separated by a single 'x'.
Live view doesn't work with 'Failed to Initialise SDK....' error
Try the following to clear the error
- Make sure Direct X 9 or above is installed on the Sureview server that is running the integration
- Reboot the SureView Device 'CloudLink' Server
- Reinstall the Avigilon integration
Some device workers are not closing correctly
Update the device worker config (on the SureView Device 'CloudLink' Server) and add the following within the <runtime> section:
<legacyUnhandledExceptionPolicy enabled="1"/>
This ensures 3rd party errors don't prevent the device worker from closeing down cleanly.
Sureview is not playing live video from Avigilon ACC
In certain networking scenarios, especially when NAT is involved, the integration might need to be switched to a "WAN" mode where the network connection reverts to a more specific nature. This is configurable within the ExtraValue field by adding a "wan" option
Camera will not connect [Failed to login : ErrFailure]
- Verify that the Sureview user account is able to login and has sufficient privilege's. Note that Avigilon user names are case sensitive.
- Verify the version of Avigilon installed on SureView Device 'CLoudLink' Server and Selected Device Type in SureView
- Avigilon V5 - Supports Avigilon ACC5
- Avigilon V6 - Supports Avigilon ACC6 and ACC7
Comments
0 comments
Please sign in to leave a comment.