IBM Intelligent Video Analytics Version IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide IBM

Transcription

1 IBM Intelligent Video Analytics Version IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide IBM

2

3 IBM Intelligent Video Analytics Version IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide IBM

4 Note Before you use this information and the product it supports, read the information in Notices on page 25. This edition applies to IBM Intelligent Video Analytics ersion 1, release 6, modification 1. This edition applies to all subsequent releases and modifications until otherwise indicated in new editions. Copyright IBM Corporation US Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

5 Contents Chapter 1. Integrating IBM Intelligent Video Analytics with Cisco VSM Chapter 2. Installation oeriew Chapter 3. Obtaining and preparing the integration files Chapter 4. Installing the Cisco VSM 7 DSF on the SSE serer Chapter 5. Installing the Cisco VSM 7 VMS extension on MILS Installing and registering the Cisco VSM 7 web components Configuring the VMS serer, cameras, and channels 14 Chapter 6. Configuring the IBM Intelligent Video Analytics clients Unblocking the dynamic link libraries Using the sample application and test tools to troubleshoot integration issues Finding cameras and their characteristics Obtaining the resolution of the camera Retrieing the UIDs of cameras from the Cisco VSMC Finding cameras by using the CiscoCamDiscoery.html tool Testing the DSF by using the SampleGrabber tool 22 Troubleshooting issues with GraphEdit Troubleshooting issues with camera connection.. 23 Notices Additional notices Trademarks Chapter 7. Troubleshooting information and tools Known problems Copyright IBM Corp iii

6 i IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

7 Chapter 1. Integrating IBM Intelligent Video Analytics with Cisco VSM IBM Intelligent Video Analytics (IBM IVA) ersion can be integrated with Cisco Video Sureillance Manager ersion 7.6. Integration components must be installed on both the Middleware for Large Scale Sureillance and the Smart Sureillance Engine (SSE) serers. The IBM IVA Integration Plug-in for Cisco VSM 7.6 that is on the MILS serer, the Cisco SDK, and the prerequisite open source files proide the required media for installing and configuring the integration. You must also ensure that you install the requisite fixes for the leel of IBM Intelligent Video Analytics that you hae installed. This guide proides the detailed instructions for completing the integration. DirectShow Filter The IBM DirectShow Filter (DSF) that is included in the extension files is specifically supported for Cisco VSM ersion 7.6 together with the Cisco VSM SDK V7.6. Additionally, support proided by the DirectShow Filter for Cisco VSM 7 can be summarized as follows: Plays only H.264 ideo codec Supports frame rate reduction, for example: &framerate=10 Supports secondary streams though a URL extension, for example: &stream=3fefd41f-891b-4d3b-bf47-55d _s2 Does not support downsizing, downsizing can be accomplished separately by the camera or encoder. Copyright IBM Corp

8 2 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

9 Chapter 2. Installation oeriew To integrate IBM Intelligent Video Analytics V1.6.1 with Cisco Video Sureillance Manager 7.6, complete the integration preparation and the installation steps in the order that is specified. Procedure 1. Install your Intelligent Video Analytics V1.6.1 system, erify that your system meets the minimum system requirements and is deployed correctly. For more information, go to IBM Knowledge Center for Intelligent Video Analytics. 2. Obtain and prepare the files and directories that are required for the integration. 3. Install the Cisco DSF on all Intelligent Video Analytics SSE serers in your enironment. 4. Optional: Install the Cisco VSM V7.6 sample application and testing tools that are proided in the DSF package. 5. Install the Cisco web player application on the Intelligent Video Analytics MILS serer. Important: If your Cisco VSM is running on a irtual machine, the integrated ideo player that is embedded into the Intelligent Video Analytics operator client does not function as expected, due to the use of special ideo acceleration APIs. For more information about this limitation, contact Cisco directly. The MILS and SSE components of Intelligent Video Analytics are fully supported to run on irtual machines, as outlined in the ix and the detailed system requirements information. 6. Prepare the Intelligent Video Analytics administrator and operator clients. Copyright IBM Corp

10 4 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

11 Chapter 3. Obtaining and preparing the integration files Obtain and prepare the files that are required to complete the integration. Some of the integration files are proided in the Cisco VSM installation directory on the MILS serer. Other files must be downloaded from external sources. About this task The following table summarizes the integration files that are required to complete the integration: File set IBM Intelligent Video Analytics V1.6.1 interim fix PO06066 Description If you hae installed Intelligent Video Analytics V ; install the extra fix, IVA-PO06066.zip. Download this fix from IBM Fix Central and install according to the instructions in the readme file contained in the package. IBM IVA Integration Plug-in for Cisco VSM 7.6 The IBM IVA Integration Plug-in for Cisco VSM 7.6 installation package, CiscoVSM7_DSF_Filter_V1_2.zip, is located on the MILS serer and proides the required files to start the integration. This directory contains the MILS web player and the DirectShow Filter. Some sample applications and testing tools are also proided in the Utilities subdirectory of the package folder. Cisco VSM 7.6 SDK Open source LieProxy and other integration files Cisco DirectShow files Microsoft Visual C++ updates The Cisco VSM 7.6 SDK contains seeral files that are required to complete the integration. Download the specified SDK ersion from the Cisco website. A set of open source dll files must be downloaded and installed on the SSE serers. Additional DirectShow files must be downloaded and installed on the SSE serers. The x86 ersion of the Microsoft Visual C++ updates must be correctly applied to all SSE serers. Complete the following procedure to obtain and prepare the required integration files that are described in the preious table. Important: When you download files on a Microsoft Windows system, some files are flagged as untrusted, and might need to be unblocked before you can moe them to the specified location. You must check eery file that you download, including files that are extracted from a compressed file, to ensure that all files are unblocked, otherwise, the integration might fail. For detailed steps about how to unblock a file, see Unblocking the dynamic link libraries on page 19 in the Troubleshooting section at the end of this guide. Procedure 1. Copy the Cisco VSM DSF installation package (CiscoVSM7_DSF_Filter_V1_2.zip) from the MILS serer to a temporary location on the SSE serer. You can find the CiscoVSM7_DSF_Filter_V1_2.zip compressed file in the following directory on the MILS serer:../httpserer/htdocs/milsng/ms/ciscovsm7/build/ Complete the remaining steps in this procedure on the SSE serer. 2. Download the Cisco VSM V7.6 SDK and prepare the required files, as follows: Copyright IBM Corp

