Milestone Event MIP Pluging Integration Guide

supported milestone xprotect editions & versions supported iris+™ products iris+ integration aligns with your milestone xprotect deployment to support your needs it supports using milestone xprotect express, milestone xprotect corporate, and milestone open network bridge deployment check supported integrations docid\ q zxxkugn4kw4rsxqygof for supported milestone xprotect versions support for milestone interconnect milestone interconnect is a central surveillance hub integrating smaller, remote milestone xprotect installations thus, it serves as a central site for video stream access integrated with the iris+ analytics solution, you can receive a centralized view of the iris+ alarms from dispersed milestone sites (individually integrated into iris+) in your milestone interconnect smart client tool for more details, refer to milestone documentation time synchronisation iris+™ provides time synchronization options supported as part of the milestone xprotect integration detected events in iris+™ can be synced to one of the following detected events synced to the iris+™ edge™ device time – syncs milestone xprotect cameras with the iris+™ edge™ device timing relevant for milestone xprotect when open network bridge is not deployed recommended detected events synced to the video stream time (when available) – supported for milestone open network bridge deployed cameras this method provides the best sync between iris+™ and milestone xprotect note for more information on the milestone open network bridge solution, refer to this documentation map cameras before you start the iris+™ milestone xprotect integration targets cameras (or the camera’s video streams) defined in milestone xprotect and maps them to iris+™ this mapping procedure means that the camera must be defined in iris+™ and that the camera’s id often named guid (globally unique identifier) in milestone xprotect is required to identify and link the camera in iris+™ in this way, the mip plugin can identify the source cameras and their detected events this procedure also supports milestone interconnect when retrieving the camera’s guid, make sure to do so for the relevant milestone interconnect version and tools retrieve camera id xprotect professional open "systeminfo xml" via a web browser here http //localhost//rcserver/systeminfo xml search for the camera name in the systeminfo xml file the camera guid is shown beneath the camera name copy the details and keep them for use later in the iris+™ portal perform the setup for all cameras that you wish to connect to iris+™ xprotect corporate, xprotect professional+ the camera guids are available in this file c \program files\milestone\mipplugins\iris+eventmonitoring\milestonecameras ini iris+™ portal open the iris+™ portal and find the relevant camera in the camera’s settings tab, click the edit button in the external id field, enter the camera id you retrieved for this camera in the xprotect management client this field is case sensitive so ensure the camera id is entered exactly as it was acquired from milestone xprotect for milestone interconnect deployment, enter the interconnect specific camera id in the external id field if this is being added as additional support on top of the milestone xprotect vms, then separate the two entries with a comma add the camera connection string in the "video stream source" under video source, for open network bridge deployment only, use the following uri format in the video stream source field rtsp //\[username] \[password]@\[hostname/ip] \[open network bridge rtsp port]/live/\[milestone camera id] to learn more, watch this milestone tutorial https //www youtube com/watch?v= lirbga2lok for open network bridge deployment only, ensure the sync time to stream toggle switch is enabled see image you can integrate iris+™ with two different milestone systems you will need to add the second guid to the cameras in iris+™ separated by a comma enable milestone integration in iris+™ portal before you start this section describes how to create an iris+™ service account and token in the iris+™ portal to later link to the milestone xprotect management client 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 the milestone xprotect mip plugin to iris+™ the iris+™ service account provides a token, which is the identifier used to link the account to the mip plugin if connecting multiple iris+™ accounts to a single milestone vms deployment, this procedure must be performed for each iris+™ account 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 “milestone 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 event monitoring mip plugin configuration) close the window install and configure iris+™ event monitoring mip plugin the integration of iris+™ and milestone xprotect, based on the milestone integration platform (mip), offers these benefits simple to configure it takes just a few steps to be able to receive events for any number of cameras and any number of analytics rules per camera you can view past events, navigate to a video recording of a specific event, and view analytics tracking for that event note to receive iris+™ events in milestone xprotect, make sure that all milestone xprotect event server machines and/or milestone xprotect management client machines have outbound tcp access to iris+ servers irisity io 443 (irisity hosted) or irisplus app 443 (on prem deployment) download and install iris+™ event monitoring mip plugin before you start install the iris+™ event monitoring mip plugin on all pc hosting milestone xprotect event server milestone client (management or smart client) milestone interconnect server and management applications note if an earlier version of the event monitoring mip plugin is already installed, install the new version on top of it (i e , upgrade) to install the iris+™ event monitoring mip plugin (or upgrade from a previous version), do the following close the milestone xprotect management client application download the latest plugin version from this page (1 0 0 140) run the iris+™ event monitoring mip plugin install wizard follow the instructions until the installation is complete initialize iris+™ in milestone xprotect management client the integration supports the following methods iris+™ core send analytic events and events overlay from iris+™ core to milestone xprotect send health events from iris+™ core to milestone xprotect iris+™ edge™ device send analytics events from iris+™ edge™ device to milestone xprotect the live overlay is available in milestone xprotect smart client when core is available events overlay is available in milestone xprotect smart client when core is not available events overlay is available in milestone xprotect smart client for 4 seconds before the event time notes 1 the purpose of this option (core not available) is to enable continued support of events transfer to milestone xprotect if the core is not available for short periods 2\ if the edge™ device is restarted for any reason while the core is not available, the connection to the cameras is lost the core must be available to renew a connection 3\ schedules for rules are updated in the edge™ device every 24 hours if the core is not available for more than 24 hours, the edge™ device stops generating events requirements for iris+™ edge™ device integration run milestone xprotect smart client as administrator in the properties / logon tab of the milestone xprotect event server service, select an administrator user external id changes changes in camera external id can be made in milestone xprotect and/or in iris+™ do the following change in milestone xprotect restart milestone xprotect event server service to review the change immediately or wait up to 15 minutes and the change will take effect change in iris+™ restart milestone xprotect event server service to review the change close and re open the milestone xprotect smart client following a change of integration type (iris+™ core / iris+™ edge™ device), restart the milestone xprotect event server service and close and re open the milestone xprotect smart client to initialize the integration, do the following 1\ open the milestone xprotect management client 2\ in the navigation tree, expand mip plug ins → iris+ event monitoring 3\ right click the iris+ event monitoring server and select add new note if connecting multiple iris+™ accounts to a single milestone vms deployment, perform this step and the following steps per iris+™ account 4\ the following iris+ event monitoring information window appears 5\ select the required integration method for core integration populate the following fields in the window name change as per your preference server url irisity hosted deployment https //api irisity io https //api irisity io customer hosted (on premise) deployment https //api irisity app token paste the iris+ token you saved as part of your service account mark the events you want to receive from iris+ analytics events health events all health events user defined health event note refer to the chapter configuring health events for a detailed description of how to configure health events, alarms, and actions in milestone xprotect client xprotect event server ip address enter the relevant ip address the remaining fields are not applicable example for edge integration populate only the name field in the iris+ event monitoring information window xprotect event server ip address enter the relevant ip address events integration port enter the relevant port once entered the value of the events integration uri field is automatically updated if you perform this configuration on the milestone xprotect event server, keep the events integration uri value to be used in the edge integration definition in iris+ (see next chapter) metadata integration port enter the relevant port once entered the value of the metadata integration uri field is automatically updated if you perform this configuration on the milestone xprotect event server, keep the metadata integration uri value to be used in the edge integration definition in iris+ (see next chapter) example 6\ if you are interested in sending event snapshots to milestone xprotect, mark this checkbox example 7\ exit the screen and select save when prompted 8\ ensure that analytics events are enabled in the xprotect management client by doing the following from the tools tab at the top, select options the options panel opens select the analytics events tab and ensure that the enabled field is checked enable edge™ device integration in iris+™ perform the following actions when integrating iris+™ to milestone xprotect using the edge integration option the integration targets in iris+™ are the system wide definitions required for iris+™ to integrate with milestone xprotect you will define the endpoints that can receive the events and metadata sent by iris+™ define integration targets in iris+™ to define the integration targets in iris+™, do the following log in to your iris+™ account from the top module bar, select settings select integration targets click the add button the integration target screen appears define the following events integration target name define a meaningful name such as milestone events ensure the toggle switch is enabled type keep the default value http method keep the default value post uri enter the same uri you have defined in the mip plugin installed on the milestone xprotect event server click save the integration target is defined and is listed in the integration targets list example metadata integration target name define a meaningful name such as milestone overlay ensure the toggle switch is enabled type set type value to ws method set method value to get uri enter the same uri you have defined in the mip plugin installed on the milestone xprotect event server click save the integration target is defined and is listed in the integration targets list example define edge™ device integrations in iris+™ the edge™ device integrations in iris+™ are the iris+™ edge specific definitions required for iris+™ to integrate with milestone xprotect perform the following for each edge™ device you want to integrate with milestone xprotect to define the edge™ device integration in iris+™, do the following log in to your iris+™ account select physical view select the iris+™ edge for which you want to define the integration select integrations click edit enable events integration and select the relevant integration target you have previously defined (in this example – milestone events) enable metadata integration and select the relevant integration target you have previously defined (in this example – milestone overlay) click save synchronize milestone xprotect management server time to iris+™ edge time before you start iris+™ supports time sync to the iris+™ edge™ device time the iris+™ edge™ device and the milestone xprotect management server time definitions must therefore be synchronized verify that the ntp (network time protocols) are synchronized on both servers note if your deployment is synced to the video stream time using the milestone open network bridge solution, disregard this section enable overlays to enable overlays in milestone xprotect smart client, do the following open milestone xprotect smart client select settings select iris+™ event monitoring enable the following fields as required show live overlay show playback overly configure default iris+™ event & alarm in milestone xprotect the default configuration described in this section allows for every event sent from iris+™ to be reported as an alarm in milestone xprotect smart client the triggering flow is define iris+™ xprotect analytics event to define an iris+™ xprotect analytics event, do the following 1\ from the xprotect management client site navigation tree, navigate to rules and events or in xprotect management application, events, and output and select analytics events 2\ right click analytics events and select add new 3\ in the properties section, for the name field, enter "iris+ event" define iris+™ alarm in milestone xprotect to define iris+™ alarm in milestone xprotect, do the following from the site navigation tree, expand alarms and select alarm data settings select the alarm list configuration tab ensure that at least the following are included in the selected columns • time • source • tag • message 4\ from the site navigation tree, expand alarms and select alarm definitions 5\ right click alarm definitions and click add new 6\ in the alarm definition information, enter the following • name iris+ alarm • triggering event choose analytics events in the first line followed by iris+ event in the second line • sources click select in the select sources screen that opens, open the servers tab, choose all cameras, and add it to the selected list example 7\ exit the screen and select save when prompted restart milestone xprotect event server service before you start for the configuration to take effect you must restart the milestone xprotect event server service on the relevant pcs configure and view alarms in milestone xprotect smart client before you start the following steps explain how to view the iris+™ alarms in the milestone xprotect smart client application to configure and view iris+™ alarms in milestone xprotect smart client, do the following open the milestone xprotect smart client application define a view, as follows select the live tab on the left hand side of the application window click the setup button on the right hand side of the application window define a new group using the new group icon right click the newly created group name and define a new view, for example, (1 + 2 ); make sure to select a view broad enough to contain the alarms list from system overview, drag the alarm list item to the broad part of your newly created view note you can change the order of the alarm list columns it is recommended to move the tag column to the right so that its value becomes visible since it contains an event description in system overview, expand the cameras list and drag the relevant cameras to the remaining views in the alarms list, note the tag column containing the analytics event description (e g , ‘vehicle moving in an area’) if the tag column is unavailable, right click the table header bar to add it if you are still unable to add it in conjunction with milestone xprotect corporate, refer to alarm data settings in xprotect management client described above event overlay setup to properly sync the overlay and alarm times, do the following open the milestone xprotect smart client select settings select alarm manager set the value of the start video playback to 8 seconds before the alarm triggering specific actions with milestone xprotect corporate before you start this section explains how to handle more advanced scenarios for triggering an action when an event occurs the capability is available in milestone xprotect corporate edition and is achieved by linking the analytics event to the xprotect user defined event and user defined rule the triggering flow is to configure iris+™ and milestone xprotect corporate for triggering actions, do the following in the iris+™ portal, select the relevant camera and then select the relevant detection rule define an external id for the rule; it will be used in the milestone xprotect configuration in the milestone xprotect management client navigation tree, select analytics events, right click, and select add new enter the name identical to the external id defined in iris+™ in this example code1 in the milestone xprotect management client navigation tree, select user defined events, right click, and select add user defined event enter a name for the new user defined event and save 3\ add a new alarm that links between the analytics event and the user defined event in the milestone xprotect management client navigation tree, select alarm definitions, right click, and select add new 4\ in the alarm definition information, enter the following name meaningful name triggering event select the analytics events defined in the previous steps (code1) sources click select; in the select sources screen that opens, open the servers tab, choose the camera/s, and add them to the selected list events triggered by alarm select the user defined event defined in the previous steps (myevent) 5\ finish the alarm definition exit the screen and select save when prompted 6\ after completing the steps above, restart the milestone xprotect event server service for the configuration to take effect example configuring health events this section explains how to configure health events in milestone xprotect there are two options to receive health events in milestone receive all health events this option enables receiving all iris+™ health events into a single (generic) health event type in milestone xprotect perform the following actions add a new analytics event in the milestone xprotect management client set the name to iris+ health event 3\ add a new alarm, which will be triggered by the iris+ health event 4\ in the alarm definition information, enter the following name iris+ health alarm triggering event choose analytics events in the upper list and iris+ health event in the lower list as shown sources click select; in the select sources window that opens, open the servers tab, choose all cameras, and add it to the selected list exit the screen and select save when prompted receive user defined health events this option enables receiving specific iris+™ health events according to user preference one or more of the following events can be set in milestone xprotect management client and associated alarms will be displayed in milestone xprotect smart client communication error camera error source error unsupported uri unsupported video codec description unsupported video codec, change the source stream configuration unsupported video resolution description unsupported video resolution, change the source stream configuration large time gap in the stream description large time gap in the stream, check the source stream critical framerate high framerate low framerate image blocked image dark image saturated suspended sensor description suspended (banned) sensor when it is detached from the appliance, the sensor configuration and rules still exist, the sensor is not connected to any appliance disabled sensor description the sensor is disabled by the user (or by arm/disarm command) inactive sensor description the sensor is not active due to user action (enable/disable, attach/detach) sensor active error description the sensor is enabled by the user, active, and in error state sensor active warning description the sensor is enabled by the user, active, and in a warning state onvif error description onvif error, contact irisity customer support onvif not reachable description onvif host not reachable, check the address and user\password rtsp authentication error description rtsp authentication error, check the user and password rtsp not reachable description rtsp host not reachable, check the host and port address and try toggling the multicast support setting rtsp stream issue description rtsp stream issue, try opening with vlc player rtsp timeout description rtsp timeout, try toggling the multicast support setting clip error description failed to download clip, check the path insufficient calibration description insufficient auto calibration the description of the health event will be displayed in the tag field of the alarm list in the milestone xprotect smart client it will be one of the supported user defined events listed above the example below shows adding a user defined health event add a new analytics event in the milestone xprotect management client the name must be set to one of the events listed above add a new user defined event in the milestone xprotect management client add a new alarm, linking the analytics event and the user defined event in the alarm definition information, enter the following (for this specific example) name communication error alarm triggering event choose analytics events in the upper list and communication error in the lower list as shown sources click select; in the select sources window that opens, open the servers tab, choose all cameras, and add it to the selected list events triggered by alarm select the user defined event added above communication error user defined event exit the screen and select save when prompted for both options new health events are displayed in the alarms list with new state names closed health events are displayed in the alarms list with closed state name double click on a health event to view additional details for the event display event snapshot in milestone xprotect smart client only applicable if send event image is enabled in the rule configuration of iris+™ if the send event analytics snapshot is checked, iris+™ sends event snapshots to milestone xprotect core integration receive event snapshot with an overlay from iris+™ and send to milestone xprotect event server edge integration receive event image and metadata from the iris+™ edge and after drawing the overlay on the received image, send the snapshot to milestone xprotect event server the snapshot is displayed on the right hand side of the event playback you can use the default for camera title bar setting in the milestone xprotect smart client to show or hide the camera’s title for grouping and occupancy rule types, the overlay for the snapshot and playback is drawn using the “common” overlay which contains all relevant individual event objects see the following example display iris+™ in milestone xprotect smart client once the iris+™ event monitoring mip plugin is installed, an iris+™ tab is available in the milestone xprotect smart client once selected, a login window is displayed log in to iris+™ using your credentials troubleshoot iris+™ event monitoring mip plugin integration problem corrective action milestone xprotect management client iris+™ is not displayed under the mip plugins node in milestone xprotect management client verify that the iris+™ event monitoring mip plugin is installed milestone xprotect management client verify that the milestone xprotect event server service is running milestone xprotect smart client there are no analytics alarms in milestone xprotect smart client milestone xprotect smart client there is no metadata (or only partial metadata appears) when playing back recorded video in smart client click the play button again in case it was not clicked the first time milestone xprotect smart client there are no alarms in the alarm list, the header is red, and it displays a message regarding user privileges in milestone xprotect smart client verify the user connected to the milestone xprotect smart client has sufficient user privileges, as follows in xprotect management client , check the properties of the user under advanced configuration > users milestone xprotect smart client all the above actions did not help; you are still unable to view analytics events in milestone xprotect follow the instructions under the corrective action column to the right, to obtain milestone mip log files milestone xprotect smart client there is no possibility of adding a tag column to the alarm list milestone xprotect smart client an error occurs when opening the milestone xprotect smart client on windows server 2008 the recorded video is not synchronized with object metadata overlays set up the same ntp endpoint on edge device, cameras, and milestone xprotect contact irisity support customer support technicalsupport\@irisity com mailto\ technicalsupport\@irisity com