Avigilon Control Center 5 System Integration Guide

Transcription

1 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre INT-CARDAX-D-Rev1

2 Cpyright 2013 Avigiln. All rights reserved. N cpying, distributin, publicatin, mdificatin, r incrpratin f this dcument, in whle r part, is permitted withut the express written permissin f Avigiln. In the event f any permitted cpying, distributin, publicatin, mdificatin, r incrpratin f this dcument, n changes in r deletin f authr attributin, trademark legend, r cpyright ntice shall be made. N part f this dcument may be reprduced, stred in a retrieval system, published, used fr cmmercial explitatin, r transmitted, in any frm by any means, electrnic, mechanical, phtcpying, recrding, r therwise, withut the express written permissin f Avigiln. Gallagher and Gallagher Cmmand Centre are registered trademarks f Gallagher Grup, Limited. Avigiln has made every effrt t identify trademarked prperties and wners n this page. All brands and prduct names used in this dcument are fr identificatin purpses nly and may be trademarks r registered trademarks f their respective cmpanies. Avigiln Tel Fax Revised

3 Table f Cntents Intrductin Requirements Upgrading frm Avigiln Cntrl Center Fr Mre Infrmatin Installatin Server Client Cmputer Checking the Licence Basic Cnfiguratin Adding an Integratin User in Avigiln Gallagher DVR Cnfiguratin Trigger and Acknwledge Avigiln Alarms frm Gallagher Avigiln Alarm Cnfiguratin Cnfiguring Gallagher t Trigger and Acknwledge Avigiln Alarms Alarm mnitring in Avigiln Cntrl Center Client View Avigiln Image Data and Events in Gallagher.. 10 Cnfiguring Cameras Assigning Lgical IDs t Cameras Gallagher Camera Setup Testing the Cnnectin Viewing Live Vide and Cntrlling PTZ Cnfiguring and Viewing Recrded Vide Adding Avigiln Cameras t a Gallagher Actin Plan Assigning Actin Plans t Events in Gallagher Viewing Recrded Vide Cnfiguring Avigiln System Events in Gallagher Cnfiguring Actin Plans fr Avigiln Events Trubleshting Avigiln Gallagher Integratin Fails Avigiln Camera Will Nt Display Vide Appendix

4

5 Intrductin Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre The Avigiln Gallagher Integratin allws the Gallagher Cmmand Centre t utilize Avigiln surveillance technlgy. Integratin features include: Viewing live vide frm cameras cnnected t the Avigiln system and cntrl PTZ devices in the Gallagher Cmmand Centre sftware Viewing recrded vide in the Gallagher Cmmand Centre sftware Viewing events frm the Avigiln Cntrl Center in the Gallagher Cmmand Centre sftware Cntrlling Avigiln Cntrl Center alarms frm the Gallagher Cmmand Centre sftware Requirements Vendr Requirements Avigiln Cntrl Center Server Sftware 5.0 and later. Avigiln Avigiln 3rd party licence: ACC5-GLGR-CMNDC Avigiln Avigiln Gallagher integratin executable file AvigilnGallagher7.exe Gallagher Gallagher Cmmand Centre 7.0 r 7.1 The Avigiln Gallagher integratin file can be dwnladed frm the Avigiln website: Upgrading frm Avigiln Cntrl Center 4 If yu are upgrading t Avigiln Cntrl Center 5 and the latest versin f the Avigiln Gallagher integratin sftware, be aware that the Avigiln Cntrl Center uses a new default prt number (38880) fr server cmmunicatin. After yu install the Avigiln Cntrl Center 5 upgrade, yu must manually update the DVR prt number as described in Gallagher DVR Cnfiguratin n page 4. If yu had set a custm prt number, the system will cntinue t use the custm prt number. 1

6 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Fr Mre Infrmatin Fr mre detailed infrmatin abut the prcedures utlined in this guide, refer t the specific sftware dcumentatin. Avigiln Cntrl Center Client User Guide Avigiln Cntrl Center Server User Guide Gallagher Cmmand Centre User Classic User Guide Gallagher Cntrller API Develpers Guide 2