12 a. Go to b. Scroll down the page to locate VSM 7.6 SDK, and download the SDK. c. Extract the contents of the VSM7.6SDK_with_V2_0_wsdl.zip file to a temporary location on a local drie on your workstation. d. Unblock (if necessary) and copy the following two DLL files from the temporary location on your workstation to a temporary location on eery SSE serer:..\vsm7.6sdk_with_v2_0_wsdl\websericesdlls\vsomwebserice2.dll..\vsm7.6sdk_with_v2_0_wsdl\websericesdlls\vsomwebserice2.xmlserializers.dll 3. Download and prepare the required open source integration files. a. To download the Version1.0.0.zip file, go to download/1.0.0/version1.0.0.zip. b. Extract the contents of the Version1.0.0.zip file to a temporary location on a local drie on your workstation. c. Unblock (if necessary) and copy the following LieProxy and prerequisite files from the temporary location on your workstation to the same location on eery SSE serer where you copied the SDK files in step 2 on page 5: acodec-55.dll adeice-55.dll afilter-3.dll aformat-55.dll autil-52.dll LieProxy.dll postproc-52.dll swresample-0.dll swscale-2.dll 4. Download and install the required DirectShow files. a. Go to b. Download the following three files to a temporary location on a local drie on your workstation. DirectShowLib-2005.dll log4net.config log4net.dll c. Unblock (if necessary) and copy these three downloaded files from the temporary location on your workstation to the same location on eery SSE serer where you copied the SDK files in step 2 on page Download and install the required Microsoft Visual C++ updates on your SSE serers. To do this, log on to the SSE serers as an administrator, for example, the padmin user and if required, install the following updates from Microsoft Visual C Serice Pack 1 Redistributable Package MFC Security Update Microsoft Visual C Serice Pack 1 Redistributable Package MFC Security Update Visual C++ Redistributable for Visual Studio 2012 Update 4 Important: Ensure that you install the exact specified Microsoft Visual C++ update packages on eery SSE serer. The hyperlinks on do not follow the usual hyperlink format conentions. Hoer the cursor oer the titles to discoer the hyperlinks. Download the x86 ersion of each update. These ersions hae names in the form filename_x86.exe. 6 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

13 Note: Be careful not to oerwrite your files, as some downloads hae the same file name. What to do next When you hae obtained and prepared all of the prerequisite files, you are ready to start the integration installation. Ensure that you download the exact specified ersions, otherwise the integration might fail. Chapter 3. Obtaining and preparing the integration files 7

14 8 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

15 Chapter 4. Installing the Cisco VSM 7 DSF on the SSE serer Copy the Cisco VSM 7 DirectShow Filter (DSF) package from the MILS serer and install it on all of the SSE serers in your enironment. The DSF package also contains a set of utilities, which must be prepared before you can use them. Before you begin For legal notices that relate to the Cisco VSM 7 DSF, see Additional notices on page 29. Important: This ersion of the Cisco VSM 7 DSF supports H.264 encoded ideo only. About this task The Cisco VSM 7 DSF makes calls to the Cisco VSM 7 API, by using the Cisco VSM 7 SDK. The DSF implements interfaces of the Microsoft DirectShow Media framework. The DSF also uses open source software as noted in Chapter 3, Obtaining and preparing the integration files, on page 5. Complete the following procedure on eery SSE serer in your enironment. Procedure 1. Log on to the SSE serer as an administrator. 2. Go to the temporary directory that you copied the Cisco VSM DSF CiscoVSM7_DSF_Filter_V1_2.zip file into in step 1. of Chapter 3, Obtaining and preparing the integration files, on page Copy and extract the CiscoVSM7_DSF_Filter_V1_2.zip file from the MILS serer into a temporary working location on the SSE serer. Note: The temporary working location is referred to as your_working_area in the remainder of this procedure. When extraction is complete, the CiscoVSM7_DSF_Filter parent folder contains the following items: A directory that is named CiscoVSM7DSF. A subdirectory that is named Utilities, which contains the tools that are mentioned in Using the sample application and test tools to troubleshoot integration issues on page Moe the CiscoVSM7DSF folder into the appropriate location for your operating system. On a 64-bit Windows system, this location is C:\Program Files (x86)\ibm\sse\ciscovsm7dsf. 5. Copy the downloaded files to the SSE. a. Copy the VSOMWebSerice2.dll and VSOMWebSerice.XmlSerializers2.dll files that you downloaded in step 2 on page 5 of Chapter 3, Obtaining and preparing the integration files, on page 5 into the following folder:..\ibm\sse\ciscovsm7dsf\utilities b. Copy the VSOMWebSerice2.dll and VSOMWebSerice.XmlSerializers2.dll files that you downloaded in step 2 on page 5 of Chapter 3, Obtaining and preparing the integration files, on page 5 into the following folder:..\ibm\sse c. Copy all of the LieProxy and prerequisite files that you downloaded in step 3 on page 6 of Chapter 3, Obtaining and preparing the integration files, on page 5 into the following folder:..\ibm\sse\ciscovsm7dsf These files are: acodec-55.dll Copyright IBM Corp

