Skip To Content

About Apache configuration

In this topic

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 rather 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, you should 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.

For instructions on configuring Apache to work with Esri Maps for IBM Cognos, see Configure Apache.

MIME types

Multipurpose Internet Mail Extensions (MIME) types identify the types of content that can be served to a browser from a web server. Esri Maps for IBM Cognos requires the following MIME types, which are already configured in the default list of global MIME types on Apache:

  • application/javascript
  • application/octet-stream
  • application/pdf
  • application/xml
  • image/gif
  • image/jpeg
  • image/png
  • image/svg+xml
  • text/css
  • text/html
  • text/plain