Avigilon AMAG Symmetry 7 Integration User Manual

Avigilon Control Center 5 System Integration Guide
with AMAG Symmetry™ Security Management System 7.0
INT-AMAG-C-Rev2
© 2013 — 2014 Avigilon Corporation. All rights reserved. Unless expressly granted in writing, no license is granted with respect to any copyright, industrial design, trademark, patent or other intellectual property rights of Avigilon Corporation or its licensors.
AVIGILON, CAPTURE IT WITH CLARITY, HDSM, HIGH DEFINITION STREAM MANAGEMENT (HDSM), THE BEST EVIDENCE and LIGHTCATCHER are unregistered and/or registered trademarks of Avigilon Corporation in Canada and other jurisdictions worldwide. Other product names mentioned herein may be the unregistered and/or registered trademarks of their respective owners. ™ and ® are not used in association with each trademark in this document.
Avigilon Tel +1.604.629.5182 Fax +1.604.629.5183
http://www.avigilon.com
INT-AMAG-C: 2014-04-09
Revision: 2
Table of Contents
Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
What’s New . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
For More Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Upgrading the Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
From Avigilon Control Center 4 . . . . . . . . . . . . . . . . 2
From AMAG SMS 6.2 . . . . . . . . . . . . . . . . . . . . . . . . . 3
Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Client . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Adding an Integration User in AMAG . . . . . . . . . . . . . . . . . . . . 4
Adding an Integration User in Avigilon . . . . . . . . . . . . . . . . . . 4
Setting Up Gateway Alarms in Avigilon . . . . . . . . . . . . . . . . . . 4
Setting Up the Video Integration . . . . . . . . . . . . . . . . . . 5
Assigning Logical IDs to Cameras . . . . . . . . . . . . . . . . . . . . . . 5
Adding Avigilon Recorder and Cameras to SMS . . . . . . . . . .6
Avigilon AMAG Alarm Gateway . . . . . . . . . . . . . . . . . . . 7
Configuring Server Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Mapping Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Backing Up Mapped Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Restoring Mapped alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . .11
Using the Integration . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Monitoring Alarms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Monitoring Video . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Cannot Add Avigilon Cameras to SMS . . . . . . . . . . . . . . . . . . 12
Purged Avigilon Alarms Still Present in SMS . . . . . . . . . . . . . 13
Mapped Avigilon Alarms Displayed As Unknown . . . . . . . . 13
Cannot Save Changes in the Configuration Tool . . . . . . . . . 14
Avigilon Control Center 5 System Integration Guide with AMAG SMS

Introduction

The AMAG Symmetry™ Security Management System (SMS) and Avigilon Control Center software integration allows for the two systems to combine alarm monitoring abilities. The integration includes:
The Alarm Mapping Gateway software that enables alarms created in the Avigilon Control Center software to be mapped to specific device commands in the SMS software.
The Video Integration software that allows you to monitor Avigilon cameras in the SMS software.
Both parts of the integration can be used together or separately.

What’s New

Updated Alarm Mapping Gateway software for Avigilon Control Center 5
Improved alarm mapping workflow
Reduced downtime when updating alarm mappings

Requirements

Vendor Requirements
Avigilon Control Center Server Software 5.0 or later
Avigilon Avigilon Third Party Integration License:
Avigilon Avigilon AMAG software integration:
ACC5-AMAG-SMTRY
AmagSMSGateway70-5.0.2.30.exe
Installer includes:
Alarm Mapping Gateway software
Video Integration software The file can be downloaded at
http://avigilon.com/support-and-downloads/for-soft­ware/acc-integration-and-plug-in-downloads/
AMAG Symmetry SMS Server software 7.0.1
For the Alarm Mapping Gateway software only:
AMAG Symmetry XML Open Integration Module 7.0.1
1
Avigilon Control Center 5 System Integration Guide with AMAG SMS
AMAG SMS SDK License:
XML-DEV-KIT-V7.0.1
For the Video Integration software only:
AMAG SMS Video Integration License:
VID-CAM-xxx-V7

For More Information

For more detailed information about the procedures outlined in this guide, refer to the specific software documentation.
Avigilon Control Center Client User Guide
Avigilon Control Center Server User Guide
SMS Software User’s Guide
Security Management System Online Help

Installation

Upgrading the Integration

From Avigilon Control Center 4

