VideoXpert Integration – Security Expert

User Guide

USER GUIDE
V1.4 | 12-Jan-18
Contents
1. Introduction .............................................................................................................................................. 3
2. Abbreviations ............................................................................................................................................ 3
3. Version Information .................................................................................................................................. 3
3.1. Integration Component Version ........................................................................................................ 3
3.2. VideoXpert Version ............................................................................................................................ 3
4. System Overview....................................................................................................................................... 3
5. Installation Manual ................................................................................................................................... 4
6. System Operations .................................................................................................................................... 4
6.1 System Start up ................................................................................................................................... 4
6.1.1. Check Integration service is running ........................................................................................... 4
6.1.2 Log-in to Security Expert Client ............................................................................................. 5
6.1.3 Setup Security Expert DVR Configuration ............................................................................. 5
6.1.4 Camera Setup ........................................................................................................................ 7
6.1.5 Setup the Status Page Editor................................................................................................. 9
6.1.6 Status Page View ................................................................................................................. 11
6.1.7 Setup Doors ......................................................................................................................... 12
6.1.8 View the Events in Status Page View .................................................................................. 13
6.1.9 Event Injection from Security Expert to VideoXpert ........................................................... 14
6.1.10 Event Injection from VideoXpert to Security Expert ........................................................... 19
7. System Configurations ............................................................................................................................ 21
8. Issues and Limitations ............................................................................................................................. 22
9. Troubleshooting Steps ............................................................................................................................ 22
10. References ............................................................................................................................................ 22
11. Appendix ............................................................................................................................................... 23
11.1. Working with legacy systems (Endura/DS) .................................................................................... 23
12. Support.................................................................................................................................................. 24

VideoXpert Integration – Security Expert 2 User Guide

1. Introduction
This document is the user guide for VideoXpert Integration with Security Expert. The objective of this
document is to provide information about the system usage, functions, configurations and known issues.

2. Abbreviations
# Abbreviation Definition
1 VMS Video Management System
2 VX VideoXpert
3 VxSDK VideoXpert Software Development Kit
4 PTZ Pan Tilt Zoom
Table 1: Abbreviations

3. Version Information
3.1. Integration Component Version
# Component Name Version Description
1 SecurityExpertVideoIntegrationInstaller- 2.1.0.0 Security Expert Integration with VideoXpert
2.1.0.0.exe Installer
Table 2: Integration Component Version

3.2. VideoXpert Version

# Component Name Version Remarks
1 VideoXpert Core 2.1.0.266 Nil
2 VideoXpert Media Gateway 2.1.0.964 Nil
3 VideoXpert Storage 2.1.0.1196 Nil
4 VideoXpert Ops Center Client 2.2.0.2392 Nil
Table 3: VideoXpert Version

4. System Overview
VideoXpert to Security Expert Integration enables the interaction between Security Expert and VideoXpert
systems. This VideoXpert integration brings in opportunity to end users by extending Security Expert
software’s Security surveillance capabilities using VideoXpert functionalities such as live and recorded
streaming, PTZ. VideoXpert provides live streams from various IP cameras that are placed at various places
in the building. This VideoXpert integration helps the end users to manage their complete building security
using Security Expert.

VideoXpert Integration – Security Expert 3 User Guide

 Figure 1: System Overview

5. Installation Manual
Refer VideoXpert Integration - Security Expert [Installation Manual].pdf

6. System Operations
Before installing “SecurityExpertVideoIntegrationInstaller-2.1.0.0.exe” make sure all the prerequisites are
installed.

6.1 System Start up

After the complete installation, add the VideoXpert in Security Expert and get camera list, live streaming,
archive streaming and PTZ operations by the following steps.

6.1.1. Check Integration service is running

1. Open the Services snap-in:
Go to “Run” command, Type services.msc and press Enter
2. Scroll down and locate Pelco Video Service Integration service from Services
3. Ensure that “Pelco Video Service Integration” has started automatically. If they haven't, right click
the service and select Start.

VideoXpert Integration – Security Expert 4 User Guide

 Figure 2: Pelco Video Service Integration in Services list

