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.
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
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:
oThe SMS Server software
oThe 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.
oThe Avigilon Control Center Server software
oThe 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
oUse 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:
oAMAG SMS Server: enter the SMS Server IP address or hostname.
oAMAG SMS SDK User: enter the SMS username you created for the
integration. See Adding an Integration User in AMAG on page 4.
oAMAG SMS SDK Password: enter the password for the SMS user.
oSQL Server Instance: enter the IP address or hostname for the SMS
database.
oSQL Server Catalog: enter the name of the SMS server catalog. It
should be “multimax.”
oUse Integrated Security: select this check box if your SQL credentials
are the same as your Windows login.
oSQL Server User Name: enter your username for the SMS database.
oSQL 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...
+ hidden pages
You need points to download manuals.
1 point = 1 manual.
You can buy points or you can get point for every manual you upload.