IBM Intelligent Video Analytics Version VMS extension for Cisco VSM 7 Installation and integration enablement guide

Transcription

1 IBM Intelligent Video Analytics Version VMS extension for Cisco VSM 7 Installation and integration enablement guide

2

3 IBM Intelligent Video Analytics Version VMS extension for Cisco VSM 7 Installation and integration enablement guide

4 Note Before using this information and the product it supports, read the information in Notices, copyright, terms, and trademarks on page 27.

5 Contents Chapter 1. Integrating IBM Intelligent Video Analytics with Cisco VSM Chapter 2. Installation overview Chapter 3. Preparing your Intelligent Video Analytics system Chapter 4. Obtaining and preparing the prerequisite integration files Chapter 5. Installing the Cisco VSM 7 DSF on the SSE server Chapter 6. Installing the Cisco VSM 7 VMS extension on MILS Installing and registering the Cisco VSM 7 web components Configuring the VMS server, cameras, and channels 16 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 Retrieving the UIDs of cameras from the Cisco VSMC Finding cameras by using the CiscoCamDiscovery.html tool Testing the DSF by using the SampleGrabber tool 24 Troubleshooting issues with GraphEdit Notices, copyright, terms, and trademarks Notices Copyright notice Additional notices Trademarks Chapter 7. Configuring the IBM Intelligent Video Analytics clients Chapter 8. Troubleshooting information and tools Known problems Copyright IBM Corp iii

6 iv IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

7 Chapter 1. Integrating IBM Intelligent Video Analytics with Cisco VSM 7 IBM Intelligent Video Analytics (IBM IVA) version V1.6 can be integrated with Cisco Video Surveillance Manager (VSM) version 7. Integration components must be installed on both the Middleware for Large Scale Surveillance (MILS) and the Smart Surveillance Engine (SSE) servers. The IBM IVA VMS extension package for Cisco that is on the MILS server, the Cisco SDK, and the downloadable prerequisite open source files provide the required media for installing and configuring the integration. This guide provides 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 version 7.6 together with the Cisco VSM SDK V7.6. Additionally, the DirectShow Filter for Cisco VSM 7: v Plays only H.264 video codec. v Supports frame rate reduction, for example: &framerate=10 v Supports secondary streams though a URL extension, for example: &stream=3fefd41f-891b-4d3b-bf47-55d _vs2 v Does not support downsizing. Downsizing can be accomplished separately by the camera or encoder. Copyright IBM Corp

8 2 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

9 Chapter 2. Installation overview To integrate IBM Intelligent Video Analytics V with Cisco Video Surveillance Manager (VSM) 7.6, complete the integration preparation and the installation steps in the order that is specified. Procedure 1. Prepare your Intelligent Video Analytics V system for the integration. 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 servers in your environment. 4. Install the Cisco web player application on the Intelligent Video Analytics MILS server. Important: If your Cisco VSM is running on a virtual machine, the integrated video player that is embedded into the Intelligent Video Analytics operator client does not function as expected, due to the use of special video 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 virtual machines, as outlined in the product documentation and the detailed system requirements information. 5. Prepare the Intelligent Video Analytics administrator and operator clients. 6. Optional: Install the Cisco VSM 7.6 sample application and testing tools that are provided in the DSF package. Copyright IBM Corp

10 4 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

11 Chapter 3. Preparing your Intelligent Video Analytics system Procedure 1. Ensure that your IBM (Intelligent Video Analytics) system meets the minimum system requirements and is deployed according to the installation instructions in the product documentation. v For information about the minimum requirements, see Detailed system requirements for IBM Intelligent Video Analytics. v To access the product documentation, go to the IBM Knowledge Center for Intelligent Video Analytics. 2. Install Intelligent Video Analytics fix pack as outlined in the product documentation. 3. Ensure that you have the following access permissions: v Administrator access to the Intelligent Video Analytics Middleware for Large Scale Surveillance (MILS) and Smart Surveillance Engine (SSE) servers. v The pvadmin user credentials to log on to the MILS administrator and operator clients to complete the integration configuration and verification. Copyright IBM Corp

12 6 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

