IRIS+™ VMS Gateway Integration Guide

this guide outlines how to deploy and configure the integration of iris+™ and genetec security center view which genetec security center versions are supported here supported integrations docid\ onjp8pl9p4ahzdpdyb4xp verify genetec certificate for new iris+™ customers iris+™ certificate genetec part number gsc 1sdk agentvi innovi certificate 2 connections are required open genetec security center config tool , in the main menu, select about, and select certificates verify your deployment has at least 2 innovi certificates the following example shows 10 innovi certificates enable genetec integration in iris+™ portal before you start these steps assume that your iris+™ account has been set up and that folders, devices, and cameras have been configured if that is not the case, first access iris+™ tutorials from the iris+™ support hub to configure your account in iris+™, a service account is required to later link genetec to the iris+™ account, if the core integration type is used ( described in section 5 2 ) the iris+™ service account provides a token, which is the identifier used to link the iris+™ account to genetec to generate an iris+™ service account token, perform the following browse to your iris+™ account, settings tab click the users tab click the + add button and select create service account enter a service account name such as “genetec integration” enter a description (optional) click create service account from the user's list, select the created service account user , click the arrow next to the name to expand the view, and select get token define token expiration if required (by default the token never expires) click get token and note the generated token (to be used in the iris+™ vms gateway configuration) close the window download integration components identify the genetec security center version installed at your deployment download files from version 5 12 https //irisityai my sharepoint com/\ u /g/personal/ariel petraro irisity com/eyor8bye2rxmtmjeb3rzaiobxgyosksdkvvj9mj 7rfmqa?e=3dusbb iris+ genetec integration for version 5 12 zip extract the following files genetec sdk security center v5 12 1 0 b1239 75 sdk exe iris+ vms gateway installer 2 0 0 195 iris+ genetec embedded plugin installer 1 0 0 18 install integration components perform the following steps to install the downloaded integration components the genetec sdk and the iris+™ vms gateway should be installed on a server able to connect to the genetec vms and iris+™ core api (either irisity hosted or customer hosted) this server can be either the genetec vms server or a dedicated separate server able to connect to the genetec vms genetec sdk install the genetec sdk for genetec version 5 12 run the file security center v5 12 1 0 b1239 75 sdk exe iris+™ vms gateway the iris+™ vms gateway is a windows service connecting the iris+™ to genetec, transferring the iris+™ generated events to genetec when installing the iris+™ vms gateway, or troubleshooting connectivity problems, it is important to understand that the iris+™ vms gateway can be both a client and a server, as follows the iris+™ vms gateway is a client of the genetec vms server when edge integration is deployed, the iris+™ vms gateway is a server to which iris+™ edge device/s, either customer hosted or irisity hosted, connect to push analytics events and/or metadata to the iris+™ vms gateway, via different ports the iris+™ vms gateway then delivers them to the genetec vms when installing the iris+™ vms gateway and entering its configuration settings, or when opening ports in the firewall of the servers hosting the iris+™ vms gateway and/or the vms server, it is important not to confuse the different functions and client/server incoming/outgoing call direction of the various ports and urls iris+™ vms gateway – for genetec security center 5 12 health events are supported only in genetec version 5 12 perform the following steps install the iris+™ vms gateway if a previous iris+™ vms gateway version is already installed, uninstall it select the relevant installer for the genetec version 5 12 run the iris+™ vms gateway installer file as administrator two options are available for the iris+™ vms gateway to integrate with the iris+™ application edge events and metadata for overlay are transferred from the iris+™ edge to genetec core events are transferred from the iris+™ core to genetec when the following window is displayed, populate the relevant fields vms settings (relevant for both core and edge integration options) vms type select genetec security center address ip address of the genetec vms port port to communicate with the genetec vms the default port is 5001 user username to log in to the genetec vms password password to log in to the genetec vms example integration settings define the integration type core or edge core integration receive analytics events from the core – check to set iris+™ url the default url (http //api irisplus ai) is for an irisity hosted deployment for a customer hosted deployment, replace this url with the applicable url assigned for your deployment, the default url is (http //api irisplus app) iris+™ account token core paste the token you have generated above receive health events from the core check to set check any of the four available health events and set relevant rule ids new error close error new warning close warning example edge integration receive analytics events and metadata from edge device check to set events port this is the iris+™ vms gateway port on the windows server the value is automatically populated with a default value and is editable events url the url field is read only and cannot be updated this is the ip address of the windows server on which the iris+™ vms gateway is being installed the value of the url is automatically populated keep the ip address to be used later when configuring an iris+™ integration target metadata port & metadata url same as the events fields above, used for overlay display click next to proceed with the installation until finished iris+™ vms gateway – continued if you are using a genetec savvi certificate, follow these steps run services msc to open the list of windows services stop the iris+™ vms gateway service in the folder c \program files (x86)\irisity ab\iris+ vms gateway\certificates remove the file iris+gateway service exe cert rename the file iris+gateway service savvi exe cert to iris+gateway service exe cert 4 start the iris+ vms gateway service once the installation is complete, the service is started the gateway service will then connect to the genetec vms to fetch the camera list follow these steps to verify that the iris+™ vms gateway service successfully communicates with the vms wait one minute to allow the service to communicate with the vms open the file "c \program files (x86)\irisity ab\iris+ vms gateway\logs\vmsgateway service xxxxx part" see if it contains a list of camera names fetched from the vms, or otherwise error notifications indicating a problem example possible errors wrong details were entered during the iris+™ vms gateway install (examples ip, port number, credentials) to change any of the required parameters, refer to the “updating configuration parameters of the integration” section below wrong or incomplete configuration of the vms server (license, firewall, configuration, cameras not yet added, some vms services are down, etc ) connection is successful; however, a functional failure of the gateway occurs due to the refusal or failure of the vms to correctly respond to the gateway verify the installed iris+™ vms gateway windows service has sufficient windows permissions if not, change the iris+™ vms gateway service settings to log on as a windows user with the necessary permissions restart the service and verify (in the log) that the iris+™ vms gateway service operates properly restart iris+ vms gateway if one of the following changes occurs a change in iris+ vms gateway settings a change in the genetec security center cameras list while the core integration type is used updating configuration parameters of the integration if you want to change any of the integration parameters following the installation, there is no need to uninstall and reinstall the iris+™ vms gateway a dedicated utility is available to update the parameters run the utility from the shortcut on the desktop of the machine you installed the iris+™ vms gateway it will open the settings of the iris+™ vms gateway service for updates, correct or change the settings as required, and click "apply" for the settings to take effect genetec embedded plugin install the iris+ genetec embedded plugin on any machine running the genetec security desk close the genetec security desk before installing the plugin define edge integrations in iris+™ the edge integrations in iris+™ are the iris+™ edge specific definitions required for iris+™ to integrate with genetec the integration targets in iris+™ are the system wide definitions required for iris+™ to integrate with genetec you will define the endpoints that can receive the events and metadata sent by the iris+™ edge to define the integration targets in iris+™, do the following log in to your iris+™ account from the top module bar, select settings 3\ select integration targets 4\ click the add button the integration target screen appears 5\ define the two integration targets as follows 6\ event integration define the following target name define a meaningful name such as genetec events ensure the toggle switch is enabled type keep default values http and post uri paste the uri of the events integration uri field in the iris+™ vms gateway installer if the gateway and the edge devices are not on the same lan, then you should replace the internal ip in the uri with the public ip of the gateway’s computer find the public ip by searching for a publicly available website with a free service providing this information the public ip address should be forwarded on the local firewall to the local gateway ip on port 8098 7\ click save the integration target is defined and is listed in the integration targets list 8\ metadata integration (for overlay display in genetec) define the following target name define a meaningful name such as genetec overlay ensure the toggle switch is enabled type change to ws and get uri paste the uri of the metadata integration uri field in the iris+ vms gateway installer if the gateway and the edge devices are not on the same lan, then you should replace the internal ip in the uri with the public ip of the gateway’s computer that ip can be found by searching "what is my ip" in google the public ip address should be forwarded on the local firewall to the local gateway ip on port 8099 9\ click save the integration target is defined and is listed in the integration targets list perform the following for each iris+™ edge you want to integrate with genetec to define the edge integration in iris+™, do the following log in to your iris+™ account select physical view 3\ select the iris+™ edge for which you want to define the integration 4\ select integrations 5\ click edit 6\ enable events integration and select the relevant integration target you previously defined (in this example – genetec events) 7\ enable metadata integration and select the relevant integration target you previously defined (in this example – genetec overlay) 8\ click save synchronize genetec server time to iris+™ edge time before you start iris+™ supports time sync to the iris+™ edge device time the iris+™ device and the genetec server time definitions must therefore be synchronized verify that the ntp (network time protocols) are synchronized to verify that the genetec server time is synchronized to iris+™ edge device time, do the following open the windows date and time panel and select internet time click the change settings button ensure the synchronization checkbox is enabled map cameras in genetec to iris+™ cameras in genetec security center are set up with two identifiers camera name and guid for iris+™ to recognize the cameras in genetec security center, the iris+™ vms gateway extracts the cameras’ names and guids to the following file c \program files (x86)\irisity ab\iris+ vms gateway\geneteccameras ini here is an example of the output file (3 cameras) perform the following in iris+™ for each camera requiring analytics, define the camera in iris+™ including the specific video url for this camera, and populate the external id (as displayed in the following window) with the relevant genetec camera guid manually set resolution for overlay non vendor "generic" rtsp cameras the problem to compute pixel coordinates of overlay rectangles in genetec, the iris+™ vms gateway must know the camera’s resolution however, in the case of generic rtsp streams, the genetec sdk does not provide resolution information a “generic stream” in genetec is a video unit for which the camera vendor is not specified, only the rtsp url to stream is provided in such case, in the genetec config tool, in the video unit’s properties, the “manufacturer “ field shows “generic stream” instead of “pelco”, axis” etc the solution manually provide the iris+™ vms gateway with the resolution of the stream in c \program files (x86)\irisity ab\iris+ vms gateway, open the geneteccameras ini and the genetecmanualresolutions ini files perform the following steps for each “generic stream” camera in the genetec config tool in tasks à video à archiver, expand to see the list of video units select the “generic stream” camera select the unit’s video camera click the video preview to start the preview video streaming wait for the streaming to start click on the “i” (information) icon to read the stream’s resolution (width x height measured in pixels)in the geneteccameras ini file, find the camera by its name (the part before the “=” delimiter) and copy its genetec camera id (the part after the “=” delimiter) in the file genetecmanualresolutions ini, in the \[resolutions] section, add a new line in the format cameraid=widthxheight, using the copied camera id from item 6 above and the width and height values from item 5 above save the updated genetecmanualresolutions ini file restart the iris+ vms gateway service example of genetecmanualresolutions ini file note to view rtsp generic streaming in iris+ portal, enable udp support when you add a specific video url for this camera trigger real time detection alarms in security center to enable alarms to be received in the genetec security desk define a genetec custom event for each iris+™ detection rule type you are deploying in your environment for example, if you are implementing moving in an area and crossing a line rule types, define two genetec custom events, each corresponding to a rule type it does not matter if the rule type is configured on single or multiple iris+™ sensors; in both cases, it is sufficient to define one custom event for this rule type define a genetec alarm for each iris+™ rule type that you are deploying in your environment following the above example, you need to define two alarms define genetec actions that cause each of the defined custom events to trigger its corresponding alarm in the steps below, a single detection rule type person moving is used as an example this process must be repeated for each rule type you implement to define a custom event log in to the security center config tool select tasks from the main menu 3\ select system 4\ select general settings 5\ select events > custom events 6\ to add an item click the '+' sign (circled red in the above screen) 7\ when prompted with the create dialog, define a meaningful name for the event that corresponds to the rule type also, capture the custom event id ('value' field) since you need to use this id in the iris+™ rule settings in this example, the value is 777 (can be set automatically by the application or defined by the user) 8\ click save and apply to define an alarm select tasks from the main menu select alarms 3\ add a new alarm (click the + alarm icon) 4\ enter the alarm name provide a meaningful name, e g , moving person detected, as it is later shown in genetec security desk when the alarm is received 5\ click apply 6\ select recipient(s) for the alarm add the security center's user (the login username) and click apply 7\ at the top bar, select properties 8\ in the video display option field, select live and playback 9\ in the play field, select 6 seconds 10\ in the content cycling 12 seconds 11\ click apply to link the custom event to an alarm select system > general settings select actions and click the + below the actions table to add an item the actions wizard pops up in the first line of the window above (“when ” “occurs”) open the list all events you created will be listed find the previously added custom event and select it in this example iris+ moving in an area in the action list, select trigger alarm open the alarms list and select the alarm defined earlier for the selected event in this example moving person detected click save to save the configuration changes link iris+™ and genetec security center events to link iris+™ analytics events with genetec security center custom event, select the rules tab for the relevant camera and define the same value (777) for the external id of the rule in iris+ click save to save the input view alarms in the genetec security desk this section shows how to view event alarms in the genetec security desk to view alarms log in to the security desk access tasks > operation > alarm monitoring to see the alarms list, and below it, the events from the related cameras to view alarm overlays the user has to have the privilege called “display video overlays”; it is enabled by default for admin users for regular users log in to the “config tool” application in user management and verify that “display video overlays” is enabled click the security desk tab in the security desk application; choose “options” and then the “display overlay video controls” option has to be enabled click “video” “default options” and verify “show overlays” is “on” right click camera overlays in the live video display and verify it is enabled display iris+™ in genetec security desk once the iris+™ genetec embedded plugin is installed, an iris+™ icon is added to the genetec security desk home screen click the iris+™ icon a login window is displayed in a new tab log in to iris+™ using your credentials the default uri is https //portal irisity io https //portal irisity io if the first login fails, a uri field pops up update the uri to match your deployment the updated uri is saved iris+™ portal is now available troubleshooting the logs for the iris+™ vms gateway service are available as follows iris+™ vms gateway service logs path c \program files (x86)\irisity ab\iris+ vms gateway\logs irisity customer support may ask for these logs for further troubleshooting to troubleshoot events properly created in iris+™ and transferred to genetec, you can add a clip to both iris+™ and genetec, simulating events if the genetec server is down or the web sdk role is either deactivated or does not exist, the service log will show the following message date & time \[145] error basevideoplugin videoplugin vms 1 is disconnected iris+ is not aware of the reason for the specific failure you will need to investigate the genetec side to determine the reason for the disconnect if you want to uninstall the iris+ vms gateway and reinstall it again, stop the iris+vms gateway service before uninstalling contact irisity support customer support technicalsupport\@irisity com mailto\ technicalsupport\@irisity com