16 adeice-55.dll afilter-3.dll aformat-55.dll autil-52.dll LieProxy.dll postproc-52.dll swresample-0.dll swscale-2.dll d. Copy the log4net.dll file that you downloaded in step 4 on page 6 of Chapter 3, Obtaining and preparing the integration files, on page 5 into the following folder:..\ibm\sse\ciscovsm7dsf e. Copy the files DirectShowLib-2005.dll, log4net.config, and log4net.dll, that you downloaded in step 4 on page 6 of Chapter 3, Obtaining and preparing the integration files, on page 5 into the following folder:..\ibm\sse\ciscovsm7dsf\utilities Note: When you complete the procedures in Using the sample application and test tools to troubleshoot integration issues on page 20, you will need the Utilities subdirectory. 6. Verify the content of the DSF directories for the IBM Intelligent Video Analytics SSE serer as follows: a. Ensure that the..\ibm\sse\ folder contains the following files: VSOMWebSerice2.dll (Downloaded) VSOMWebSerice.XmlSerializers2.dll (Downloaded) b. Ensure that the..\ibm\sse\ciscovsm7dsf folder contains the following files: acodec-55.dll (Downloaded) adeice-55.dll (Downloaded) afilter-3.dll (Downloaded) aformat-55.dll (Downloaded) autil-52.dll (Downloaded) CiscoSource.ax CiscoSource.ax.metagen CiscoSource.exp CiscoSource.lib CiscoSource.pdb HelperLib.dll HelperLib.pdb install.bat LieProxy.dll (Downloaded) log4net.dll (Downloaded) postproc-52.dll (Downloaded) swresample-0.dll (Downloaded) swscale-2.dll (Downloaded) uninstall.bat c. Ensure that the..\ibm\sse\ciscovsm7dsf\utilities folder contains the following files: Apply_IVA_IE_settings.bat camera.dat 10 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

17 CiscoCamDiscoery.html DirectShowLib-2005.dll (Downloaded) HelperLib.dll HelperLib.pdb IVA_IE_ModifySettings.reg log4net.config (Downloaded) log4net.dll (Downloaded) SampleGrabber.exe SampleGrabber.exe.config SampleGrabber.log.config SampleGrabber.pdb VSOMWebSerice2.dll (Downloaded) VSOMWebSerice2.XmlSerializers.dll (Downloaded) 7. From the Windows Serices Manager, stop the following SSE serices: IBM SSE IBM SSE rebooting tool 8. Set the Windows System Path enironment ariable to include the..\ibm\sse\ciscovsm7dsf directory as follows: a. Start Control Panel. b. Double-click the System icon. c. Click Adanced System Settings > Adanced > Enironment ariables. d. Under the System ariables section, modify the path so that it includes the CiscoVSM7DSF directory path. Important: Ensure that you add the directory to the path that is under System ariables and not under User ariables. 9. After you erify that the SSE serices are stopped, open the..\ibm\sse\ciscovsm7dsf directory and run the install.bat script. Important: If Windows User Account Control (UAC) is enabled, you must run the install.bat script from an Administrator command line. It is not sufficient to log on as an administrator and run the install.bat script through the context menu. a. Find the Command Prompt icon in your ersion of Windows (cmd.exe), and right-click on the icon. b. Choose Run as Administrator. c. Confirm the UAC prompt: Yes, allow to make changes. d. Change to the directory where you installed the Cisco DSF, for example, cd C:\Program Files (x86)\ibm\sse\ciscovsm7dsf. e. Run the install.bat script. Microsoft Windows should display a confirmation message for the registration of the Cisco DSF. If this step fails, ensure that the required Visual C++ ersions are installed, as outlined in 5 on page 6 of Chapter 3, Obtaining and preparing the integration files, on page From the Windows Serices Manager, restart the following SSE serices: IBM SSE Chapter 4. Installing the Cisco VSM 7 DSF on the SSE serer 11

18 IBM SSE rebooting tool 11. Verify that the SSE serices are successfully started. For more information, see Verifying the installation of the SSE in the IBM Knowledge Center. What to do next Before you run the DSF on the SSE serer, test the DSF by using the SampleGrabber.exe utility that is proided with the Cisco VSM 7 integration package for IBM Intelligent Video Analytics. For more information about SampleGrabber.exe and the other utilities that are proided for erifying the VMS integration, see Using the sample application and test tools to troubleshoot integration issues on page IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