6.1.2 Log-in to Security Expert Client

Log-in to security expert with user credentials

Figure 3: Security Expert Login screen

6.1.3 Setup Security Expert DVR Configuration

1. DVR should be configured first, for that please select the menu MONITORING->SETUP->DVR

VideoXpert Integration – Security Expert 5 User Guide

 Figure 4: DVR configuration menu

2. Click on ADD and provide the DVR details.

Figure 5: DVR configuration setting

VideoXpert Integration – Security Expert 6 User Guide

 3. Select DVR type as custom and provide the below details
1. IP Address: IP Address of VX System
2. DVR Port: Port number of VX System
3. Service Port: Service port given during the Installation of Security Expert Integration
Installer.
4. Username: user name of VX System
5. Password: password of VX System

4. Click on SAVE after providing the DVR details.

6.1.4 Camera Setup

1. For configure the camera, please select the menu MONITORING->SETUP-
>CAMERA

Figure 6: Camera configuration Menu

2. Click on ADD and provide camera details.

VideoXpert Integration – Security Expert 7 User Guide

 Figure 7: Camera configuration settings

3. Select Type as DVR and choose the DVR given in the previous step from the drop down menu.
4. Then click on the button corresponding to DVR Camera Name to populate the camera list in the
DVR

Figure 8: Camera List

VideoXpert Integration – Security Expert 8 User Guide

 5. Select Camera from the list and click on SAVE.

6.1.5 Setup the Status Page Editor

Configure the status page in this section to display camera and event windows.

1. For configuring this view, select the Menu MONITORING->SETUP->STATUS PAGE EDITOR

Figure 9: Status Page Editor Menu

2. Click on ADD and then enter the Name for status page and choose the status page layout.

VideoXpert Integration – Security Expert 9 User Guide

 Figure 10: Status Page Editor Settings

3. Then click on OK.

4. Then choose the Record, Columns and Rows according to the Type and then SAVE.
Example: For setting camera stream in First row First column of Status Page view, we have set
Type as Camera, choose camera in Record, set column as 1, and set Rows as 1.

Figure 11: Status Page Editor setting sample

VideoXpert Integration – Security Expert 10 User Guide

 6.1.6 Status Page View
This will show the Camera Live stream and the event windows which configured in the previous step.

1. For viewing this view, select the Menu MONITORING->STATUS PAGE VIEW

Figure 12: Status Page View

2. PTZ Controls

The small arrow at the top right of the camera stream window shows the PTZ controls. User can
do Pan, Tilt and Zoom operations by clicking on the PTZ control buttons.

VideoXpert Integration – Security Expert 11 User Guide

 Figure 13: PTZ controls

6.1.7 Setup Doors

1. For setting up Doors in Security Expert, select PROGRAMMING->DOORS

Figure 14: Door settings

VideoXpert Integration – Security Expert 12 User Guide

 2. Click on ADD and provide Door details
3. Select a camera having recording as the Camera (Entry) or Camera (Exit) in the graphics tab.

6.1.8 View the Events in Status Page View

1. For viewing the Events, please select MONITORING->STATUS PAGE VIEW

The above step (mentioned in 5.1.8) will add an event in the event window in status page with a
yellow camera icon.

Figure 15: Status Page View- Events list

2. Right click on the event and select Camera (Archived). This will show the archive window
corresponding to the time of the event log.
3. Modify the date and time in Archive View Controls and click on Archive View button for
showing the Archive streaming

VideoXpert Integration – Security Expert 13 User Guide

 Figure 16: Status Page View- Camera archive

The archive window shows three stream windows

1. 5 seconds looping window
2. 30 seconds image slider window
3. Live View.

6.1.9 Event Injection from Security Expert to VideoXpert

1. Make sure that Security Expert SOAP Service is installed in Server. By default the Security Expert
SOAP Service port will be ‘8030’. If Security Expert SOAP Service port is changed during SOAP
service installation, the port should be updated in client endpoint address of the ‘C:\Program Files
(x86)\Pelco\Security Expert Integration\PelcoVideoComponent.exe.config’ config file.