13 Chapter 4. Obtaining and preparing the prerequisite integration files Obtain and prepare the files that are required to complete the integration. Some of the integration files are provided in the Cisco VSM installation directory on the MILS server. The rest of the files must be downloaded from external sources. About this task The following table summarizes the integration files that are required to complete the integration: Integration file set Cisco VSM DSF installation package Cisco VSM 7.6 SDK Open source LiveProxy and other integration files Cisco DirectShow files Microsoft Visual C++ updates Description The Cisco VSM DSF installation package, CiscoVSM7_DSF_Filter_V1_2.zip, is located on the MILS server and provides 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 provided in the Utilities subdirectory of the package folder. The Cisco VSM 7.6 SDK contains several files that are required to complete the integration. Download the specified SDK version from the Cisco website. A set of open source dll files must be downloaded and installed on the SSE servers. Additional DirectShow files must be downloaded and installed on the SSE servers. The x86 version of the Microsoft Visual C++ updates must be correctly applied to all SSE servers. Complete the following procedure to obtain and prepare the required integration files that are described in the previous 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 move them to the specified location. You must check every 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 21 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 server to a temporary location on the SSE server. You can find the CiscoVSM7_DSF_Filter_V1_2.zip compressed file in the following directory on the MILS server:../httpserver/htdocs/milsng/vms/ciscovsm7/build/ Complete the remaining steps in this procedure on the SSE server. 2. Download the Cisco VSM V7.6 SDK and prepare the required files, as follows: a. Go to b. Scroll down the page to locate VSM 7.6 SDK, and download the SDK. Copyright IBM Corp

14 c. Extract the contents of the VSM7.6SDK_with_V2_0_wsdl.zip file to a temporary location on a local drive 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 every SSE server: v..\vsm7.6sdk_with_v2_0_wsdl\webservicesdlls\vsomwebservice2.dll v..\vsm7.6sdk_with_v2_0_wsdl\webservicesdlls\vsomwebservice2.xmlserializers.dll 3. Download and prepare the required open source integration files. a. Go to b. Download the Version1.0.0.zip file. c. Extract the contents of the Version1.0.0.zip file to a temporary location on a local drive on your workstation. d. Unblock (if necessary) and copy the following LiveProxy and prerequisite files from the temporary location on your workstation to the same location on every SSE server where you copied the SDK files in step 2 on page 7: v avcodec-55.dll v avdevice-55.dll v avfilter-3.dll v avformat-55.dll v avutil-52.dll v LiveProxy.dll v postproc-52.dll v swresample-0.dll v 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 drive on your workstation. v DirectShowLib-2005.dll v log4net.config v log4net.dll c. Unblock (if necessary) and copy these three downloaded files from the temporary location on your workstation to the same location on every SSE server where you copied the SDK files in step 2 on page Download and install the required Microsoft Visual C++ updates on your SSE servers. To do this, log on to the SSE servers as an administrator, for example, the pvadmin user and if required, install the following updates from v Microsoft Visual C Service Pack 1 Redistributable Package MFC Security Update v Microsoft Visual C Service Pack 1 Redistributable Package MFC Security Update v Visual C++ Redistributable for Visual Studio 2012 Update 4 Important: v Ensure that you install the exact specified Microsoft Visual C++ update packages on every SSE server. v The hyperlinks on do not follow the usual hyperlink format conventions. Hover the cursor over the titles to discover the hyperlinks. v Download the x86 version of each update. These versions have names in the form filename_x86.exe. Note: Be careful not to overwrite your files, as some downloads have the same file name. 8 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

15 What to do next When you have obtained and prepared all of the prerequisite files, you are ready to start the integration installation. Ensure that you download the exact specified versions, otherwise the integration might fail. Chapter 4. Obtaining and preparing the prerequisite integration files 9

16 10 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

17 Chapter 5. Installing the Cisco VSM 7 DSF on the SSE server Copy the Cisco VSM 7 DirectShow Filter (DSF) package from the MILS server and install it on all of the SSE servers in your environment. 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 version of the Cisco VSM 7 DSF supports H.264 encoded video 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 4, Obtaining and preparing the prerequisite integration files, on page 7. Complete the following procedure on every SSE server in your environment. Procedure 1. Log on to the SSE server and 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 4, Obtaining and preparing the prerequisite integration files, on page Copy and extract the CiscoVSM7_DSF_Filter_V1_2.zip file from the MILS server into a temporary working location on the SSE server. 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: v The version number of the DSF. v A directory that is named CiscoVSM7DSF. v 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 Move the CiscoVSM7DSF folder into the appropriate location for your operating system. v On a 64-bit Windows system, this location is C:\Program Files (x86)\ibm\sse\ciscovsm7dsf. v On a 32-bit Windows system, this location is C:\Program Files\IBM\SSE\CiscoVSM7DSF. 4. Copy the downloaded files to the SSE. a. Copy the VSOMWebService2.dll and VSOMWebService.XmlSerializers2.dll files that you downloaded in step 2 on page 7 of Chapter 4, Obtaining and preparing the prerequisite integration files, on page 7 into the following folder: v..\ibm\sse\ciscovsm7dsf\utilities b. Copy the VSOMWebService2.dll file that you downloaded in step 3 of Chapter 4, Obtaining and preparing the prerequisite integration files, on page 7 into the following folder:..\ibm\sse c. Copy all of the LiveProxy and prerequisite files that you downloaded in step 3 on page 8 of Chapter 4, Obtaining and preparing the prerequisite integration files, on page 7 into the following folder:..\ibm\sse\ciscovsm7dsf Copyright IBM Corp

