Configure Microsoft Internet Information Services 7.x or 8.x

In this topic

MIME types
Configure an application pool
Create the virtual directories
Create an application for cgi-bin
Configure IIS for EM4C CGI Gateway
Set file access permissions

This topic assumes IBM Cognos Business Intelligence has already been set up to work with Microsoft Internet Information Services (IIS) 7.x or 8.x. The following steps should be completed on each EM4C Gateway computer in your environment and performed by a user who is part of the administrators group on the IIS computer.

Note:

The steps in this topic assume that IBM Cognos runs in the default website and the IBM Cognos virtual directory is named ibmcognos. Modify the steps as necessary to match your configuration.

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 in IIS:

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

Configure an application pool

The Esri Maps for IBM Cognos EM4C Gateway modules must be executed in the context of an IIS 7.x or 8.x application pool. While it's most convenient to use the default application pool, it's recommended that you define an additional application pool.

The following steps create an application pool named EM4CAppPool.

Open Internet Information Services Manager.
1. Click Start > All > Accessories > Run.
2. In the Open box, type inetmgr and click OK.
Expand <server name>.
Right-click Application Pools and choose Add Application Pool.
Provide the required details on the Add Application Pool dialog box.
1. Name: EM4CAppPool
2. .NET Framework version: NET Framework v2.0.50727.
3. Managed pipeline model: Integrated
4. Start application pool immediately: Check this.
Click OK.

Create the virtual directories

Microsoft IIS serves its content to clients by exposing a virtual directory tree. Both Esri Maps for IBM Cognos content and IBM Cognos content must be served as subdirectories of the IBM Cognos virtual directory.