Figure 17: SOAP Endpoint Address in Configuration file

VideoXpert Integration – Security Expert 14 User Guide

 2. Open C:\Program Files (x86)\Pelco\Security Expert Integration\ExternalEvents.xml file.
Then Add external events with name and event id as mentioned in ‘Security Expert Events
List.xlsx’ document to the ExternalEvents file.

Figure 18: External Events Configurations

3. Open Event Mapper short cut from Desk Top(In Security Expert Server Machine)

1. Click on Connect button to connect with VideoXpert and create situations.

Figure 19:: Event Mapper Configurations

2. Click on Properties button and change the Situation properties if any

3. Then Save

VideoXpert Integration – Security Expert 15 User Guide

 4. Restart the “Pelco Video Service Integration” service in Services List
5. Make sure to check ‘Monitor Events from this DVR/NVR’ during configuring DVR
to subscribe to events.

Figure 20: Setting for Monitor Events from this DVR/NVR

6. Restart Security Expert DVR B service in services.msc and wait for 1 minute before
starting Security Expert application.

Figure 21: Restart Security Expert DVR B service

7. Open Door Programming and modify the Door

VideoXpert Integration – Security Expert 16 User Guide

 Figure 22: Door Programming

8. Open Status Page View and see the door modified event

VideoXpert Integration – Security Expert 17 User Guide

 Figure 23: Status Page View

9. Open VideoXpert Admin portal and see the events from Security Expert

Figure 24: Security Expert Events listed in VideoXpert Admin portal

Note: Restart Pelco Video Service Integration first and then Restart Security Expert DVR Service B in
server if you make any changes to DVR List.

VideoXpert Integration – Security Expert 18 User Guide

 6.1.10 Event Injection from VideoXpert to Security Expert

1. Make sure that Security Expert v4.2.204.2 or higher is installed in server and client
machine.
2. Make sure that SecurityExpertVideoIntegrationInstaller is installed in server
machine.
3. Make sure to check ‘Monitor Events from this DVR/NVR’ during configuring DVR
to subscribe to events.

Figure 25: Setting for Monitor Events from this DVR/NVR

4. Restart Pelco Video Service Integration in services.msc

5. Restart Security Expert DVR Service B in services.msc and wait for 1 minute
before starting Security Expert application.

VideoXpert Integration – Security Expert 19 User Guide

 Figure 26: Restart Security Expert DVR B service

6. Events logged from VideoXpert can be viewed in client. Security Expert Event types
and VideoXpert situations are listed in the below table.

Security Expert Event Vx Situations

system/data_source_online
Online Event
system/device_online

system/data_source_offline
Offline Event
system/device_offline

Motion Detected Event analytic/motion

Motion Ceased Event analytic/no_motion

Camera Input Activated system/alarm_active

Temperature Event hardware/temperature

Storage Event hardware/volume_full

system/stream_loss
Diagnostic Event
system/stream_restored

Physical Offline Event hardware/input_loss

Physical Online Event hardware/input_restored

admin/device_modified

VideoXpert Integration – Security Expert 20 User Guide

 Property Changed Event admin/device_decommissioned

admin/device_commissioned

admin/device_assigned

admin/device_unassigned

All analytic events except motion and

Video Analytics Event
no motion

Table 4: Security Expert Event types and VideoXpert situations

Figure 27: VideoXpert Events Listed

Note: Restart Pelco Video Service Integration first and then Restart Security Expert DVR Service B in
server if you make any changes to DVR List.

7. System Configurations
Nil

VideoXpert Integration – Security Expert 21 User Guide

8. Issues and Limitations
 Unable to test the PTZ Command string functionality as it triggers from an event. For testing
events, it needs a simulator software.
 On Camera live window of Security Expert Software, PTZ controls are displayed as enabled for non
PTZ cameras also.
 Unable to test the events like Temperature, Storage, Diagnostic, Physical Offline, Physical Online
from VideoXpert to Security Expert as not possible to simulate those events.
 Unable to test in multi core or multi CMG setup due to network limitations.
 Randomly occurs crash on security expert server due to some memory issue in security expert