18 These files are: v avcodec-55.dll v avdevice-55.dll v avfilter-3.dll v avformat-55.dll v avutil-52.dll v LiveProxy.dll v postproc-52.dll v swresample-0.dll v swscale-2.dll d. Copy the log4net.dll file that you downloaded in step 4 on page 8 of Chapter 4, Obtaining and preparing the prerequisite integration files, on page 7 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 8 of Chapter 4, Obtaining and preparing the prerequisite integration files, on page 7 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 22, you will need the Utilities subdirectory. 5. Verify the content of the DSF directories for the IBM IVA SSE server as follows: a. Ensure that the..\ibm\sse\ciscovsm7dsf folder contains the following files: v avcodec-55.dll (Downloaded) v avdevice-55.dll (Downloaded) v avfilter-3.dll (Downloaded) v avformat-55.dll (Downloaded) v avutil-52.dll (Downloaded) v CiscoSource.ax v CiscoSource.ax.metagen v CiscoSource.exp v CiscoSource.lib v CiscoSource.pdb v HelperLib.dll v HelperLib.pdb v install.bat v LiveProxy.dll (Downloaded) v log4net.dll (Downloaded) v postproc-52.dll (Downloaded) v swresample-0.dll (Downloaded) v swscale-2.dll (Downloaded) v uninstall.bat b. Ensure that the..\ibm\sse\ciscovsm7dsf\utilities folder contains the following files: v Apply_IVA_IE_settings.bat v camera.dat v CiscoCamDiscovery.html v DirectShowLib-2005.dll (Downloaded) 12 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

19 v HelperLib.dll v HelperLib.pdb v IVA_IE_ModifySettings.reg v log4net.config (Downloaded) v log4net.dll (Downloaded) v SampleGrabber.exe v SampleGrabber.exe.config v SampleGrabber.log.config v SampleGrabber.pdb v VSOMWebService2.dll (Downloaded) v VSOMWebService2.XmlSerializers.dll (Downloaded) 6. From the Windows Services Manager, stop the following SSE services: v IBM SSE v IBM SSE rebooting tool After you verify that the SSE services are stopped, open the..\ibm\sse\ciscovsm7dsf directory and run the install.bat script. Important: If this step fails, ensure that the required Visual C++ versions are installed, as outlined in 5 on page 8 of Chapter 4, Obtaining and preparing the prerequisite integration files, on page 7 8. Set the Windows System Path environment variable to include the..\ibm\sse\ciscovsm7dsf directory as follows: a. Start Control Panel. b. Double-click the System icon. c. Click Advanced System Settings > Advanced > Environment variables. d. Under the System variables 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 variables and not under User variables. 9. From the Windows Services Manager, restart the following SSE services: v IBM SSE v IBM SSE rebooting tool Verify that the SSE services 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 server, test the DSF by using the SampleGrabber.exe utility that is provided with the Cisco VSM 7 integration package for IBM IVA. For more information about SampleGrabber.exe and the other utilities that are provided for verifying the VMS integration, see Using the sample application and test tools to troubleshoot integration issues on page 22. Chapter 5. Installing the Cisco VSM 7 DSF on the SSE server 13

20 14 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

