Configure Apache

Before you can configure Apache, IBM Cognos Business Intelligence must be set up to work with the Apache HTTP Server (or an Apache-based web server) and the IBM Cognos alias must be named ibmcognos.

For more information about Apache configuration, see About Apache configuration.

The following steps should be completed on each EM4C Gateway computer in your environment.

Modify Apache's configuration file

To successfully run Esri Maps for IBM Cognos, Apache’s main configuration file (httpd.conf) must be modified to add the appropriate Esri Maps for IBM Cognos aliases and script aliases. Before you begin, take note of the EM4C cgi-bin directory (as it pertains to your environment). It will be one of the following:

em4c_location/cgi-bin
em4c_location/cgi-bin-64bit

The following creates one script alias named cgi-bin and one alias named em4c. These names cannot be changed in order for Esri Maps for IBM Cognos to function properly. The following assumes that Esri Maps for IBM Cognos has been installed to /opt/esrimaps/em4c and that the changes to the Apache configuration file are made by a user who has write access to the Apache installation location. It is important that the em4c/cgi-bin script alias be defined before the em4c alias, and that Esri Maps for IBM Cognos aliases be defined before IBM Cognos aliases.

After adding the following aliases, restart the web server process.

ScriptAlias /ibmcognos/em4c/cgi-bin “/opt/esrimaps/em4c/cgi-bin-64bit�?
<Directory “/opt/esrimaps/em4c/cgi-bin-64bit�?>
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>

Alias /ibmcognos/em4c “/opt/esrimaps/em4c/webcontent�?
<Directory “/opt/esrimaps/em4c/webcontent�?>
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>

Set file access permissions

The account under which Apache runs must have READ/WRITE/EXECUTE access to the temp directory. There are two approaches to meeting this requirement. Choose one of the following:

If Apache web server runs under a specific group, change the EM4C temp directory's permissions to ensure that it belongs to the same group as the Apache web server. You can then set READ/WRITE/EXECUTE permissions for the group and remove permissions for others.
You can change ownership of the EM4C temp directory and assign READ/WRITE/EXECUTE permissions to the owners of the directory.

The account under which Apache runs must also have READ/EXECUTE access to the cgi-bin or cgi-bin-64bit directory.