Esri Maps for IBM Cognos content must be served from the same domain (and port) as IBM Cognos content. The following steps outline the creation of a virtual directory: em4c. These directory names cannot be changed or Esri Maps for IBM Cognos will not function properly. This topic assumes that IBM Cognos runs in the default website and that the IBM Cognos virtual directory is named ibmcognos (for example, http://cognosserver/ibmcognos).

Open Internet Information Services Manager.
1. Click Start > All > Accessories > Run.
2. In the Open box, type inetmgr and click OK.
In the IIS Manager left explorer pane, expand Sites and expand Default Web Site.
Right-click the ibmcognos virtual directory and choose Add Virtual Directory.
Provide the required details for the Add Virtual Directory dialog box.
1. Alias: em4c
2. Physical path: <em4c_location>\webcontent
Click OK.

Note:

If Windows Authentication is enabled in your environment, ensure that the following virtual directory folders have Anonymous Authentication enabled and Windows Authentication disabled:

<em4c virtualdirectory>\emf\3.16\esri\
<em4c virtualdirectory>\emf\3.16\esri-maps\
<em4c virtualdirectory>\esrimap\
<em4c virtualdirectory>\emf\3.16\esriMapsX\

Create an application for cgi-bin

Creating an IIS application for cgi-bin maps the EM4C Gateway modules to the application pool in which the IBM Cognos website runs (for example, Default Web Site).

In the IIS Manager left explorer pane, find the em4c virtual directory previously created.
Right-click the em4c virtual directory and choose Add Application.
Provide the required details in the Add Application dialog box.
1. Alias: cgi-bin
2. Application pool: EM4CAppPool
3. Physical path: <em4c_location>\cgi-bin or <em4c_location>\cgi-bin-64bit
Click OK to save the changes.

Configure IIS for EM4C CGI Gateway

For EM4C CGI Gateway to work, you must do the following:

Add the new module as an allowed extension, so IIS is not blocking its execution (that is, set the CGI restrictions).
Add a module mapping to handle requests for the EM4C CGI module.
Configure properties for CGI applications.
If necessary, set anonymous authentication credentials.
Set file access permissions.

For more information on these steps, see the sections that follow.

Set the CGI restrictions

The Common Gateway Interface (CGI) role is not included in the default installation of IIS 7.x or 8.x. To complete the following steps, you must first install the CGI role service. On Windows Server 2008, you do this by going to Server Manager > Roles > Add Role Services.

In the IIS Manager Connections pane on the left, select <web server name>.
In the Contents pane, click the Features View tab at the bottom.
Double-click ISAPI and CGI Restrictions (this brings up the list of defined restrictions in the middle pane of IIS Manager).
In the upper right Actions pane, click Add.
Provide the required details on the Add ISAPI or CGI Restriction dialog box.
1. ISAPI or CGI Path: <em4c_location>\cgi-bin\em4c.cgi or <em4c_location>\cgi-bin-64bit\em4c.cgi
  Note:
  If browsing for em4c.cgi, change the file type to All files (*.*), since .cgi is not a default suffix.
2. Description: EM4C-CGI (for example)
3. Allow extension path to execute: Check this.
Click OK.

Add module mapping for CGI

In the left Connections pane of IIS Manager, click Default Web Site > ibmcognos > em4c > cgi-bin.
Choose Features View from the lower bar in the middle pane.
Double-click Handler Mappings in the middle pane.
In the upper right Actions pane, click Add Module Mapping.
Provide the required details for the Add Module Mapping dialog box:
1. Request path: *.cgi
2. Module: CgiModule (fastCGIModule is not supported)
3. Executable (optional): <leave blank>.
4. Name: EM4C-CGI
Click OK.
On the Handler Mapping page, EM4C-CGI appears Enabled.
With the newly created EM4C-CGI mapping selected, click Edit Feature Permissions in the upper right Actions pane.
On the Edit Feature Permissions dialog box, check the Execute check box to enable CGI execution.
Click OK.

Set properties for CGI applications

In the left Connections pane of IIS Manager, click Default Web Site > ibmcognos > em4c > cgi-bin.
Choose Features View from the lower bar in the middle pane.
Double-click CGI in the middle pane.
Set Impersonate User [createProcessAsUser] to False.
In the upper right Actions pane, click Apply.
In the IIS Manager Connections pane, select the website in which IBM Cognos and Esri Maps for IBM Cognos run (for example, Default Web Site).
In the Actions pane on the right, click Restart under the Manage Web Site category.
Close IIS Manager.

Set anonymous authentication credentials

If you are configuring IIS 8.0 or 8.5, you will need to set the anonymous authentication credentials for the cgi-bin application.

In the left Connections pane of IIS Manager, click Default Web Site > ibmcognos > em4c > cgi-bin.
Choose Features View from the lower bar in the middle pane.
Double-click Authentication in the middle pane.
Right-click Anonymous Authentication and click Edit.
On the Edit Anonymous Authentication Credentials dialog box, choose the Application pool identity option as the anonymous user identity. Click OK.
In the IIS Manager Connections pane, select the website in which IBM Cognos and Esri Maps for IBM Cognos run (for example, Default Web Site).
In the Actions pane on the right, click Restart under the Manage Web Site category.
Close IIS Manager.

Set file access permissions

The EM4C technology pieces need access to read and modify the contents of the EM4C temp directory. To do this, you must give specific access permissions to the identity that the EM4CAppPool runs as. When the EM4CAppPool was configured above, the default settings were accepted. This means the application pool will be running as IIS AppPool\EM4CAppPool. If your application pool is not running as this account (for example, if it uses a built-in account such as Network Service, Local System, or Local Service, or as a specific local or domain user identity), modify the following steps as necessary.

In Windows Explorer, right-click the Esri Maps for IBM Cognos temp directory and click 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 <local server you are working on> and click OK.
In the Enter the object names to select text area, type IIS AppPool\EM4CAppPool and click Check Names.
Click OK to close the Select Users or Groups dialog box.
On the Permissions for temp dialog box, select EM4CAppPool in the Group or user names area and check Allow beside Modify in the Permissions for EM4CAppPool area.
Click OK to close the Permissions for temp dialog box.
Click OK to close the temp Properties dialog box.

Note:

For some early releases of Windows 2008, this procedure may not work as described. If this is the case in your environment, you can still manipulate the access control list for the application pool’s identity. The following command can be run from the command prompt (cmd.exe) as an administrator. Modify the location of the temp directory and the name of the application pool to suit your environment.

ICACLS "C:\Program Files (x86)\EsriMaps\em4c\temp" /grant "IIS AppPool\EM4CAppPool":F /t

Feedback on this topic?