7 Installatin Server Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre 1. Install the Gallagher Cmmand Centre Server sftware. 2. Install the Gallagher Cntrller API (FTCAPI) n the Gallagher Cmmand Centre Server. a. Set the Gallagher Cntrller IP prt. Refer t the API Lcatin tpic in the Gallagher Cntrller API Develpers Guide. b. Verify that FTCAPI is installed crrectly by running the FTCAPI test harness. It shuld start with n errrs. 3. Install the Avigiln Gallagher integratin sftware (AvigilnGallagher7.exe). 4. Apply the Avigiln integratin license t ne f the Avigiln Cntrl Center 5 Servers in yur system. As yu cnfigure the integratin, all references t the Avigiln server needs t pint t this server. Client Cmputer Cmplete the fllwing steps fr all Gallagher Wrkstatins that require the Avigiln Gallagher integratin. 1. Install the Gallagher Cmmand Centre Wrkstatin sftware. 2. Install the Avigiln Gallagher integratin sftware (AvigilnGallagher7.exe). Checking the Licence After yu have installed all the required sftware, yu can check if the ACC5-GLGR-CMNDC licence has been prperly applied: NOTE: If yu have a multi-server Site, nly ne server needs t have the integratin license. 1. Open the Avigiln Cntrl Center Admin Tl. 2. Select the Settings tab and click Licensing. The License Activatin dialg bx appears. The dialg bx must say Integratin Cnnectins: Yes r the sftware was nt prperly licensed. 3

8 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Basic Cnfiguratin The basic cnfiguratin establishes the link between Avigiln servers and Gallagher servers. This allws the tw servers t cmmunicate. Adding an Integratin User in Avigiln T prtect the security f the Avigiln Cntrl Center Server, add a user t the Avigiln sftware specifically fr cnnecting t the integratin. See the Avigiln Cntrl Center Client User Guide fr details abut hw t add users. This user must have the fllwing permissins t enable all the integratin features: View Live Images Use PTZ Cntrls Lck PTZ Cntrls View Recrded Images The integratin username and passwrd is used t add Avigiln servers t the Gallagher Cmmand Centre. Gallagher DVR Cnfiguratin This cnfiguratin allws fr cmmunicatin between the Avigiln server and the Gallagher server. 1. In the Gallagher Cmmand Centre, pen the External Systems Master List Windw. 2. Right-click and select New > DVR System. The New DVR System Prperties dialg bx appears. 3. In the General tab, enter a name fr the Avigiln server. 4. In the Cnfiguratin tab, enter the server IP address, prt, username and passwrd used t access the Avigiln server. Use the username and passwrd yu created in the Adding an Integratin User in Avigiln prcedure. Use the frmat <Server Address:Prt>,<Username>,<Passwrd> 4

9 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Fr example: :38880,administratr,passwrd 5. Select the DVR Setup tab then cmplete the fllwing fields: Name/IP Address: enter the IP address fr the Avigiln server that is licensed fr the integratin. Username and Passwrd: enter the same username and passwrd that was used in the Cnfiguratin tab. In the Stred drp dwn list, select Avigiln Stred Vide. In the Live drp dwn list, select Avigiln Live Vide. 6. Select the API Setup tab. 5

10 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Cmplete the fllwing fields: Select a cntrller t assciate with the Avigiln server. In the Middleware PC Name/IP Address field, enter the name r IP address f the server that is running the FTCAPI. In the Identity area, give the Avigiln Site a Unique identity. 7. Select the Event Respnse tab then select an Alarm Zne fr all Events fr the server. 8. Click OK. 6

11 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Trigger and Acknwledge Avigiln Alarms frm Gallagher Create alarms in the Avigiln Cntrl Center Client sftware that can be managed by the Gallagher Cmmand Centre sftware. Avigiln Alarm Cnfiguratin Set up alarms in the Avigiln Cntrl Center Client befre yu cnfigure Gallagher t manage all the alarms. NOTE: The alarm name is case sensitive and must be unique t the server. 1. In the Avigiln Cntrl Center Client sftware, right-click the Site in the System Explrer and select Setup. 2. In the Setup tab, click Alarms. 3. On the Add Alarm dialg bx, click Add. 4. On the Select Alarm Trigger Surce page, select External Sftware Event frm the Alarm Trigger Surce drp dwn list and click Next. 5. On the Select Linked Cameras page, select the cameras t link t this alarm, and set the Pre-Alarm Recrd Time and the Recrding Duratin. Click Next. 6. Select the grups r users wh shuld receive alarm ntificatins, then click Next. 7. (Optinal) If yu wuld like t trigger an actin when an alarm is acknwledged, select the Activate selected digital utput(s) n alarm acknwledgement check bx. a. Select the digital utputs t be activated and specify the duratin. b. Select the Require user cnfirmatin befre activating digital utput check bx if users need t cnfirm the alarm befre the digital utput actin is initiated. c. Click Next. 8. Enter a Name fr the alarm and set the alarm Pririty. The alarm name is used t identify the alarm during the integratin. 9. Ensure the Enable Alarm check bx is selected and click Finish. 7