19 Chapter 5. Installing the Cisco VSM 7 VMS extension on MILS Install the Cisco VSM 7 VMS extension on the IBM Intelligent Video Analytics V1.6.1 MILS serer and complete the required serer and client configuration. Before you begin Reiew Configuring a VMS serer in IBM Intelligent Video Analytics in the Intelligent Video Analytics V1.6.1 Knowledge Center. Installing and registering the Cisco VSM 7 web components Extract and load the Cisco VSM 7 web components for Intelligent Video Analytics onto the MILS serer and complete the required configuration steps. Procedure Load the Intelligent Video Analytics web player. 1. Log on to the MILS serer and open the HTTPSerer directory or folder. Note: On a Linux operating system, the default path is /opt/ibm/svs/httpserer. On a Windows operating system, the default path is C:\Program Files (x86)\ibm\svs\httpserer. 2. Locate the populated Cisco VSM directory on the MILS serer at../httpserer/htdocs/milsng/ms/ CiscoVSM7. Load the MILS VMS web components. 3. Start Internet Explorer and connect to the web UI of the Cisco VSM 7 serer, for example The client is redirected through HTTPS. Note: The Cisco MultiPane Client is loaded when you connect and log on to the Cisco VSM web UI. In addition to installing the MultiPane Client, the certificates from the Cisco serer are also installed. The Cisco VSM ideo player does not function if steps 3 to 10 are unsuccessful. 4. If the Cisco VSM serer is not already listed as a trusted site, add the Cisco VSM serer to Trusted Sites in the Internet Explorer security settings. 5. If you receie a warning about an inalid certificate when you try to access the login page, proceed to connect. Then, install the certificate by clicking the certificate error warning in the address bar. 6. Install the certificate into the Trusted Root Certification Authorities store. 7. Install the certificate again, but this time into the Personal certificate store. When you are able to establish an HTTPS connection to the login page of the Cisco Video Sureillance Operations Manager (VSOM) serer without getting a certificate warning, the certificate is successfully installed. Note: If the certificates are not installed, lie or recorded ideo does not play in the ideo player pane in the upper-right section of the Intelligent Video Analytics operator client. 8. Log on to the VSOM web UI with a priileged user ID and password. Use the following URL: 9. When prompted, install the Cisco VSM client. 10. After the client is installed, select a camera and drag it into the ideo monitoring pane. When you can successfully iew ideo in the VSOM UI, the client is installed correctly. Copyright IBM Corp

20 11. Log on to the Cisco Video Sureillance Management Console (VSMC) on the media serer and accept its certificates in the same way that you did on the VSOM serer in step 7. Use the following URL: Register the Intelligent Video Analytics web player on the MILS serer. 12. Edit the uiprofile.json file in the IBM Intelligent Video Analytics web root..\ibm\svs\httpserer\ htdocs\milsng\conf directory as described in the following steps. Important: If you incorrectly modify the uiprofile.json file, IBM Intelligent Video Analytics does not function correctly. Take particular care oer the following points. Back up the uiprofile.json file before you change the file. Edit in UTF-8 mode, so that foreign-language characters are not altered. In Windows Notepad start by editing normally, then Sae As, and at bottom of the window in the Encoding dropdown list select: UTF-8. In Linux i, during editing, enter :set encoding=utf-8. Use the correct JSON syntax throughout the uiprofile.json file. If the JSON syntax is incorrect, it is not parsed correctly by the browser and the UI does not function as expected. Note: A common mistake is in arrays of objects. Each object must be followed by a comma character (,) except for the last object, which must not hae a trailing comma. 13. Find the playerparameters object and add the following text to the object if this text is not already present. {"id": "Cisco_VSM_7", "url": "ms/ciscovsm7/objectdetailsvmsplayers.html"} 14. Locate the preloadplayers array in the file, and add the following entry. {"id": "Cisco_VSM_7"} Note: As described in the topic Configuring a VMS serer in the product documentation, remoe any preloadplayer entries that are not required for your deployment. Configuring the VMS serer, cameras, and channels In the Intelligent Video Analytics administrator client, configure a VMS serer entry, cameras, and channels for the Cisco VSM 7 integration. The clients that access the Cisco ideo channels and use the ideo player must also be configured. Before you begin Reiew Video stream request URL in the IBM Knowledge Center for Intelligent Video Analytics. Important: If your Intelligent Video Analytics system is running ersion , before you start to configure the analytic engine for the Cisco VMS, log on to the MILS serer and complete the first-time administrator client set up on the client system as outlined in the product documentation. Procedure 1. Log on to the Intelligent Video Analytics administrator client as the padmin user. For more information, see Accessing the administrator client in the IBM Knowledge Center. Create a VMS serer definition 2. Go to the Serers tab. A list of the existing predefined VMS serers is displayed. 3. Find the pre-populated entry for serer Cisco_VSM_7. Edit the Cisco VSM serer entry as follows: Serer Id Name Hostname : xx : Cisco_VSM_7 : short_name 14 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

