IBM Intelligent Video Analytics 1.5 | Software Interim Fix |APAR PO02326

• About this readme file
• Included in this interim fix
• Prerequisites
• Installation
• Uninstallation
• More information
• Copyright and Trademarks

About this readme file

This readme file provides information about how to install interim fix PO02326 for IBM Intelligent Video Analytics V1.5.

Included in this interim fix

IBM Intelligent Video Analytics supports the inclusion of GIS maps within the Operator UI. Interim fix PO02326 contains an update for IBM Intelligent Video Analytics version 1.5 that is required if you want to enable the GIS map feature of the Operator Client.

Note: This is an optional feature of version 1.5 that requires you to purchase the appropriate subscription from a supported mapping provider.

If the GIS map feature is enabled, the following functionality is available in the IBM Intelligent Video Analytics Operator Client user interface:

1. Cameras are plotted on the map*.
2. Live feed of a camera can be launched from the map.
3. Cameras are highlighted on the map when an alert is triggered.
4. Video footage from alerts can be played back from the map interface.
5. Cameras can be selected from the map and added to the Search Constraint form of a query.

* Cameras are plotted on the map only if the latitude and longitude coordinates are correctly configured in the Smart Vision Suite (SVS) system.

If interim fix PO02326 is installed, IBM Intelligent Video Analytics can be configured to use maps from the following GIS map service providers:

• Esri
• Google Maps
• OpenStreetMap

Prerequisites

You must have administrative or 'root' access to update the IBM Intelligent Video Analytics V1.5 Smart Surveillance Engine servers.

You must also download the OpenLayers API before you install interim fix PO02326. The OpenLayer API should be downloaded using the following link:

http://www.ibm.com/support/docview.wss?uid=swg24036447

Find the "Enhanced Maps for IBM Smarter Cities Products" section on the page and click the Download Options link to download the API. When prompted, accept the necessary agreements. The OpenLayers API is required to access Google, Esri, or OpenStreetMap GIS map servers within the IBM Intelligent Video Analytics Operator Client user interface. For specific instructions for installing the OpenLayers API to work with the Intelligent Video Analytics V1.5 product, see the EnhancedMaps_readme.html file that is provided with the Enhanced Maps for IBM Smarter Cities Products media. Complete all of the required instructions to correctly update your IBM Intelligent Video Analytics solution with the required OpenLayers API.

Installation

Interim fix PO02326 requires you to update the Middleware for Large Scale Surveillance (MILS) components of IBM Intelligent Video Analytics. The fix package contains the following files:

1. 1.5.0.0-IVA-PO02326-readme.html, which is this readme file.
2. 1.5.0.0-IVA-MILS-PO02326.zip, which is used to update the MILS server machines.
   

Installing the MILS fix

1. Stop the HTTP Server service on the MILS Server machine. If this is a MILS Cluster, depending on the platform, complete one of the following steps on the Primary WebSphere cluster node:
   • If the system is deployed on a Windows platform, stop the "IBM HTTP Server 7.0" service from the Services Control Panel.
   • If the system is deployed on a Linux platform, run the following command:

   "/opt/IBM/SVS/HTTPServer/bin/apachectl stop"
   

2. Extract the content of the 1.5.0.0-IVA-MILS-PO02326.zip file underneath the document root directory of the MILS web server.

Note that:

• The document root location for your installation might have been configured to be on it's own Drive (windows install) or File System (Linux install).
• The default location is .../IBM/SVS/HTTPServer/htdocs.
• After the compressed file is successfully extracted, you can validate that the files were output to the correct location. To do this, check that the following file exists:

".../htdocs/milsng/images/marker.png"


3. Edit the index.html file by using a text editor. The index.html file is located underneath the IBM Intelligent Video Analytics web server document root directory, as follows:

   ".../htdocs/milsng/index.html"
   

   • If the installation will use the Open Street Maps or the Esri GIS map service provider, then insert the following script tag in the header of the index.html file, below the line containing the HTML comment <!--map links-->:

   <script type="text/javascript"src="/milsng/lib/OpenLayers.js"></script>
   

   • If the installation will use the Google Maps GIS map service provider, then insert the following script tags in the header of the index.html file, below the line containing the HTML comment <!--map links-->:

   <script type="text/javascript"src="/milsng/lib/OpenLayers.js"></script>

   <script src="http://maps.google.com/maps/api/js?v=3&key={API_KEY*}&sensor=false"></script>

   Note: * The online instruction for obtaining the API Key that is required can be found here.
   