21 Chapter 6. Installing the Cisco VSM 7 VMS extension on MILS Install the Cisco VSM 7 VMS extension on the IBM Intelligent Video Analytics V MILS server and complete the required server and client configuration. Before you begin Review Configuring a VMS server in IBM Intelligent Video Analytics in the Intelligent Video Analytics V1.6 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 server and complete the required configuration steps. Procedure Load the Intelligent Video Analytics web player. 1. Log on to the MILS server and open the HTTPServer directory. Note: v On a Linux operating system, the default path to this directory is /opt/ibm/svs/httpserver. v On a Windows operating system, the default path to this folder is C:\Program Files\IBM\SVS\HTTPServer. 2. Locate the populated Cisco VSM directory on the MILS server at../httpserver/htdocs/milsng/vms/ CiscoVSM7. Load the MILS VMS web components. 3. Start Internet Explorer and connect to the web UI of the Cisco VSM 7 server, 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 server are also installed. The Cisco VSM video player does not function if steps 3 to 10 are unsuccessful. 4. If the Cisco VSM server is not already listed as a trusted site, add the Cisco VSM server to Trusted Sites in the Internet Explorer security settings. 5. If you receive a warning about an invalid 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 Surveillance Operations Manager (VSOM) server without getting a certificate warning, the certificate is successfully installed. Note: If the certificates are not installed, live or recorded video does not play in the video player pane in the upper-right section of the Intelligent Video Analytics operator client. 8. Log on to the VSOM web UI with a privileged user ID and password. 9. When prompted, install the Cisco VSM client. 10. After the client is installed, select a camera and drag it into the video monitoring pane. When you can successfully view video in the VSOM UI, the client is installed correctly. Copyright IBM Corp

22 11. Log on to the Cisco Video Surveillance Management Console (VSMC) and accept its certificates in the same way that you did on the VSOM server in step 7. Register the Intelligent Video Analytics web player on the MILS server. 12. Edit the uiprofile.json file in the IBM IVA web root..\ibm\svs\httpserver\htdocs\milsng\conf directory. Important: If you incorrectly modify the uiprofile.json file, IBM IVA does not function correctly. Take particular care over the following points. v Back up the uiprofile.json file before you change the file. v Use an editor that supports UTF-8. If your editor supports UTF-8, then under the language object, which lists the supported languages, you can correctly see some double-byte characters. These characters are displayed for some languages such as Chinese, Russian, and Japanese. If these languages are not displayed in their native character set, then your editor does not support UTF-8. Do not save the uiprofile.json file with an editor that does not support UTF-8, as by doing so you can corrupt the file. v 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 have 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": "vms/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 server in the product documentation, remove any preloadplayer entries that are not required for your deployment. Configuring the VMS server, cameras, and channels In the Intelligent Video Analytics MILS administrator client, configure a VMS server entry, cameras, and channels for the Cisco VSM 7 integration. The clients that access the Cisco video channels and use the video player must also be configured. Procedure 1. Log on to the MILS administrator client as the pvadmin user. For more information, see Accessing the administrator client in the IBM Knowledge Center. Create a VMS server definition. 2. Go to the Servers tab. A list of the existing predefined VMS servers is displayed. Make a note of the server IDs of the existing VMS servers. You must assign the next highest unused numeric ID to your new server definition. 3. In the Intelligent Video Analytics administrator client, edit the Cisco VSM server entry as follows: Server Id : xx Name : Cisco_VSM_7 Hostname : {Enter the IP address or the host name of the Cisco VSOM 7 Server} Parameters : user=administrator&password=xxxxxx Format : $protocol://$server?camera=$camid&user=$username&password=$password Protocol : ciscosource Version : IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

23 In the Parameters field, enter the user ID and password credentials for a user with authority to access the Cisco VSM V7.6 server. Configure the cameras. 4. Go to the Cameras tab and complete the required fields to create a camera definition for every camera that you are integrating. Complete the following fields as described: Field Instructions VMS Server For each camera, select the Cisco VSM 7 server that you configured in step 3. VMS Camera ID Set the VMS Camera ID of the camera to the Camera UID of the appropriate camera as defined on the Cisco server. Note: For analog cameras connected to encoder ports this ID is the analog camera device ID, not the encoder device ID. These IDs can be found on the Cisco Video Surveillance Management Console (VSMC). For more information about how to determine the camera ID, see Finding cameras and their characteristics on page 23. Engine Params 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: v If you do not know these values, contact your Cisco VSM administrator. Note: These values must match the actual width and height that is configured for the camera. Otherwise, video is distorted when streamed by the SSE. v 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 _vs2. In most cases, this stream is the second stream as it is the lower resolution stream and conserves 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 server definition fields, see Camera definition properties in the IBM Knowledge Center. Configure channels (views) 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 servers and clients for HTTPS and cross-domain operations. 6. The Cisco VSM 7 server requires HTTPS connections to support video playback. Web browsers that are used to connect to the Intelligent Video Analytics administrator or operator clients must make HTTPS requests to the Cisco server. To allow these requests, an IBM HTTP Server 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 every 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. b. Add the Cisco VSOM server and any Cisco Media Servers to the Trusted Sites, ensuring that the URLs include the HTTPS protocol. c. In the Custom level settings for Trusted Sites, enable the extra functions in the following list. v Access data sources across domains v Display mixed content Chapter 6. Installing the Cisco VSM 7 VMS extension on MILS 17