21 Parameters : user=administrator&password=xxxxxx Format : $protocol://$serer?camera=$camid&user=$username&password=$password Protocol : ciscosource Version : 7.6 In the hostname field, enter the short name of the Cisco VSOM 7 serer, for example, ciscosom76. The IP address sometime works instead. In the Parameters field, enter the user ID and password credentials for a user with authority to access the Cisco VSM V7.6 serer. Configure the cameras 4. Go to the Cameras tab and complete the required fields to create a camera definition for eery camera that you are integrating. Complete the following fields as described: Field Instructions VMS Serer For each camera, select the Cisco VSM 7 serer that you configured in step 3. VMS Camera ID Engine Params Set the VMS Camera ID of the camera to the Camera UID of the appropriate camera as defined on the Cisco serer. Note: For analog cameras connected to encoder ports this ID is the analog camera deice ID, not the encoder deice ID. These IDs can be found on the Cisco Video Sureillance Management Console (VSMC). For more information about how to determine the camera ID, see Finding cameras and their characteristics on page 21. Enter the width and height that the camera is configured for, and ensure that each parameter is preceded with an ampersand (&) character. For example, &Width=704&Height=480. Important: If you do not know these alues, contact your Cisco VSM administrator. Note: These alues must match the actual width and height that is configured for the camera. Otherwise, ideo is distorted when streamed by the SSE. If more than one stream is defined for the camera, add a stream parameter with the Stream Id of the stream that you want the SSE to use. For example, &stream=3fefd41f-891b-4d3b-bf47-55d _s2. In most cases, this stream is the second stream as it is the lower resolution stream and conseres CPU resource on the SSE. Make sure that the width and height parameters match the resolution of the selected stream. For more information about the serer definition fields, see Camera definition properties in the IBM Knowledge Center. Configure channels (iews) and associated analytic engines 5. Go to the Channels tab and create channels for each camera to be analyzed. You must also configure the analytic engines that are associated with each channel. For more information, see Creating, updating, and deleting channels in the IBM Knowledge Center. Set up the serers and clients for HTTPS and cross-domain operations 6. The Cisco VSM 7 serer requires HTTPS connections to support ideo playback. Web browsers that are used to connect to the Intelligent Video Analytics administrator or operator clients must make HTTPS requests to the Cisco serer. To allow these requests, an IBM HTTP Serer that support HTTPS must be running on the MILS component. Some additional configuration is also required in the Internet Explorer security settings. Note: In Intelligent Video Analytics V1.6, HTTPS is enabled for MILS by default. 7. Ensure that the following browser configuration steps are applied to eery client that accesses the Intelligent Video Analytics administrator or operator clients: a. Configure the Internet Explorer security settings as outlined in Setting up the Intelligent Video Analytics operator client in the IBM Knowledge Center. Chapter 5. Installing the Cisco VSM 7 VMS extension on MILS 15

22 b. Add the Cisco VSOM serer and any Cisco Media serers to the Trusted Sites, ensuring that the URLs include the HTTPS protocol. c. In the Custom leel settings for Trusted Sites, enable the extra functions in the following list. Access data sources across domains Display mixed content Launching programs and files in an IFRAME Naigate windows and frames across different domains 16 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

23 Chapter 6. Configuring the IBM Intelligent Video Analytics clients Set up the IBM Intelligent Video Analytics administrator and operator clients to access and play ideo from a Cisco Video Sureillance Manager V7.6 system. Procedure 1. Install the Microsoft Visual C Serice Pack 1 Redistributable Package MFC Security Update on the Windows clients. 2. Ensure that the IBM Intelligent Video Analytics administrator and operator clients are running a supported browser. 3. Ensure that the clients can access the MILS serer. The clients must be able to resole the host name of the Intelligent Video Analytics MILS serer either through DNS or through an entry in the desktop hosts file. For example, if the MILS serer host name is MILS_host_name and this host name is not in DNS, then ensure that the following entry exists in the c:\windows\system32\driers\etc\hosts file on the client: aaa.bbb.ccc.ddd MILS_host_name where aaa.bbb.ccc.ddd is the IP address of the MILS serer. 4. Complete the mandatory browser configuration steps as described in the topics "Installing the administrator client" and "Preparing to run the IBM Intelligent Video Analytics clients on Microsoft Internet Explorer" in the IBM Knowledge Center. Be sure to add the MILS, SSE, and all Cisco serers (including any irtual IP addresses if you are using them in a HA enabled enironment) to Trusted Sites in the Microsoft Internet Explorer security settings. Important: You must manually complete step 1 of the procedure that is outlined in Preparing to run the IBM Intelligent Video Analytics clients on Microsoft Internet Explorer. A script is included in the Intelligent Video Analytics V1.6.1 Cisco VSM V7.6 integration package folder to help you to complete the remaining client configuration steps in the procedure. To access the script: a. Log on to the MILS serer and go to:../httpserer/htdocs/milsng/ms/ciscovsm7/build/ b. Extract the contents of CiscoVSM7_DSF_Filter_V1_2.zip. c. Copy the Apply_IVA_IE_settings.bat and IVA_IE_ModifySettings.reg files to the clients in your enironment. d. From a command prompt, run the Apply_IVA_IE_settings.bat script as the Administrator user. This script imports the Windows registry settings that are required to use Internet Explorer with Intelligent Video Analytics. If you do not use this script, you must manually enter the commands that are listed in "Preparing to run the IBM Intelligent Video Analytics clients on Microsoft Internet Explorer". 5. Complete the extra browser configuration in the following steps. a. When you log on to the Intelligent Video Analytics administrator or operator client and you are presented with the message "There is a problem with this website's security certificate", click Continue to this website (not recommended). This message is displayed because a self-signed SSL certificate is used on the MILS serer. b. If you are prompted with the message "Only secure content is displayed", click Show all content to allow both HTTP and HTTPS content to be displayed in the browser. c. When prompted, accept and install the ActieX controls. Copyright IBM Corp

