Patches and updates

Esri maps for IBM Cognos version 6.1.1 Utilities Patch

Published: October 21, 2016

Summary

This patch addresses problems with the server-side utilities for upgrading map specifications, created using older versions of Esri maps for IBM Cognos, and for updating URL paths to Esri Map Services in IBM Cognos reports imported from one environment to another.

Description

Esri® announces the Esri Maps for IBM Cognos 6.1.1 Utilities Patch. This patch addresses problems with the server-side utilities for upgrading map specifications, created using older versions of Esri maps for IBM Cognos, and for updating URL paths to Esri Map Services in IBM Cognos reports imported from one environment to another. It deals specifically with the issues listed below under Issues Addressed with this Patch.

Issues Addressed with this patch

BUG-000100178 – Server-side utility to upgrade map specification in IBM Cognos reports created using earlier versions of EM4C does not work.
BUG-000100179 – Server-side utility to quickly update the URL paths relating to Esri Map Services in IBM Cognos Reports imported from other IBM Cognos environments does not work.

Files Installed in this patch

The following files are installed under EM4C Server:

webapps\em4c\WEB-INF\classes\com\esri\em4c\update\EM4CUpdateServiceImpl.class
webapps\em4c\WEB-INF\classes\com\esri\em4c\webserver\rest\em4cspec\resources\EM4CSpecResource.class

The following files are installed under EM4C Gateway:

webcontent\utilities\run.js
webcontent\utilities\runUpgrade6.1.js
webcontent\utilities\UpdateMapURLs.html
webcontent\utilities\UpgradeMapSpecs.html
webcontent\utilities\js\cognos\update\BISPROVIDER.js
webcontent\utilities\js\cognos\update\ContentStoreJsonRest.js
webcontent\utilities\js\cognos\upgrade\BISPROVIDER.js
webcontent\utilities\js\esri\logging\Logger.js
webcontent\utilities\js\esri\update\SearchPane.js
webcontent\utilities\js\esri\update\updateMain.js
webcontent\utilities\js\esri\update\api\BISPROVIDER.js
webcontent\utilities\js\esri\update\api\UTIL.js
webcontent\utilities\js\esri\update\resources\update.css
webcontent\utilities\js\esri\upgrade\api\UTIL.js

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

		Checksum (Md5)
Esri Maps for IBM Cognos 6.1.1 Gateway	PATCH-EM4C-Gateway.zip	92718C6D77D063D0DC244A42E75FF455

Esri Maps for IBM Cognos 6.1.1 Server	PATCH-EM4C-Server.zip	196C173BCD610BF0FFF14C5948AB5462

Patch Version File	version.zip	011381B1A6961B215C8EEA72B5D7CD03

Installing this patch on Windows

Installation Steps:

Esri Maps for IBM Cognos 6.1.1 must be installed before installing this patch.

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

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

Copy PATCH-EM4C-Gateway.zip, PATCH-EM4C-Server.zip and version.txt to a temporary location on your server where you have write access.
Stop the EM4C Server service(s)

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. For example, if the EM4C Server HTTP Port is 1234, the service is named EM4C1234.
Copy and extract PATCH-EM4C-Gateway.zip and version.zip to the root directory of each EM4C Gateway, overwriting files when prompted.
Copy and extract PATCH-EM4C-Server.zip and version.zip to the root directory of each EM4C Server, overwriting files when prompted.
Restart the EM4C Server service.
Clear your browser's cache.

Installing this patch on AIX, Linux and System Z

Installation Steps:

Esri Maps for IBM Cognos 6.1.1 must be installed before installing this patch.

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

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

Copy PATCH-EM4C-Gateway.zip, PATCH-EM4C-Server.zip and version.zip to a temporary location anywhere you have write access.
Stop the EM4C Server service(s). The following should be run as the user who owns the Esri Maps for IBM Cognos installation location. Navigate to the "/bin" directory and run the following:

./stop-em4c.sh
Extract the PATCH-EM4C-Gateway.zip into the "<EM4C install location>" on each of the EM4C Gateway server(s) (overwrite existing files as necessary).
Extract the PATCH-EM4C-Server.zip into the "<EM4C install location>" on each of the EM4C Server server(s) (overwrite existing files as necessary).
Extract the version.zip file to "<EM4C install location>" on each of the EM4C Gateway and EM4C Server server(s) (overwrite existing files as necessary).
Start EM4C Server services. The following should be run as the user who owns the Esri Maps for IBM Cognos installation location. Navigate to the "<EM4C install location>/bin" directory and run the following:

./start-em4c.sh
Refresh browser cache

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.