Esri Maps for IBM Cognos 6.0.1 Patch 1

This patch improves performance in rendering map features and graphics in Internet Explorer, making map performance comparable to Firefox and Chrome. It also addresses two bugs related to legend styling.

Esri® announces the Esri Maps for IBM Cognos 6.0.1 Patch 1. This patch offers a Silverlight map rendering engine to improve performance in rendering map features and graphics in Internet Explorer. The Silverlight rendering engine is designed to make map performance in Internet Explorer comparable to Chrome and Firefox. The patch also addresses bugs related to legend styling. It deals specifically with the issues listed below under Issues Addressed with this Patch.

Issues Addressed with this patch

BUG-000085367 – Category groups in legend do not update with dynamic data correctly.

Description: Styles configured for layers are not honored when filters are inserted and removed.
ENH-000085013 – Style values can't handle all characters.

Description: At run time, the style/measure might have values that contain certain characters (for example, "> 201mm"). The greater-than (>) character is not displayed correctly (comes through as "&gt"), but the front end needs to be able to handle anything that is returned via the query.
NIM103716 – Internet Explorer 9 exhibits poor performance displaying 1500+ points in map control of an EM4C report.

Description: When configuring (in Esri Map Designer) or running a Cognos report containing a map using Internet Explorer 9, if a Cognos query configured to display points on a map returns more than 1500 points, browser performance is unacceptable and browser will lock up or perform very slowly making the report unusable. When running the same report using FireFox 17.0.8, performance is fine and the problem is not experienced.

Files Installed in this patch

The following files are installed under the EM4C root directory:

/webcontent/emf/1.4/dojo/dojox/charting/Element.js
/webcontent/emf/1.4/dojo/dojox/gfx/silverlight.js
/webcontent/emf/1.4/esri-maps/widgets/MapWrapper/MapWrapper.js
/webcontent/emf/1.4/esri-maps/widgets/Select/Selection.js
/webcontent/emf/1.4/esri-maps/widgets/StyleGrouping/StyleGroupingController.js
/webcontent/emf/1.4/esri/dijit/Legend.js
/webcontent/emf/1.4/esri/layers/GraphicsLayer.js
/webcontent/emf/1.4/esri/MapNavigationManager.js
/webcontent/emf/1.4/esri/toolbars/edit.js
/webcontent/emf/1.4/esri/toolbars/_Box.js
/webcontent/emf/1.4/esri/toolbars/_GraphicMover.js
/webcontent/emf/1.4/esri/toolbars/_toolbar.js
/webcontent/emf/1.4/esri/toolbars/_VertexMover.js
/webcontent/emf/1.4/version.txt
/webcontent/esriBIX/1.4/version.txt
/webcontent/esriBIX/1.4/widgets/Legend/css/Legend.css
/webcontent/esriBIX/1.4/widgets/Select/SelectWidget.js
/webcontent/esrimap/designer.html
/webcontent/esrimap/em4c-bisprovider/screenshot/canReplace.js
/webcontent/esrimap/em4c-bisprovider/screenshot/html2canvas.js
/webcontent/esrimap/em4c-bisprovider/screenshot/screenshot.js
/webcontent/esrimap/em4c-bisprovider/screenshot/silverlight2canvas.js
/webcontent/esrimap/em4c-bisprovider/screenshot/vml2canvas.js
/webcontent/esrimap/em4c-bisprovider/util/Squrler.js
/webcontent/esrimap/esri-maps-em4c/actions/_CognosAction.js
/webcontent/esrimap/esri-maps-em4c/commands/ExportMap.js
/webcontent/esrimap/reporter.html
/webcontent/version.txt
/webcontent/emf/1.4/esri-maps/main.js
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/CanServlet$1.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/CanServlet.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/DrawImg$1.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/DrawImg.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/DrawObject.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/DrawRect.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/DrawString.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/FillArc.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/FillRect.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/FillShape.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/FillVMLRect.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/ImageLoader$1.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/ImageLoader$2.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/ImageLoader$3.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/ImageLoader.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/JSONReader.class
/webapps/em4c/WEB-INF/classes/com/esri/em4c/webserver/canvas/ShapeStringParser.class
/version.txt

Download the file to a location other than your Esri Maps for IBM Cognos location.

		Checksum (Md5)
Esri Maps for IBM Cognos 6.0.1 Gateway	HOT-FIX-EM4C-Gateway.zip	5CB15FCB27C16399FA8B0374682890CE

Esri Maps for IBM Cognos 6.0.1 Server	HOT-FIX-EM4C-Server.zip	70885C1527767AEB804DA011937DA7E3

Patch Version File	version.txt	33D1D42B2DBE26F4B54A7B236A926D93

Installing this patch on Windows

Installation Steps:

Before you start, make sure you have write access to the Esri Maps for IBM Cognos 6.0.1 installation location.

The following must be completed on all Esri Maps for IBM Cognos Server and Gateway machines in your configuration.

Copy and extract HOT-FIX-EM4C-Gateway.zip and version.txt to the root directory of each EM4C Gateway, overwriting files when prompted..
Copy and extract HOT-FIX-EM4C-Server.zip and version.txt to the root directory of each EM4C Server, overwriting files when prompted.
Restart the EM4C Server service.

Note: On the Windows platform, the default name of the Windows service is EM4C. If you are running Esri Maps for IBM Cognos using a non-default EM4C Server HTTP Port, the name of the service is EM4C<port>. For example, if the EM4C Server HTTP Port is 1234, the service is named EM4C1234.
Clear your browser's cache.

Installing this patch on AIX, Linux, and System z

Installation Steps:

Before you start, make sure you have write access to the Esri Maps for IBM Cognos 6.0.1 installation location.

The following must be completed on all Esri Maps for IBM Cognos Server and Gateway machines in your configuration.

Copy and extract HOT-FIX-EM4C-Gateway.zip and version.txt to the root directory of each EM4C Gateway, overwriting files when prompted.
Copy and extract HOT-FIX-EM4C-Server.zip and version.txt to the root directory of each EM4C Server, overwriting files when prompted.
Stop the EM4C Server service by browsing to the <em4c_location>/bin directory and running the following command as the user who owns the Esri Maps for IBM Cognos installation location:

./stop-em4c.sh
Start the EM4C Server service by browsing to the <em4c_location>/bin directory and running the following command as the user who owns the Esri Maps for IBM Cognos installation location:

./start-em4c.sh
Clear your browser's cache.

Installation Notes

The minimum requirement for installing this hot fix is Esri Maps for IBM Cognos version 6.0.1.
This patch was certified against Silverlight 5.x. To use this patch, Silverlight 5.x must be installed on the client.
To use Silverlight in Internet Explorer versions 10 and 11, the browser must be in compatibility mode. For a list of supported browsers, see the 6.0.1 section under Web browsers on the Supported environments page.
To confirm that Silverlight is enabled, right-click on Map and you should see a Silverlight pop-up. Click on the pop-up to get version information.
Refer to Technical Article 42801 for known limitations for Internet Explorer and Esri Maps for IBM Cognos versions 5.x and 6.x.

Patch Updates

Check the Patches and Service Packs page periodically for the availability of additional patches. New information about this patch will be posted here.

Getting Help

Domestic sites, please contact Esri Technical Support at 1-888-377-4575, if you have any difficulty installing this patch. International sites, please contact your local Esri software distributor.

Download ID:2187