24 18 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

25 Chapter 7. Troubleshooting information and tools Troubleshooting information and tools are proided to help you to complete the integration. Known problems Check the IBM Intelligent Video Analytics Support Portal for the latest information about problems, solutions, and fixes for IBM Intelligent Video Analytics. Check the troubleshooting topics in the IBM Knowledge Center section, Troubleshooting and support. Check the Cisco website for the latest information about Cisco Video Sureillance Manager. Cisco VSM failoer problem A known problem exists with the Cisco high aailability (HA) failoer feature, which can cause problems with the integration. For more information see the following technote on the IBM Support Portal: Unblocking the dynamic link libraries Before you can complete the integration installation tasks, you might need to unblock the dynamic link library (dll) files, which you download to a Microsoft Windows system at the start of the integration. About this task When you download files from an external site by using Microsoft Windows facilities, they might be flagged as untrusted by default. Use the following procedure to unblock the dll files: Procedure 1. Check the Windows properties of the dll file by right-clicking the file name and selecting Properties. 2. In the General tab, look for the Security label in the Attributes section. Note: Look for the Security label in the General tab, not in the Security tab. 3. If the Security label exists, click Unblock, and then click OK as outlined in the following image. If the Security label does not exist, then the file is unblocked, and no action is necessary. Copyright IBM Corp

26 Note: If the Microsoft Windows operating system that you use supports PowerShell, you can use the PowerShell > Unblock-File menu option to unblock the files. This procedure might be necessary if the Security information is not displayed as described on the General tab. 4. If the Security label does not appear, and the file is no longer in the folder where it was downloaded: a. Moe the dll file back to the folder where it was downloaded. b. Unblock the dll file, as described in steps 1 to 3 in this procedure. c. Return the dll file to the new location. If after you complete steps 3 and 4 of this procedure, the option to 'Unblock' the file is not displayed, the file does not need to be unblocked. Using the sample application and test tools to troubleshoot integration issues To help you to troubleshoot integration issues with IBM Intelligent Video Analytics and Cisco VSM 7, seeral test tools and a sample application are proided to analyze configuration issues relating to the Cisco serer and the Cisco DirectShow Filter (DSF). The troubleshooting tools are not needed for the DSF to operate and function, howeer they are proided to help you to debug your test systems, and are useful for initial testing and to gather information for future configuration. Important: Install the tools that are proided in the Cisco DSF package on a test IBM Intelligent Video Analytics enironment. Do not use these tools on a production system. The test tools that are outlined in the following sections are typically installed on a Windows 7 client. 20 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

27 You can find the utilities in the CiscoVSM7_DSF_Filter_V1_2.zip Cisco DSF package file. Microsoft GraphEdit is also another useful tool for troubleshooting the DSF that you can download and install on the SSE serer. Finding cameras and their characteristics Cisco VSM proides seeral utilities for obtaining information about the cameras in your system and how they are set up, which you need for configuring or troubleshooting problems in IBM Intelligent Video Analytics. For example, when you use the SampleGrabber tool, you will need to assemble the Cisco URL for the camera, as outlined in step 2 of the next troubleshooting topic, 'Testing the DSF by using the SampleGrabber tool'. About this task The following table outlines some of the ways that you can obtain information about your Cisco cameras, which is useful for completing the required setup tasks or troubleshooting problems. Cisco utility Cisco Video Sureillance Operations Manager (VSOM) Cisco Video Sureillance Management Console (VSMC) CiscoCamDiscoery.html utility Use to find... The resolution of camera The UID of an analog camera that is connected to an encoder port The UID of a camera that is connected to a separate media serer Cameras on a Cisco VSOM 7 serer and also secondary streams for IP cameras Obtaining the resolution of the camera Procedure 1. Start a browser session and log on to the Cisco VSOM by using the following URL: 2. Select the Cameras tab at the top. 3. In the lower left of the pane, locate and select the camera in the Cameras section. 4. In the central pane, select the tab Streaming, Recording and Eents. 5. Select the Template for the camera. 6. Click Video Stream A > Custom. 7. In the Resolution pop-up window, read the width and height. For example: 352x240. You can also see other camera parameters in this window, such as media type or maximum frame rate. Retrieing the UIDs of cameras from the Cisco VSMC Procedure 1. Using the following URL, log on to the VSMC of your Cisco media serer as the localadmin user or equialent: Under Troubleshooting, if you do not see Media Serer, ensure that you logged on to the VSMC. If you logged on to the VSOM serer by mistake, you will not see the Media Serer option. 2. In the System Administration tab of the VSMC, select Troubleshooting > Media Serer. To search for the working UID of the camera by stream: a. Under Media Serer, click Streams. All streams are displayed. b. Locate the camera in the list, and read the working UID in the Stream Name column. Chapter 7. Troubleshooting information and tools 21

