Configure Apache
Viewing: Install on WindowsInstall on Linux and UNIX
In this topic
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 the Apache configuration file
To successfully run Esri Maps for IBM Cognos, the main Apache 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 code sample creates one script alias named cgi-bin and one alias named em4c. For Esri Maps for IBM Cognos to function properly, these names cannot be changed. The following assumes that Esri Maps for IBM Cognos has been installed in /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>Note:
If Windows Authentication is enabled in your environment, ensure that the following folders have Anonymous Authentication enabled and Windows Authentication disabled:
- <em4c_location>\webcontent\emf\3.16\esri\
- <em4c_location>\webcontent\emf\3.16\esri-maps\
- <em4c_location>\webcontent\esrimap\
- <em4c_virtualdirectory>\emf\3.16\esriMapsX\
Set file access permissions
The account under which Apache runs must have READ/WRITE/EXECUTE access to the temp directory and files. There are two approaches to meeting this requirement. Choose one of the following:
- If the 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 and files.