machine
Fails to install the Security expert Video Integration plugin in Windows Server 2012 R2 Standard
version in some case. Fundamental reason for this issue is the fact that the .Net Framework 4.6.1
is failed to install in some installations of Windows Server 2012. The root cause of which is related
to a Windows Update. The blocking error message is as below.
“The update corresponding to KB2919355 needs to be installed before you can install this
product on Windows 8.1 or Windows Server 2012 R2.”
This issue happens with some Windows Server 2012 deployments only. The workaround
identified for this issue is to manually deploy Windows Update.
The following windows patch files: KB2919355 & KB2919442 are installed as prerequisite. After
that installation of Microsoft .net framework 4.6.1 is successful and Security expert Video
Integration plugin is installed successfully.
 Fails to stream the live video automatically after changing the video configuration of camera. In
this case, we need to manually refresh the Status Page view for the stream update.
 Run-time error occurs in Security Expert on longevity testing in Security Expert server. It is due to
some memory issue and manually refreshing is the only solution for stream update.

9. Troubleshooting Steps
If any crash is occurring in the PelcoVideoComponent.exe, Restart Pelco Video Service Integration first
and then Restart Security Expert DVR Service B for running the application smoothly.

10. References
# Documents/Inputs Description
Technical and requirement analysis discussion
1 Discussions
between internal and external stakeholders
2 AN-187_Pelco_DVR_Integration.pdf.pdf Pelco DVR Integration manual
VideoXpert integration experience Learnings from the development and testing of
3
VideoXpert integration modules.
EcoStruxure Security Expert brochure.pdf Security Expert brochure for understanding about
4
it
SX-SRVR Operations Server-Client Installation Installation Guide of Security Expert.
5
Guide.pdf
6 SX-SRVR Operator Reference Manual.pdf Operator Manual of Security Expert.

VideoXpert Integration – Security Expert 22 User Guide

 GXVideoServerSDK for DVR.pdf Reference Manual of ProtegeGX Video Server SDK
7
Video Server
GXVideoSDK for Client Application.pdf Reference Manual of ProtegeGX Video Client SDK
8 Client Application

Table 5: References

11. Appendix
11.1. Working with legacy systems (Endura/DS)
This integration shall also deploy components to work integrated with legacy platforms such as
Endura/DS. The deployment shall by default configured to work with VideoXpert. Following pre-requisites
and configuration changes are required to get the integration work with legacy platforms.

Pre-requisite

 Pelco SDK 4.1.0 Windows vc12 – Download Link

Configuration Changes

Following configuration change has to be performed in PelcoVideoComponent.exe.config file (this file will
be available in the installation location).

1. Stop the “Pelco Video Service Integration” service in Services List

2. Open PelcoVideoComponent.exe.config file from “C:\Program Files
(x86)\Pelco\Security Expert Integration” location

Figure 28: Security Expert Integration Install location

3. Change the setting VideoRecorderMode value from Vx to PelcoSDK and Save

File.

Change “Vx” to
“PelcoSDK”

Figure 29: Configuration setting

VideoXpert Integration – Security Expert 23 User Guide

 4. Start the “Pelco Video Service Integration” service in Services List

12. Support
If the instructions provided fail to solve your problem, contact Pelco Product Support at 1-800-289-9100
(USA and Canada) or +1-559-292-1981 (international) for assistance.

VideoXpert Integration – Security Expert 24 User Guide

 REVISION HISTORY
Version Date Description Amended By Approved By
0.9 21-June-17 Initial Draft Shijeesh Channathodi Vijo Varghese
1.0 10-July-17 Updated Shijeesh Channathodi Vijo Varghese
1.1 14-July-17 Updated Shijeesh Channathodi Vijo Varghese
1.2 04-Aug-17 Updated Shijeesh Channathodi Vijo Varghese
1.3 28-Dec-17 Updated Shijeesh Channathodi Vijo Varghese
1.4 12-Jan-18 Updated Shijeesh Channathodi Vijo Varghese

VideoXpert Integration – Security Expert 25 User Guide

VideoXpert Integration – Security Expert 26 User Guide