If you are upgrading to this version of the Avigilon AMAG integration software, be aware that this version of the integration is only compatible with Avigilon Control Center 5.
NOTE: To preserve all of your current integration settings, you must upgrade to Avigilon
Control Center 5 and make sure all servers in the Site can be accessed by the integration. If a server is offline or inaccessible to the integration during the upgrade, the integration settings for that server are lost.
It is recommended that you back up a copy of all the alarm mappings before you upgrade the integration. The backup file for all previous versions of the integration software is called GatewayParams.xml. Be aware that the backup file from this version onwards is called it into the integration. For more information, see Backing Up Mapped Alarms on page 11.
AlarmConfig.xml. Make sure the backup file is labeled correctly when you import
2
Avigilon Control Center 5 System Integration Guide with AMAG SMS
NOTE: Avigilon Control Center 5 provides the ability to organize multiple servers into
Sites and share settings between servers. To use this feature effectively, you must upgrade all servers in your Site before upgrading the integration or all of the previous mappings may be lost.
When you upgrade the integration, the installer will shut down the integration Windows service. After the upgrade is complete, click Save and Apply in the Configuration Tool to use the updated configuration. To confirm that the integration has been configured correctly, see Avigilon AMAG Alarm Gateway on page 7.

From AMAG SMS 6.2

If you are upgrading the AMAG SMS software and the Video Integration software from version 6.2 to 7.0.1, uninstall the previous Avigilon Plugin and Alarm Mapping Gateway from Windows before installing the following updated software.

Server

1. Install the following on the same server:
o The SMS Server software
o The XML Open Integration Module is required if you are installing the
Avigilon AMAG Alarm Mapping Gateway software.
o (Optional) The Avigilon AMAG Video Integration software for viewing
Avigilon video in the SMS software.
o The Avigilon Control Center Server software
o The Avigilon AMAG Alarm Mapping Gateway software

Client

Install the following as needed:
Install the SMS Client software on the computers that require access to the SMS system.
Install the Avigilon Control Center Client software on the computers that require access to the Avigilon Control Center System.
3
Avigilon Control Center 5 System Integration Guide with AMAG SMS

Configuration

The Avigilon AMAG integration software is used to direct alarm communication and video streams between the Avigilon Control Center software and the SMS software. Configure the two applications to perform the integration features.

Adding an Integration User in AMAG

To give the integration software access to the AMAG system, you need to add a user with access to all the Company Groups that the integration will link to and a user with access to the SMS database or SQL Server. See the SMS Software User’s Guide for details about how to add users.
The integration software needs an SMS user and an SMS SQL Server user to connect to the SMS software.

Adding an Integration User in Avigilon

To protect the security of the Avigilon Control Center Server, add a user to the Avigilon software specifically for connecting to the integration. See the Avigilon Control Center Client User Guide for details about how to add users.
This user must have the following permissions to enable all the integration features:
View Live Images
o Use PTZ
View Recorded Images
This integration username and password is required to add Avigilon Servers to the integration.

Setting Up Gateway Alarms in Avigilon

Alarms are manually created in the Avigilon Control Center Client software. Create the Avigilon alarms you want mapped to the device commands in the SMS software.
1. In the Avigilon Control Center Client software, right-click the Site in the System
Explorer and select Setup.
2. In the Setup tab, click Alarms.
4
Avigilon Control Center 5 System Integration Guide with AMAG SMS
3. On the Add Alarm dialog box, click Add.
4. On the Select Alarm Trigger Source page, select External Software Event from the Alarm Trigger Source drop down list and click Next.
5. On the Select Linked Cameras page, select the cameras to link to this alarm, and set the Pre-Alarm Record Time and the Recording Duration. Click Next.
6. Select the groups or users who should receive alarm notifications, then click Next.
7. (Optional) If you would like to trigger an action when an alarm is acknowledged, select the Activate selected digital output(s) on alarm acknowledgement check box.
a. Select the digital outputs to be activated and specify the duration.
b. Select the Require user confirmation before activating digital output
check box if users need to confirm the alarm before the digital output action is initiated.
c. Click Next.
8. Enter a Name for the alarm and set the alarm Priority. The alarm name is used to identify the alarm during the integration.
9. Ensure the Enable Alarm check box is selected and click Finish.

Setting Up the Video Integration

Assigning Logical IDs to Cameras

In the Avigilon Control Center Client software, assign a logical ID to each camera. The SMS software will only detect cameras with a logical ID. By default, cameras do not have a logical ID.
1. In the Avigilon Control Center Client software, right-click a camera in the System Explorer and select Setup.
2. In the camera Setup tab, click General.
3. In the General dialog box, enter a Logical ID for the camera.
The logical ID must be unique number.
5
Avigilon Control Center 5 System Integration Guide with AMAG SMS

Adding Avigilon Recorder and Cameras to SMS