4. Edit the uiprofile.json file by using a UTF-8 enabled editor, such as NOTEPAD.EXE. The uiprofile.json file is located underneath the document root directory of the IBM Intelligent Video Analytics web server, as follows:

   ".../htdocs/milsng/conf/uiprofile.json"
   

   Within the uiprofile.json file, locate the "mapEnabled": false, line. Replace that line with one of the following configurations depending on the GIS map service provider that you are using:
   

   • If the installation will use the OpenStreetMaps GIS map service provider, add the following configuration:

     "mapEnabled": true,
     "mapCenterLatitude": 40.7142,
     "mapCenterLongitude": -74.0064,
     "mapZoomLevel": {"maximum": 20,"minimum": 1,"default": 10},
     "mapType": [{"label": "roadmap","value": "roadmap"},{"label": "satellite","value": "satellite"},{"label": "terrain","value": "basic"}],
     "mapAPI": "omap",
     "mapSubType": "osm",
     "mapParameters": { "icons":{ "active": { "icon": "/milsng/images/marker.png" }, "inactive": { "icon": "/milsng/images/marker-green.png"} },
     "baseURL": "http://vmap0.tiles.osgeo.org/wms/vmap0",
     "baseLayers": "basic,clabel,ctylabel",
     "additionalLayers": { "roadmap": ",priroad,secroad,rail,ferry,tunnel,bridge", "satellite": ",ground_01,ground_02,river,disp,inwater,coastline_01,coastline_02", "terrain": ",ground_01,ground_02,depthcontour,coastline_01,coastline_02" } },

     
     
   • If the installation will use the Esri GIS map service provider, add the following configuration:

     "mapEnabled": true,
     "mapCenterLatitude": 40.7142,
     "mapCenterLongitude": -74.0064,
     "mapZoomLevel": {"maximum": 20,"minimum": 1,"default": 10},
     "mapType": [{"label": "roadmap","value": "roadmap"},{"label": "satellite","value": "satellite"},{"label": "terrain","value": "basic"}],
     "mapAPI": "omap",
     "mapSubType": "esri",
     "mapParameters": {"icons":{"active": {"icon": "/milsng/images/marker.png"},"inactive": {"icon": "/milsng/images/marker-green.png"}},
     "roadURL": "http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/${z}/${y}/${x}",
     "terrainURL": "http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/${z}/${y}/${x}0",
     "satelliteURL": "http://server.arcgisonline.com/ArcGIS/rest/services/World_Topo_Map/MapServer/tile/${z}/${y}/${x}",},
     

   • If the installation will use the Google Maps GIS map service provider, add the following configuration:

     "mapEnabled": true,
     "mapCenterLatitude": 40.7142,
     "mapCenterLongitude": -74.0064,
     "mapZoomLevel": {"maximum": 20,"minimum": 1,"default": 10},
     "mapType": [{"label": "roadmap","value": "roadmap"},{"label": "satellite","value": "satellite"},{"label": "terrain","value": "basic"}],
     "mapAPI": "omap",
     "mapSubType": "google",
     "mapParameters": {"icons":{"active": {"icon": "/milsng/images/marker.png"},"inactive": {"icon": "/milsng/images/marker-green.png"}}},

5. Restart the HTTP Server service on the MILS Server machine. If this is a MILS Cluster, depending on the platform, complete one of the following on the Primary WebSphere cluster node:
   • If the system is deployed on a Windows platform, start the "IBM HTTP Server 7.0" service from the Services Control Panel.
   • If the system is deployed on a Linux platform, execute the following command:

   "/opt/IBM/SVS/HTTPServer/bin/apachectl start"

To test the mapping functions, close and re-open your browser, ensuring that the cache is cleared. When you log on, the Map tab displays in the Channel Selector pane underneath the Tree listing of the camera views, which are otherwise referred to as channels. When you open the Map tab, the GIS map of the configured service provider displays.

Initial troubleshooting:

Uninstallation

Uninstallation is not supported for this interim fix. Ensure that you back up your environment before installing this fix.

More information

To access the product documentation and other key information resources, see the IBM Intelligent Video Analytics publication library at:

http://www.ibm.com/support/docview.wss?uid=swg27039485

Copyright and Trademarks

Licensed Materials - Property of IBM. © Copyright IBM Corporation 2013. All Rights Reserved. Note to U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

IBM, the IBM logo and ibm.com are trademarks of International Business Machines Corp., registered in many jurisdictions worldwide. Other product and service names might be trademarks of IBM or other companies. A current list of IBM trademarks is available on the Web at "Copyright and trademark information" at http://www.ibm.com/legal/copytrade.shtml.