24 v Launching programs and files in an IFRAME v Navigate windows and frames across different domains 18 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

25 Chapter 7. Configuring the IBM Intelligent Video Analytics clients Set up the IBM Intelligent Video Analytics MILS administrator and operator clients to access and play video from a Cisco Video Surveillance Manager (VSM) V7.6 system. Procedure 1. Install the Microsoft Visual C Service Pack 1 Redistributable Package MFC Security Update on the Windows clients. 2. Ensure that the MILS administrator and operator clients are running a supported browser. 3. Ensure that the clients can access the MILS server. The clients must be able to resolve the host name of the Intelligent Video Analytics MILS server either through DNS or through an entry in the desktop hosts file. For example, if the MILS server 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\drivers\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 server. 4. Complete the mandatory browser configuration steps as described in the topics "Installing the administrator client" and "Preparing to run the MILS clients on Microsoft Internet Explorer" in the IBM Knowledge Center. Be sure to add the MILS, SSE, and all Cisco servers (including any virtual IP addresses if you are using them in a HA enabled environment) 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 MILS clients on Microsoft Internet Explorer. A script is included in the Intelligent Video Analytics V 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 server and go to:../httpserver/htdocs/milsng/vms/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 environment. 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 MILS 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 server. 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 ActiveX controls. Copyright IBM Corp

26 20 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

27 Chapter 8. Troubleshooting information and tools Troubleshooting information and tools are provided 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 Cisco website for the latest information about Cisco Video Surveillance Manager (VSM). Cisco VSM failover problem A known problem exists with the Cisco high availability (HA) failover 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

28 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. Move 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, several test tools and a sample application are provided to analyze configuration issues relating to the Cisco server and the Cisco DirectShow Filter (DSF). The troubleshooting tools are not needed for the DSF to operate and function, however they are provided 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 provided in the Cisco DSF package on a test IBM Intelligent Video Analytics environment. 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. 22 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

29 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 server. Finding cameras and their characteristics Cisco VSM provides several 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 Surveillance Operations Manager (VSOM) Cisco Video Surveillance Management Console (VSMC) CiscoCamDiscovery.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 server Cameras on a Cisco VSOM 7 server 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 Events. 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. Retrieving the UIDs of cameras from the Cisco VSMC Procedure 1. Using the following URL, log on to the VSMC of your Cisco media server as the localadmin user or equivalent: Under Troubleshooting, if you do not see Media Server, ensure that you logged on to the VSMC. If you logged on to the VSOM server by mistake, you will not see the Media Server option. 2. In the System Administration tab of the VSMC, select Troubleshooting > Media Server. v To search for the working UID of the camera by stream: a. Under Media Server, click Streams. All streams are displayed. b. Locate the camera in the list, and read the working UID in the Stream Name column. Chapter 8. Troubleshooting information and tools 23

30 v c. Click the camera name to get the model number, IP address, vendor, and other information. To search for the working UID of the camera by device: a. Under Media Server, click Devices. b. In the Devices 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 Device UIDcolumn. Finding cameras by using the CiscoCamDiscovery.html tool Use the CiscoCamDiscovery.html tool to find the cameras in your Cisco environment 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 provide lower resolution video to an SSE to allow the SSE to support more cameras. Procedure 1. Start an Internet Explorer browser session and open the CiscoCamDiscovery.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 server. Important: You must use a Microsoft Internet Explorer browser to display the CiscoCamDiscovery.html web page. 2. Enter the host name of the Cisco VSOM 7 server, followed by valid 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 connectivity 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 several seconds, check that the certificates are installed correctly. The CiscoCamDiscovery.html page makes HTTPS calls to the Cisco VSOM 7 server, 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 _vs1 or _vs2. 4. Check whether any cameras have more than one stream defined. If you see any camera with a _vs2 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 video streams from the camera that uses the DirectShow Filter (DSF). The utility uses the same DirectShow interface as the SSE server, 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 activating logging operations and streaming video by using the same URL as Intelligent Video Analytics. Run the SampleGrabber utility from the SSE server where the DSF is typically installed. Procedure To validate the DSF installation and networking setup: 1. Run the SampleGrabber utility from the SSE server. 24 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