If you want to monitor Avigilon cameras in the SMS software, you must first add the Avigilon server and cameras to the SMS system.
1. In the SMS software, select the Install tab then click Digital Video.
2. In the Install Video & Audio dialog box, select Avigilon Recorder then click
New.
NOTE: The Avigilon Recorder option is only listed if you have the Avigilon AMAG Video
Integration installed on the SMS server.
3. Complete the following fields:
a. Video Server: enter a name for the Avigilon server.
b. IP Address: enter the server’s IP address
c. Login Credentials: enter the username and password you created in the
Avigilon Control Center Client software. For more information, see Adding an Integration User in AMAG on page 4.
4. Click Save. The new server is now listed as an Avigilon Recorder.
Repeat the previous steps until all the required Avigilon servers have been added. Be aware that you can only add a camera to the system after the connected server has been added to the system.
6
Avigilon Control Center 5 System Integration Guide with AMAG SMS
5. Once an Avigilon server has been added to the Avigilon Recorder list, the Avigilon Camera option is displayed in the Install - Video & Audio dialog box. Select Avigilon Camera then click New.
6. Complete the following fields:
a. Description: give the camera a name.
b. Video Recorder: select the server the camera is connected to.
c. Video Channel: select the camera you want to see in the SMS software.
NOTE: Only cameras with logical IDs are listed. For more information, see Assigning
Logical IDs to Cameras on page 5.
d. If you are adding a PTZ camera, enable the relevant PTZ controls.
7. Click Save. Repeat the previous steps until all the required cameras have been added.

Avigilon AMAG Alarm Gateway

The Avigilon AMAG Alarm Mapping Gateway is composed of two parts: the Gateway Windows service that runs automatically in the background, and the configuration
7
Avigilon Control Center 5 System Integration Guide with AMAG SMS
application that is used to configure the connection and alarm mappings between the AMAG and the Avigilon systems.

Configuring Server Settings

Configure the Alarm Mapping Gateway to access the two applications.
The configuration application remembers the server configuration, so you do not need to repeat this procedure if the settings remain the same.
After you install the integration software, the Configuration Tool automatically opens. To access it manually, select All Programs > Avigilon > Avigilon AMAG SMS Gateway > Configure Avigilon to AMAG SMS Gateway.
If you upgraded your integration and all the configurations were successfully imported, you will automatically see the Configuration Tool window. Click Configure Connections.
If this is a new installation, you will automatically see the Configure Connections dialog box. Click Add. a. In the following dialog box, enter the Avigilon Server IP Address, User
Name and Password, then click OK.
Use the username and password you created for the integration. See Adding an Integration User in Avigilon on page 4.
NOTE: If the Avigilon Control Center Server and the Avigilon AMAG Gateway Integration
are installed on the same server, set the server IP Address as 127.0.0.1 instead of the actual IP address.
8
Avigilon Control Center 5 System Integration Guide with AMAG SMS
1. In the Configure Connections dialog box, complete the following fields:
o AMAG SMS Server: enter the SMS Server IP address or hostname.
o AMAG SMS SDK User: enter the SMS username you created for the
integration. See Adding an Integration User in AMAG on page 4.
o AMAG SMS SDK Password: enter the password for the SMS user.
o SQL Server Instance: enter the IP address or hostname for the SMS
database.
o SQL Server Catalog: enter the name of the SMS server catalog. It
should be “multimax.”
o Use Integrated Security: select this check box if your SQL credentials
are the same as your Windows login.
o SQL Server User Name: enter your username for the SMS database.
o SQL Server Password: enter your password for the SMS database.
2. Click Connect to link the Avigilon Control Center and SMS software with the integration. A popup message appears to notified you that the connection is successful.
3. Click Done. The Configuration Tool window is displayed.
The integration searches both software systems for alarms that can be mapped together.
9
Avigilon Control Center 5 System Integration Guide with AMAG SMS

Mapping Alarms

In the Configuration Tool is a list of all the current alarm mappings, and all the available alarms from the Avigilon Control Center software and the SMS software.
If the Configuration Tool is not already open, select All Programs > Avigilon > Avigilon AMAG SMS Gateway > Configure Avigilon to AMAG SMS Gateway.
To map alarms together, complete the following steps:
1. In the AMAG SMS area, set the device commands that will trigger an SMS alarm for the integration.
The SMS software is pre-configured with a set of commands for the devices in your security system. For a detailed list of the available commands, see the Security Management System Online Help for more information.
a. In the Where drop down list, select the device that this alarm will link to.
b. In the What drop down list, select the command that triggers this alarm.
c. If there is a user or role that needs to be associated with the alarm, the
Who drop down list will auto-populate with the available options.
10
Avigilon Control Center 5 System Integration Guide with AMAG SMS
2. In the Avigilon area, select the alarm you want to map to. Listed here are the alarms you created in Setting Up Gateway Alarms in Avigilon on page 4.
3. Click >>.
4. Click Save.
5. Repeat the previous steps until all the required alarms have been mapped.
6. Once all the required alarms have been mapped, click Save and Apply. The Gateway Windows service is updated with all the new or changed mappings.

