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/.
This topic assumes IBM Cognos Business Intelligence has already been set up to work with the Apache HTTP Server (or an Apache-based web server) and that the IBM Cognos alias is named ibmcognos.
Apache is configured by placing directives in plain text configuration files. The main configuration file is usually named httpd.conf and is located in the apache_location/conf directory.
In Apache, the Alias directive allows documents to be stored in the local file system other than under the DocumentRoot. The URL path is case-sensitive (including case-insensitive file systems). Specify additional <Directory> sections to cover the destination of aliases. When you are creating an Alias to a directory outside of the DocumentRoot, you should permit access to the target directory.
The ScriptAlias directive tells Apache that a particular directory is set aside for CGI programs. Apache will assume that every file in this directory is a CGI program and attempt to execute it when that particular resource is requested by a client.
If IBM Cognos is already working in your environment, the following will be assumed. It is worth noting, however, that if your version of Apache has been built with shared module support, ensure that the required modules are loaded. In your httpd.conf file, ensure the LoadModule directive has not been commented out for the following modules:
LoadModule dir_module modules/mod_dir.so
LoadModule alias_module modules/mod_alias.so
LoadModule cgi_module modules/mod_cgi.so
If your organization uses the mod_deflate module (or any other compression module) to reduce the size of content before it is sent over the network, it is important to note that the EM4C cgi_bin directory should not have its content compressed. Your environment should be configured accordingly.