This is an archive related to a previous version of Esri Maps for IBM Cognos. If you need the current version go to http://doc.arcgis.com/en/maps-for-cognos/.

Uninstall Esri Maps for IBM Cognos

Uninstalling Esri Maps for IBM Cognos requires the removal of all components both inside and outside of IBM Cognos. The following workflow describes how to uninstall the product when all Esri Maps for IBM Cognos components are installed on one computer. You must repeat the uninstallation process on each computer that contains Esri Maps for IBM Cognos components. Not all steps are applicable to all installations.

Disable Esri Maps for IBM Cognos

You must disable Esri Maps for IBM Cognos on all EM4C Gateway and EM4C Dispatcher locations in your environment. The purpose of this is to return IBM Cognos to its original state. All files modified by the Esri Maps for IBM Cognos configuration process are restored.

The EM4C Dispatcher is installed once for each IBM Cognos Dispatcher running the report and/or presentation service. After Esri Maps for IBM Cognos has been disabled for these environments, the IBM Cognos Service needs to be restarted.

Once the IBM Cognos Service has been restarted for all affected IBM Cognos Dispatchers, report authors and end users should clear their browser caches.

Perform the following as a user with administrative privileges.

  1. Return IBM Cognos files to their original state as follows:
    1. Browse to the em4c_location\bin directory and launch configure.bat.
    2. Click the Disable button.
    3. From the File menu, click Exit.
  2. Restart the IBM Cognos Service. Refer to the IBM Cognos Installation and Configuration Guide for more information.

Disable Esri Maps for IBM Cognos silently

Esri Maps for IBM Cognos can be disabled silently. Perform the following as a user with administrative privileges.

  1. In a command prompt (cmd.exe) running as an administrator, browse to the em4c_location\bin directory.
  2. Enter the following: configure.bat -remove.
  3. Restart the IBM Cognos Service. Refer to the IBM Cognos Installation and Configuration Guide for more information.

Remove the web server components

The following is to be completed on each IBM Cognos Gateway computer.

During the installation and configuration process for Esri Maps for IBM Cognos, you were instructed to configure a web server. The components added to your web server can be safely removed at this time. It is recommended that you remove them in the reverse order in which you added them.

Delete (or rename) installed files

The following is to be completed everywhere Esri Maps for IBM Cognos components were installed.

The uninstallation steps performed above have not deleted anything. If it is your intention that Esri Maps for IBM Cognos not be reinstalled, you can safely delete the em4c_location from all of your environments.

If you are planning to upgrade Esri Maps for IBM Cognos from an earlier version (or are reinstalling to recover a corrupted or incomplete installation), it is recommended that you rename em4c_location until after the new installation and configuration process has been completed and tested. The reason for this is that each Esri Maps for IBM Cognos environment has many configuration files that contain information that can be reused between versions.

  • em4c_location\bin\em4c.xml
  • em4c_location\webcontent\esrimap\configuration\settings.js
  • em4c_location\webcontent\esrimap\em4c-bisprovider\defaults\defaultMap.json

You cannot copy many of these files into a new Esri Maps for IBM Cognos environment due to changes that may have been made in new versions. These files do, however, contain information that is valuable. When configuring your new environment, it is recommended that you open the old version of these files and copy/paste relevant configuration information into the new version.