12 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Cnfiguring Gallagher t Trigger and Acknwledge Avigiln Alarms Cnfigure the Gallagher Cmmand Centre t manage Avigiln alarms. The Gallagher Cmmand Centre uses FTCAPI strings t send alarm triggers and acknwledgements t the Avigiln Cntrl Center. 1. In Gallagher Cmmand Center, pen the External Systems Master List Windw. 2. Right-click the camera assciated with an alarm and select Prperties. 3. Select the Trigger-Output tab. 4. Open the Hardware Master List Windw. 5. Frm the Hardware Master List Windw, drag the utput that will trigger the alarm int the Trigger Outputs tab in the Prperties dialg bx. Outputs can include magnetic lcks, alarm bells, r warning lights. A change in any f the utputs will send a FTCAPI string that can be used t trigger r acknwledge an Avigiln alarm. 6. Click OK. 7. In the Hardware Master List Windw, right-click the selected utput and select Prperties. 8

13 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre 8. Select the Messages tab. 9. In the FT Cntrller API strings area, enter the alarm trigger infrmatin in the On field in the fllwing frmat: alarmtrigger <Licensed Avigiln Server Address> <Alarm Name> Fr example: alarmtrigger burg alarm NOTE: The case sensitive alarm name is cnfigured in the Avigiln Cntrl Center Client. See Avigiln Alarm Cnfiguratin n page 7 fr mre infrmatin. 10. Yu have the ptin f adding an acknwledgement string in the Off field t autmatically acknwledge the alarm in the Avigiln system. Use the fllwing frmat: alarmack <icensed Avigiln Server Address> <Ack Permissin> <Alarm Name> Fr example: alarmack nrmal burg alarm NOTE: <Ack Permissin> can be set t nrmal, grant r deny. The grant and deny settings can nly be used when the alarm requires user cnfirmatin t activate a digital utput. See Avigiln Alarm Cnfiguratin n page 7 fr mre infrmatin. Alarm mnitring in Avigiln Cntrl Center Client All alarms cnfigured in the Avigiln Cntrl Center can be mnitred in the Avigiln Cntrl Center Client. See the Avigiln Cntrl Center Client User Guide fr mre infrmatin. 9

14 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre View Avigiln Image Data and Events in Gallagher Gallagher can be cnfigured t view live and recrded vide frm Avigiln cameras, and receive Avigiln events. Gallagher assciates recrded vide with specific alarms, s yu must cnfigure an actin plan in Gallagher befre yu can review recrded vide in Gallagher. Cnfiguring Cameras Befre Avigiln cameras can be viewed in the Gallagher Cmmand Centre, the cameras must be added t the Gallagher Cmmand Centre sftware. Cmplete the fllwing prcedures: Assigning Lgical IDs t Cameras In the Avigiln Cntrl Center Client sftware, assign a lgical ID t each camera. The Cmmand Centre sftware will nly detect cameras with a lgical ID. By default, cameras d nt have a lgical ID. 1. In the Avigiln Cntrl Center Client sftware, right-click a camera in the System Explrer and select Setup. 2. In the camera Setup tab, click General. 3. In the General settings dialg bx, enter a Lgical ID fr the camera. The lgical ID must be unique number. 10

