Uninstall Esri Maps for IBM Cognos
In this topic
- Disable
Esri Maps for IBM Cognos - Disable
Esri Maps for IBM Cognos silently - Remove the web server components
- Delete (or rename) installed files
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. 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.
Perform the following as a user with administrative privileges.
- Return IBM Cognos files to their original state as follows:
- Browse to the <em4c_location>\bin directory and launch configure.bat.
- Click the Disable button.
- From the File menu, click Exit.
- Restart the IBM Cognos service. Refer to the IBM Cognos Installation and Configuration Guide for more information.
Note:
The name of the Esri Maps for IBM Cognos service is EM4C<port>. For example, if the EM4C Server HTTP Port is 1234, the service is named EM4C1234. When you disable Esri Maps for IBM Cognos, the service is automatically stopped and removed from Windows services. If you are disabling Esri Maps for IBM Cognos and you note that you have an orphaned EM4C service, you can delete it as follows in a command prompt running as an administrator:
sc stop EM4C1234
sc delete EM4C1234Disable Esri Maps for IBM Cognos silently
Esri Maps for IBM Cognos can be disabled silently. Perform the following as a user with administrative privileges.
- In a command prompt (cmd.exe) running as an administrator, browse to the <em4c_location>\bin directory.
- Type the following: configure.bat -remove.
- Restart the IBM Cognos service. Refer to the IBM Cognos Installation and Configuration Guide for more information.
Note:
The name of the Esri Maps for IBM Cognos service is EM4C<port>. For example, if the EM4C Server HTTP Port is 1234, the service is named EM4C1234. When you disable Esri Maps for IBM Cognos, the service is automatically stopped and removed from Windows services. If you are disabling Esri Maps for IBM Cognos and you note that you have an orphaned EM4C service, you can delete it as follows in a command prompt running as an administrator:
sc stop EM4C1234
sc delete EM4C1234Remove 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.
Note:
There were files added to IBM Cognos by the Esri Maps for IBM Cognos installation process. You can safely delete those files at this time or leave them alone. They will not affect the normal operation of IBM Cognos.