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. This process returns 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 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.

Disable Esri Maps for IBM Cognos silently

On Linux and UNIX platforms, interactive installations and configurations are typically performed from an X Window System (X11) workstation, an X terminal, or a PC with X server software installed. Ensure that X11 forwarding is set up correctly before disabling the software.

Esri Maps for IBM Cognos can be disabled silently. Perform the following as the user who owns the Esri Maps for IBM Cognos installation location.

Stop EM4C Server

For each EM4C Server location in your environment, the EM4C service needs to be stopped.

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> 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 valuable information. When configuring your new environment, it is recommended that you open the old version of these files and copy and paste relevant configuration information into the new version.