15 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Gallagher Camera Setup 1. In the Gallagher Cmmand Centre, pen the External Systems Master List Windw. 2. Right-click the windw and select New > DVR System Camera. 3. In the General tab, name the Avigiln camera. 4. Select the Setup tab, and cmplete the fllwing fields: DVR System: select the Avigiln server the camera is cnnected t. Identificatin: enter the Lgical ID assigned t the camera in the Avigiln system. See Assigning Lgical IDs t Cameras n page 10 fr mre infrmatin. 5. Select the Event Respnse tab then select an Alarm Zne fr all Events fr the camera. 6. Click OK. Testing the Cnnectin Once the cameras and sftware have been cnfigured t supprt the integratin, test the cnnectin t cnfirm that the integratin was successful. In the Gallagher Cmmand Centre, perfrm the fllwing: In the External Systems Master List Windw, right-click an Avigiln camera and select Watch. If yu are able t watch live vide, the cnnectin was successful. 11

16 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre If yu are unable t watch live vide and a symbl appears ver the camera, the cnnectin was unsuccessful. Cnfirm the fllwing then test the cnnectin again: The camera is cnnected t the Avigiln Server it was assigned t in the Gallagher Camera Setup prcedure. The camera s lgical ID matches the Identificatin assigned t the camera during the Gallagher Camera Setup prcedure. The FTCAPI was installed prperly. The installatin and cnfiguratin prcedures were cmpleted in full. If the cnnectin cntinues t be unsuccessful, cntact Avigiln supprt at supprt@avigiln.cm. Viewing Live Vide and Cntrlling PTZ In the Gallagher Cmmand Centre, pen the External Systems Master List Windw, right-click a camera and select Watch. If the Avigiln camera is cnfigured fr pan, tilt, and zm (PTZ), the PTZ cntrls will autmatically appear when yu view live vide. 12

17 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Cnfiguring and Viewing Recrded Vide Yu can nly view recrded vide frm Avigiln cameras when the cameras are part f a Gallagher alarm. Gallagher alarms are generated frm events with an actin plan. Avigiln cameras must be added t an actin plan t becme part f a Gallagher alarm. Adding Avigiln Cameras t a Gallagher Actin Plan Create an actin plan t enable Avigiln cameras t recrd when a Gallagher alarm is triggered. 1. In the Gallagher Cmmand Centre, pen the Actin Plan Master List Windw and the External Systems Master List Windw. 2. Right-click the Actin Plan Master List Windw and select New > Actin Plan. 3. In the General tab, name the new actin plan. 4. Select ne f the fllwing tabs: Select the Armed tab if the actin plan is t be assciated with an Armed Alarm Zne. Select the Disarm tab if the actin plan is t be assciated with a Disarmed Alarm Zne. 5. In the Alarm Pririty drp dwn list, select an available alarm pririty. 6. Fr the Cameras, Macrs and External System Items bx, drag a camera frm the External Systems Master List Windw int the bx. 7. Click OK. Assigning Actin Plans t Events in Gallagher Once an actin plan has been created t include Avigiln cameras, the actin plan must be attached t an event t trigger alarms. 13

18 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre T assign an actin plan t an event in Gallagher, see the Gallagher Cmmand Centre Classic User Guide. Viewing Recrded Vide Once an alarm is triggered by an event that includes an Avigiln camera actin plan, recrded vide can be viewed. NOTE: If an alarm is deleted, the event cannt be viewed. 1. In the Gallagher Cmmand Center, pen the Alarm Viewer. 2. Right-click the alarm, then select View and select the camera. If the vide des nt display, the event may still be ccurring and the Avigiln server has nt finished recrding the event. Wait a few secnds then try again, r watch the live vide. If yu cannt lcate the alarm, use the Find Tl t lcate the recrded vide. Cnfiguring Avigiln System Events in Gallagher T mnitr Avigiln system events in Gallagher, yu must create three placehlder cameras t receive event infrmatin frm Avigiln. This allws yu t mnitr the health f the Avigiln Cntrl Center system in the Gallagher Cmmand Centre. Avigiln system events can include server errrs, database issues and lw strage availability. 1. In the Gallagher Cmmand Centre, pen the External Systems Master List Windw. 2. Right-click the windw and select New > DVR System Camera. 3. In the General tab, give the placehlder a name. 14

