Configure Apache

In this topic

Modify the Apache configuration file
Set file access permissions

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 C:\Program Files (x86)\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 (for example, an administrator). 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 “C:/Program Files (x86)esrimaps/em4c/cgi-bin-64bit”
<Directory “C:/Program Files (x86)/esrimaps/em4c/cgi-bin-64bit”>
AllowOverride None
Options None
Order allow,deny
Allow from all
</Directory>

Alias /ibmcognos/em4c “C:/Program Files (x86)/esrimaps/em4c/webcontent”
<Directory “C:/Program Files (x86)/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

In a vast majority of environments, Apache will be installed as a Windows service. The Apache documentation recommends that a separate account (with reduced permissions) be created for running the Apache service. This account (local or domain) requires specific access permissions to the EM4C temp directory and files so that the EM4C technology pieces can access and modify the contents as necessary.

Windows 2008

In Windows Explorer, right-click the Esri Maps for IBM Cognos temp directory and choose Properties.
On the temp Properties dialog box, click the Security tab.
On the Security tab, click Edit.
On the Permissions for temp dialog box, click Add.
On the Select Users, Computers, Service Accounts, or Groups dialog box, click Locations.
On the Locations dialog box, select the correct location for <Apache service account> and click OK.
In the Enter the object names to select text area, type <Apache service account> and click Check Names to verify the account can be found.
Click OK to close the Select Users or Groups dialog box.
On the Permissions for temp dialog box, choose <Apache service account> in the Group or user names area and check Allow beside Modify in the Permissions for <Apache service account>.
Click OK to close the Permissions for temp dialog box.
Click OK to close the temp Properties dialog box.

Feedback on this topic?