31 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: v The log output window shows what the filter is doing. v The VideoStatus window shows four rounded rectangles that turn green as the filter graph is built. v When the graph is complete, an ActiveMovie window displays the video stream. v When the video starts playing, click Capture on the Images tab in the VideoStatus window. v Each time that you click Capture, an image is retrieved by the Sample Grabber tool. v The images are in the correct color and orientation and match the images that the SSE server retrieves from the DSF. Troubleshooting issues with GraphEdit GraphEdit is a Microsoft product for debugging DirectShow graphs and must be installed on the same server as the DirectShow Filter (DSF). To run GraphEdit, download the tool from the Microsoft Windows Software Development Kit (SDK) on to the SSE server. Procedure 1. Run the GraphEdit utility from the following directory on the SSE server...\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 Server 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) Chapter 8. Troubleshooting information and tools 25

32 26 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

33 Notices, copyright, terms, and trademarks Notices This information was developed for products and services offered in the U.S.A. IBM may not offer the products, services, or features discussed in this document in other countries. Consult your local IBM representative for information on the products and services currently available in your area. Any reference to an IBM product, program, or service is not intended to state or imply that only that IBM product, program, or service may be used. Any functionally equivalent product, program, or service that does not infringe any IBM intellectual property right may be used instead. However, it is the user's responsibility to evaluate and verify the operation of any non-ibm product, program, or service. IBM may have patents or pending patent applications covering 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 Drive Armonk, NY U.S.A. For license inquiries regarding double-byte (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 The following paragraph does not apply to the United Kingdom or any other country where such provisions are inconsistent with local law: 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 states 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 improvements 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 provided for convenience only and do not in any manner serve 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 supply in any way it believes appropriate without incurring any obligation to you. Copyright IBM Corp

34 Licensees of this program who wish to have 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 Corporation Department T81B F6/Building S. Miami Boulevard Durham NC U.S.A. Such information may be available, 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 available for it are provided by IBM under terms of the IBM Customer Agreement, IBM International Program License Agreement or any equivalent agreement between us. Any performance data contained herein was determined in a controlled environment. Therefore, the results obtained in other operating environments may vary significantly. Some measurements may have been made on development-level systems and there is no guarantee that these measurements will be the same on generally available systems. Furthermore, some measurements may have been estimated through extrapolation. Actual results may vary. Users of this document should verify the applicable data for their specific environment. Information concerning non-ibm products was obtained from the suppliers of those products, their published announcements or other publicly available 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 individuals, companies, brands, and products. All of these names are fictitious and any similarity to the names and addresses used by an actual business enterprise is entirely coincidental. If you are viewing this information softcopy, the photographs and color illustrations may not appear. 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 provided that all proprietary notices are preserved. You may not distribute, display or make derivative 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 provided that all proprietary notices are preserved. You may not make derivative works of these 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. 28 IBM Intelligent Video Analytics: VMS extension for Cisco VSM 7 Installation and integration enablement guide

35 IBM reserves the right to withdraw the permissions granted herein whenever, in its discretion, the use of the publications is detrimental to its interest or, as determined by IBM, the above 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 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 retrieval 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, provided 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. U.S. Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corporation. Additional notices Legal Notices for the Cisco VSM 7 Direct Show Filter (DSF) for IBM Intelligent Video Analytics The Cisco VSM 7 DSF uses an open source library called LiveProxy, which is licensed under the GNU Lesser General Public License (LGPL). LiveProxy combines functions of the Live555 and FFMpeg open source libraries, which are licensed under LGPL, into a single library. The Cisco VSM 7 DSF also uses the Apache log4net library, which is part of the Apache Logging Services project at the Apache Software Foundation, licensed under the Apache 2.0 License. Trademarks IBM and ibm.com are trademarks of the IBM Corporation in the United States, other countries, or both. Microsoft, Internet Explorer, Windows, and the Windows logo are trademarks of Microsoft Corporation in the United States, other countries, or both. Linux is a registered trademark of Linus Torvalds in the United States, other countries, or both. Other names may be trademarks of their respective owners. Other company, product, and service names may be trademarks or service marks of others. Visit the IBM Terms of Use website for trademark attribution. Notices, copyright, terms, and trademarks 29