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/.
A complete installation of Esri Maps for IBM Cognos involves installing components on your server and then configuring them to work in your environment. Before you begin, make sure you are familiar with the installation options and that you have the correct installer for the operating system on which you will be installing.
The following steps should be performed as an administrator.
G:\em4c\launchInstaller.bat
Before you complete the following steps, make sure you are familiar with the available configuration settings.
Run Esri Maps for IBM Cognos Configuration as a user with administrator privileges.
The Esri Maps for IBM Cognos EM4C Server must be started for all locations where the EM4C Server component was installed.
EM4C Server runs as a service and is configured to start automatically by default (it can be restarted manually using Microsoft Management Console).
In order for Esri Maps for IBM Cognos and IBM Cognos to communicate, you must create the virtual directories (aliases) listed in the following table. Note that it is assumed IBM Cognos is exposed on your web server as ibmcognos (modify to reflect your environment).
Alias | Location |
---|---|
ibmcognos\em4c | em4c_location\webcontent |
ibmcognos\em4c\cgi-bin | em4c_location\cgi-bin or em4c_location\cgi-bin-64bit, depending on your environment (x86 or x64) |
To learn more about web server configuration, see About web server configuration.
Changes applied in Esri Maps for IBM Cognos Configuration require that the IBM Cognos Service be restarted on any IBM Cognos Dispatcher computer running the report service and/or presentation service.
Refer to the IBM Cognos Installation and Configuration Guide for your version of IBM Cognos for details on how to restart the IBM Cognos Service.
At this point, all Esri Maps for IBM Cognos report authors and end users should clear their web browser cache. The instructions for this vary among browsers, but Ctrl+Shift+Delete will work in most browsers.
To enable the use of Esri Maps for IBM Cognos, the Esri Maps capability must first be created. Users who do not have the required permissions for this capability will not be able to use Esri Maps Designer or view Esri Maps in map-enabled reports.
The IBM Cognos system administrator creates this capability by opening Esri Maps Designer from the Launch menu in Cognos Connection. When you create the Esri Maps capability, users and groups are added based on the default settings for Cognos capabilities, and those default users and groups are given traverse and execute permissions for Esri Maps for IBM Cognos. To disable the use of Esri Maps for IBM Cognos, remove the execute permissions for the user or group in question. Permissions can be changed in Cognos Administration.
The capability is created.
After Esri Maps for IBM Cognos has been installed and configured, clear your web browser's cache (Ctrl+Shift+Delete on most browsers) if you haven't done so already. You can then test various aspects of the installation and configuration process.
In the following examples, it is assumed IBM Cognos is exposed by an ibmcognos alias.
http://<em4c_server>:9896/em4c/version.txt
If this test fails, make sure EM4C Server is started in all places where it is installed.
http://<cognos_gateway>/ibmcognos/em4c/version.txt
http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi
ArcGIS Online:http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://www.arcgis.com/sharing?f=pjson
Portal for ArcGIS instance:http://ibmcognosserver/ibmcognos/em4c/cgi-bin/em4c.cgi?http://myPortal/gis/sharing/?f=pjson
If the test is successful, the current version will be returned—for example, "currentVersion":"x.x".