Backing Up Mapped Alarms

After you finish mapping all the alarms in the Configuration Tool, you can choose to back up a copy of the mappings.
If you are performing this procedure before upgrading the integration, be aware that in older versions of the integration the backup file is located in the same folder but is labeled
GatewayParams.xml.
1. Navigate to C:\Program Files\Avigilon\Avigilon AMAG Gateway\.
NOTE: The filepath may be different depending on how your system is configured.
2. Copy and paste the AlarmConfig.xml file to a back up location.

Restoring Mapped alarms

When you have a backup copy of the mapped alarms, you can restore the mapped alarms any time.
1. Locate your backup copy of the
If you are restoring a backup from a previous version of the integration, locate your backup copy of the GatewayParams.xml file.
2. Copy and paste the backup
Files\Avigilon\Avigilon AMAG Gateway\
If prompted, allow Windows to overwrite the copy that is currently in the folder.
3. Open the integration Configuration Tool. The restored mappings should be displayed in the Alarm Mappings list.
AlarmConfig.xml file.
AlarmConfig.xml file into the C:\Program
folder.
4. Click Save and Apply to update the Gateway Windows service and apply the alarm mapping changes.
11
Avigilon Control Center 5 System Integration Guide with AMAG SMS

Using the Integration

Monitoring Alarms

Once the alarms from AMAG and Avigilon Control Center have been mapped in the Alarm Mapping Gateway, you can begin to use the integration.
When an SMS alarm is triggered, it will activate the mapped Avigilon alarm and the configured alarm actions are started.
To monitor alarms in the SMS software, see the alarm monitoring section of the SMS Software User Manual.
To monitor alarms in the Avigilon Control Center software, see the alarms section of the Avigilon Control Center Client User Guide.

Monitoring Video

Once the video integration is set up in the SMS software, you can monitor video captured by Avigilon cameras in the SMS software. For more information about monitoring video, see the Digital Video management section of the SMS Software User Manual.

Troubleshooting

If the following troubleshooting solutions do not resolve your issue, contact Avigilon Technical Support – http://avigilon.com/support-and-downloads/

Cannot Add Avigilon Cameras to SMS

When you try to add Avigilon cameras to the SMS system, no cameras are listed in the Video Channel drop down list.
This occurs when the cameras in the Avigilon system do not have logical IDs. Only cameras with logical IDS are listed in the SMS software.
To assign a camera a logical ID, see Assigning Logical IDs to Cameras on page 5.
12
Avigilon Control Center 5 System Integration Guide with AMAG SMS

Purged Avigilon Alarms Still Present in SMS

After you have acknowledged an alarm in the Avigilon Control Center Client software, you click Purge to clear the Alarms list. However, when you access the SMS software, the purged alarm is still listed as a Blue alarm in the Alarms screen.
This occurs when a device that triggered the SMS alarm needs to be manually reset. For example, a window with a monitor point that has not been closed. The Avigilon Control Center software is able to acknowledge the SMS alarm but does not recognize that the device needs to be manually reset.
To clear the alarm from the SMS Alarms screen, manually reset the device then click Clear.

Mapped Avigilon Alarms Displayed As Unknown

Mapped Avigilon alarms in the Configuration Tool are labeled in red as “Unknown.” The Avigilon server that the integration is connected to displays an “Error” status in the Configure Connections dialog box.
This issue occurs if the Avigilon Control Center Server has rebooted or is offline.
Perform the following steps to ensure the integration functions correctly:
1. Check that the Avigilon Control Center Server is online and connected to the local network.
2. When the Avigilon Control Center Server is back online, open the Configuration Tool and click Configure Connections.
3. If the Avigilon Control Center Server is online, the server status would be “Ready.” If it is not, check the server connectivity again.
4. Close the Configure Connections dialog box. The Configuration Tool should now display the correct alarm names.
5. Click Save and Apply to ensure the alarm mappings are active.
13
Avigilon Control Center 5 System Integration Guide with AMAG SMS

Cannot Save Changes in the Configuration Tool

You are not able to save alarm mapping changes in the Configuration Tool and an error message is displayed. The issue did not occur during your first access to the Configuration Tool after the installation.
To workaround this issue, perform any of the following options:
Run the Configuration Tool as an administrator.
Disable User Account Control (UAC) in your Windows system.
14
Loading...