28 c. Click the camera name to get the model number, IP address, endor, and other information. To search for the working UID of the camera by deice: a. Under Media Serer, click Deices. b. In the Deices List tab, in the Search by drop-down list, select Analog Cameras. All analog cameras are displayed. c. Locate the camera in the list, and read the working UID in the Deice UIDcolumn. Finding cameras by using the CiscoCamDiscoery.html tool Use the CiscoCamDiscoery.html tool to find the cameras in your Cisco enironment and to also read the UID of a camera. This information is important if you plan to use multi-streaming on cameras. Multi-streaming can proide lower resolution ideo to an SSE to allow the SSE to support more cameras. Procedure 1. Start an Internet Explorer browser session and open the CiscoCamDiscoery.html page, which is included in the Cisco VSM DSF package for Intelligent Video Analytics. The page can be hosted on your local client or on any web serer. Important: You must use a Microsoft Internet Explorer browser to display the CiscoCamDiscoery.html web page. 2. Enter the host name of the Cisco VSOM 7 serer, followed by alid user credentials, and then click Load. The streams that are configured for each camera are displayed in the text area of the utility. Important: Depending on how the network connectiity is configured, you might need to specify the host name as either the IP address, the short name, or the fully qualified host name. Note: If you do not get a response after seeral seconds, check that the certificates are installed correctly. The CiscoCamDiscoery.html page makes HTTPS calls to the Cisco VSOM 7 serer, so that the proper certificates must be installed. The best way to install the certificates is to connect to the Cisco VSOM console with Internet Explorer and complete the steps when prompted. When you can log on to the VSOM console with no certificate warnings, the certificates are successfully installed. 3. Make a note of the UID of each camera. Stream names are typically the camera UID followed by _s1 or _s2. 4. Check whether any cameras hae more than one stream defined. If you see any camera with a _s2 stream defined, take particular note of the camera UID. 5. If possible, copy the camera UID and stream ID from the utility into your Intelligent Video Analytics camera definitions. Testing the DSF by using the SampleGrabber tool The SampleGrabber utility initiates ideo streams from the camera that uses the DirectShow Filter (DSF). The utility uses the same DirectShow interface as the SSE serer, and so tests that the DSF and the URL that you are using work with the SSE. About this task SampleGrabber closely simulates the operation of the SSE by actiating logging operations and streaming ideo by using the same URL as Intelligent Video Analytics. Run the SampleGrabber utility from the SSE serer where the DSF is typically installed. Procedure To alidate the DSF installation and networking setup: 1. Run the SampleGrabber utility from the SSE serer. 22 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

29 2. In the Cisco source URL field, specify the URL that you would like to test. The format of this URL is typically as follows: ciscosource://ip_address?camera=camera_id&user=admin_user_id&password=admin_user_password&width=width&height=height For example: ciscosource:// ?camera= abc...9f&user=admin&password=password&width=320&height= Modify the width and height parameters to match the camera stream configuration. 4. Click OK. The VideoStatus and log output windows open. Note: The log output window shows what the filter is doing. The VideoStatus window shows four rounded rectangles that turn green as the filter graph is built. When the graph is complete, an ActieMoie window displays the ideo stream. When the ideo starts playing, click Capture on the Images tab in the VideoStatus window. Each time that you click Capture, an image is retrieed by the Sample Grabber tool. The images are in the correct color and orientation and match the images that the SSE serer retriees from the DSF. Troubleshooting issues with GraphEdit GraphEdit is a Microsoft product for debugging DirectShow graphs and must be installed on the same serer as the DirectShow Filter (DSF). To run GraphEdit, download the tool from the Microsoft Windows Software Deelopment Kit (SDK) on to the SSE serer. Procedure 1. Run the GraphEdit utility from the following directory on the SSE serer...\ibm\sse\ciscovsm7dsf\utilities\graphedt.exe GraphEdit must be run from the Utilities directory, otherwise it might not work. 2. Select Render URL from the File menu. 3. Enter the URL of the SSE serer that you are troubleshooting. What to do next For more information about GraphEdit, see the following page on the Microsoft website: Note: If the page does not display, search microsoft.com using the following string: Using GraphEdit (Windows) Troubleshooting issues with camera connection When IBM Intelligent Video Analytics attempts to connect to a Cisco camera through the Configure Analytics window, you may encounter a problem that causes the browser application to stop responding. To generate the flow of incoming ideo, IBM Intelligent Video Analytics sends a ideo stream request in the format of a URL to the ideo management system (VMS) from the Smart Sureillance Engine (SSE) component. When you create an analytic engine for connecting to the Cisco VMS, the ideo stream request URL is generated from alues in the serer and camera definitions. A problem can be caused by incorrect alues of the parameters that are proided in the URL. A URL that contains incorrect alues for Height, Width, or Camera ID parameters causes the engine editor to try repeatedly to connect to the camera. This can cause the browser to stop responding. The height and Chapter 7. Troubleshooting information and tools 23

30 width alues requested by the SSE need to match the height and width set for the camera on the Cisco VMS. Proiding an incorrect protocol or IP alue causes the engine editor to fail to connect to the camera and results in a pop-up window to appear indicating an issue with the URL. Ensure that you configure correctly the serer and camera definitions from the Serers and Cameras tabs, on the administrator client, as outlined in the topic,video stream request URL, in the IBM Knowledge Center for Intelligent Video Analytics. 24 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

