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/.
EM4C Gateway must be installed on each IBM Cognos Gateway computer in your environment.
EM4C Gateway can be installed and configured on its own or in combination with EM4C Server and/or EM4C Dispatcher. For more information, see Installation sequence for server components. For an example of an Esri Maps for IBM Cognos deployment, see Esri Maps for IBM Cognos architecture.
Before you begin the installation, ensure that there is an IBM Cognos Gateway directory on each computer on which you are installing EM4C Gateway.
It is recommended that the following steps be performed as the user who owns the IBM Cognos installation location.
Install Esri Maps for IBM Cognos components in a directory that contains only ASCII characters in the path.
[cognosuser@server1]$ ./launchInstaller.sh
[cognosuser@server1]$ chmod +x setPermissions.sh
[cognosuser@server1]$ ./setPermissions.sh
Configuration of EM4C Gateway requires an ordered, comma-separated list of the EM4C Servers in your environment. For more information, see Configuration.
Run Esri Maps for IBM Cognos Configuration as the user who owns the Esri Maps for IBM Cognos installation location (this user should have READ/WRITE/EXECUTE access to both the em4c_location and the cognos_location).
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.
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://<cognos_gateway>/ibmcognos/em4c/version.txt
http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi
http://<cognos_gateway>/ibmcognos/em4c/cgi-bin/em4c.cgi?
<arcgisUrl property specified in settings.js>/common/locationproviders/LocationProviders
If these tests fail to produce the expected results, there are two possible reasons: Esri Maps for IBM Cognos Configuration was not used (changes to the configuration were not saved/applied), or the web server is not configured properly.