19 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre 4. Select the Setup tab, and cmplete the fllwing fields: DVR System: select the Avigiln Site yu want t receive system infrmatin frm. Identificatin: enter ne f the fllwing. Make sure the Identificatin is spelled exactly as listed r the system events will nt be received by the Gallagher sftware. ACC Server Events - fr Avigiln Cntrl Center Server events. ACC Database Events - fr vide indexing, vide metadata and cnfiguratin data related events. ACC Strage Events - fr netwrk vide recrder strage events. 5. Click OK. 6. Repeat this prcedure until yu have a placehlder fr each f the three event types. Each f the events are mapped t an External Event Grup ID in Gallagher. When an event ccurs, the Gallagher Cmmand Centre will respnd using the actin plan assigned t the event. T change the actin plan, see Cnfiguring Actin Plans fr Avigiln Events n page 15. Cnfiguring Actin Plans fr Avigiln Events Cnfigure an actin plan t respnd t events generated by the Avigiln system and cameras. 1. In the External System Master List Windw, right-click an Avigiln camera r placehlder and select Prperties. 2. In the DVR Camera Prperties dialg bx, select the Event Respnse tab. 15

20 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre 3. In the Event Grup list, select the External Event Grup yu want t edit. Fr a detailed list f the External Event Grup ID assigned t each Avigiln event, see Appendix n page In the Actin Plan fr External Event Grup drp dwn list, select an actin plan. If yu want t view the recrded vide fr a mtin event, select an actin plan that includes the Avigiln camera. See Adding Avigiln Cameras t a Gallagher Actin Plan n page 13 fr mre infrmatin. 5. In the Alarm Zne fr all Events drp dwn list, select an alarm zne fr this alarm. 6. Click OK. 16

21 Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre Trubleshting If the fllwing trubleshting slutins d nt reslve yur issue, cntact Avigiln Technical Supprt Avigiln Gallagher Integratin Fails After yu install the integratin, yu are able t add the Avigiln server and cameras but all the devices are displayed as ffline in the Gallagher sftware. When yu pen the Avigiln Cntrl Center Client sftware, the server and cameras are nline and functining. The issue may ccur if there is a prt cnflict between Gallagher Cmmand Centre and the Gallagher Cntrller API (FTCAPI). T reslve the issue, cmplete the fllwing steps: 1. Make sure the FTCAPI is installed n the Gallagher Cmmand Centre Server. 2. Set the Gallagher Cntrller IP prt. Refer t the API Lcatin tpic in the Gallagher Cntrller API Develpers Guide. 3. Verify that FTCAPI is installed crrectly by running the FTCAPI test harness. It shuld start with n errrs. When yu launch the Gallagher Cmmand Centre sftware again, the Avigiln server and cameras shuld be listed as nline. Avigiln Camera Will Nt Display Vide Yu are unable t watch live vide frm an Avigiln camera and a symbl is displayed ver the camera in the Gallagher sftware. When yu try t display live vide frm the same camera in the Avigiln Cntrl Center sftware, it displays crrectly. This issue ccurs if the integratin was unable t cnnect with the camera. Cnfirm the fllwing then test the cnnectin again: The camera is cnnected t the Avigiln Server it was assigned t in the Gallagher Camera Setup prcedure. The camera s lgical ID matches the Identificatin assigned t the camera during the Gallagher Camera Setup prcedure. The FTCAPI was installed prperly. The installatin and cnfiguratin prcedures were cmpleted in full. 17

22 Appendix Avigiln Cntrl Center 5 System Integratin Guide with Gallagher Cmmand Centre T change the way Gallagher handles each Avigiln event, change the actin plan assigned t the Gallagher External Event Grup ID. Fr mre infrmatin, see Assigning Actin Plans t Events in Gallagher n page 13. Avigiln Event Gallagher External Event Grup ID ACC Server Events Netwrk Interface Remved 9 Device Cnnectin Errr 7 Out f Resurces 6 Hardware Event 5 Server Terminated Unexpectedly 4 Server Stpped 3 License Expiry 2 ACC Database Events Database Lst 5 Database Envirnment and Databases Frcefully Deleted 4 Database Envirnment Deleted 3 Database Reindex 2 Database Envirnment Recvered 1 ACC Strage Events Vlume Failed 9 Image Vlume Initializatin 8 Writes Failed 7 Writes Blcked 6 Write Queue Full 5 Lw Disk Space 4 Device Specific Events Cmmunicatin Errr 9 Recrding Interrupted 8 Vide Signal Lst 7 N Camera Data 6 Mtin Started 5 Lst Frame Packets 4 License Plate Match 3 Firmware Upgrade Errr 2 18