31 Notices Product legal notices for IBM Intelligent Video Analytics V This information was deeloped for products and serices offered in the US. This material might be aailable from IBM in other languages. Howeer, you may be required to own a copy of the product or product ersion in that language in order to access it. IBM may not offer the products, serices, or features discussed in this document in other countries. Consult your local IBM representatie for information on the products and serices currently aailable in your area. Any reference to an IBM product, program, or serice is not intended to state or imply that only that IBM product, program, or serice may be used. Any functionally equialent product, program, or serice that does not infringe any IBM intellectual property right may be used instead. Howeer, it is the user's responsibility to ealuate and erify the operation of any non-ibm product, program, or serice. IBM may hae patents or pending patent applications coering subject matter described in this document. The furnishing of this document does not grant you any license to these patents. You can send license inquiries, in writing, to: IBM Director of Licensing IBM Corporation North Castle Drie, MD-NC119 Armonk, NY US For license inquiries regarding double-byte character set (DBCS) information, contact the IBM Intellectual Property Department in your country or send inquiries, in writing, to: Intellectual Property Licensing Legal and Intellectual Property Law IBM Japan, Ltd , Nihonbashi-Hakozakicho, Chuo-ku Tokyo , Japan INTERNATIONAL BUSINESS MACHINES CORPORATION PROVIDES THIS PUBLICATION "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. Some jurisdictions do not allow disclaimer of express or implied warranties in certain transactions, therefore, this statement may not apply to you. This information could include technical inaccuracies or typographical errors. Changes are periodically made to the information herein; these changes will be incorporated in new editions of the publication. IBM may make improements and/or changes in the product(s) and/or the program(s) described in this publication at any time without notice. Any references in this information to non-ibm websites are proided for conenience only and do not in any manner sere as an endorsement of those websites. The materials at those websites are not part of the materials for this IBM product and use of those websites is at your own risk. IBM may use or distribute any of the information you proide in any way it beliees appropriate without incurring any obligation to you. Copyright IBM Corp

32 Licensees of this program who wish to hae information about it for the purpose of enabling: (i) the exchange of information between independently created programs and other programs (including this one) and (ii) the mutual use of the information which has been exchanged, should contact: IBM Director of Licensing IBM Corporation North Castle Drie, MD-NC119 Armonk, NY US Such information may be aailable, subject to appropriate terms and conditions, including in some cases, payment of a fee. The licensed program described in this document and all licensed material aailable for it are proided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equialent agreement between us. The performance data and client examples cited are presented for illustratie purposes only. Actual performance results may ary depending on specific configurations and operating conditions. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly aailable sources. IBM has not tested those products and cannot confirm the accuracy of performance, compatibility or any other claims related to non-ibm products. Questions on the capabilities of non-ibm products should be addressed to the suppliers of those products. This information contains examples of data and reports used in daily business operations. To illustrate them as completely as possible, the examples include the names of indiiduals, companies, brands, and products. All of these names are fictitious and any similarity to actual people or business enterprises is entirely coincidental. COPYRIGHT LICENSE: This information contains sample application programs in source language, which illustrate programming techniques on arious operating platforms. You may copy, modify, and distribute these sample programs in any form without payment to IBM, for the purposes of deeloping, using, marketing or distributing application programs conforming to the application programming interface for the operating platform for which the sample programs are written. These examples hae not been thoroughly tested under all conditions. IBM, therefore, cannot guarantee or imply reliability, sericeability, or function of these programs. The sample programs are proided "AS IS", without warranty of any kind. IBM shall not be liable for any damages arising out of your use of the sample programs. Terms and conditions for product documentation Permissions for the use of these publications are granted subject to the following terms and conditions. Applicability These terms and conditions are in addition to any terms of use for the IBM website. Personal use You may reproduce these publications for your personal, noncommercial use proided that all proprietary notices are presered. You may not distribute, display or make deriatie work of these publications, or any portion thereof, without the express consent of IBM. Commercial use You may reproduce, distribute and display these publications solely within your enterprise proided that all proprietary notices are presered. You may not make deriatie works of these 26 IBM Intelligent Video Analytics: IBM IVA Integration Plug-in for Cisco VSM 7.6 Installation and enablement guide

33 publications, or reproduce, distribute or display these publications or any portion thereof outside your enterprise, without the express consent of IBM. Rights Except as expressly granted in this permission, no other permissions, licenses or rights are granted, either express or implied, to the publications or any information, data, software or other intellectual property contained therein. IBM reseres the right to withdraw the permissions granted herein wheneer, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the aboe instructions are not being properly followed. You may not download, export or re-export this information except in full compliance with all applicable laws and regulations, including all United States export laws and regulations. IBM MAKES NO GUARANTEE ABOUT THE CONTENT OF THESE PUBLICATIONS. THE PUBLICATIONS ARE PROVIDED "AS-IS" AND WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE. Copyright notice Copyright International Business Machines Corporation 2013, U.S. Goernment Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. May only be used pursuant to an IBM software license agreement. No part of this publication may be reproduced, transmitted, transcribed, stored in a retrieal system, or translated into any computer language, in any form or by any means, electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without prior written permission of IBM Corporation. IBM Corporation grants you limited permission to make hardcopy or other reproductions of any machine-readable documentation for your own use, proided that each such reproduction shall carry the IBM Corporation copyright notice. No other rights under copyright are granted without prior written permission of IBM Corporation. The document is not intended for production and is furnished as is without warranty of any kind. All warranties on this document are hereby disclaimed, including the warranty of non-infringement and the implied warranties of merchantability and fitness for a particular purpose. Notices 27