Esri Maps for IBM Cognos (v6.0 Archive)

In this topic
  1. Configure an application pool
  2. Create the virtual directories
  3. Create an application for cgi-bin
  4. Configure IIS for EM4C CGI Gateway
  5. Set file access permissions

This is an archive related to a previous version of Esri Maps for IBM Cognos. If you need the current version go to http://doc.arcgis.com/en/maps-for-cognos/.

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

You must configure Microsoft Internet Information Services to work with Esri Maps for IBM Cognos if the following conditions are true:

  • IBM Cognos Business Intelligence has already been set up to work with Microsoft Internet Information Services (IIS) 7.x or 8.x
  • IBM Cognos runs in the default web site
  • The IBM Cognos virtual directory is named ibmcognos.

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 7 or IIS 8 computer.

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 will create an application pool named EM4CAppPool.

  1. Open the Internet Information Services Manager.
    1. Click Start > All > Accessories > Run.
    2. In the Open box, type inetmgr and click OK.
  2. Expand <server name>.
  3. Right-click Application Pools and select Add Application Pool.
  4. Provide the required details in 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: Checked
  5. 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 in order for Esri Maps for IBM Cognos to 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).

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

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).

  1. In the IIS Manager left explorer pane, find the em4c virtual directory previously created.
  2. Right-click the em4c virtual directory and select Add Application.
  3. 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
  4. Click OK to save the changes.

Configure IIS for EM4C CGI Gateway

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

  1. Add the new module as an allowed extension so IIS is not blocking its execution (that is, set the CGI restrictions).
  2. Add a module mapping to handle requests for the EM4C CGI module.
  3. Configure properties for CGI applications.
  4. If necessary, set anonymous authentication credentials.
  5. 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.

  1. In the IIS Manager Connections pane on the left, select <web server name>.
  2. In the content pane, select the Features View tab at the bottom.
  3. Double-click ISAPI and CGI Restrictions (this brings up the list of defined restrictions in the middle pane of IIS Manager).
  4. In the upper-right Actions pane, click Add.
  5. Provide the required details in 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
    2. Description: EM4C-CGI (for example)
    3. Allow extension path to execute: Checked
  6. Click OK.

Add module mapping for CGI

  1. In the left Connections pane of IIS Manager, select Default Web Site > ibmcognos > em4c > cgi-bin.
  2. Select the Features View from the lower bar in the middle pane.
  3. Double-click Handler Mappings in the middle pane.
  4. In the upper-right Actions pane, click Add Module Mapping.
  5. 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
  6. Click OK.
  7. On the Handler Mapping page, EM4C-CGI will appear as Enabled.
  8. With the newly created EM4C-CGI mapping selected, click Edit Feature Permissions from the upper-right Actions pane.
  9. In the Edit Feature Permissions dialog box, check the Execute check box to enable CGI execution.
  10. Click OK.

Set properties for CGI applications

  1. In the left Connections pane of IIS Manager, select Default Web Site > ibmcognos > em4c > cgi-bin.
  2. Select the Features View from the lower bar in the middle pane.
  3. Double-click CGI in the middle pane.
  4. Set Impersonate User [createProcessAsUser] to False.
  5. In the upper-right Actions pane, click Apply.
  6. 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).
  7. In the Actions pane on the right, click Restart under the Manage Web Site category.
  8. 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.

  1. In the left Connections pane of IIS Manager, select Default Web Site > ibmcognos > em4c > cgi-bin.
  2. Select the Features View from the lower bar in the middle pane.
  3. Double-click Authentication in the middle pane.
  4. Right-click Anonymous Authentication and click Edit.
  5. In the Edit Anonymous Authentication Credentials dialog box, select the Application pool identity option as the anonymous user identity. Click OK.
  6. In the IIS Manager Connections pane, select the web site in which IBM Cognos and Esri Maps for IBM Cognos run (for example, Default Web Site).
  7. In the Actions pane on the right, click Restart under the Manage Web Site category.
  8. 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, 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.

  1. In Windows Explorer, right-click the Esri Maps for IBM Cognos temp directory and click Properties.
  2. On the temp Properties dialog box, click the Security tab.
  3. On the Security tab, click Edit.
  4. On the Permissions for temp dialog box, click Add.
  5. On the Select Users, Computers, Service Accounts, or Groups dialog box, click Locations.
  6. On the Locations dialog box, select the <local server you are working on> and click OK.
  7. In the Enter the object names to select text area, type IIS AppPool\EM4CAppPool and click Check Names.
  8. Click OK to close the Select Users or Groups dialog box.
  9. 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.
  10. Click OK to close the Permissions for temp dialog box.
  11. Click OK to close the temp Properties dialog box.