Configure the web server

You must set up virtual directories, also known as web aliases, for the directories that contain the HTML and web files for IBM® Cognos Controller.

Before you begin

You must use Microsoft Internet Information Services (IIS) version 7 or later. To enable the required permissions for the cgi-bin directory, you must first enable CGI applications for your web server.

Procedure

  1. Click Start > Control Panel > Programs and Features.
  2. Click Turn Windows features on or off.
  3. Click Server Manager > Roles > Web Server (IIS).
  4. In Role Services, if HTTP Redirection is set to Not installed, select HTTP Redirection and click Add Role Service.
  5. If CGI is set to Not installed, select CGI and click Add Role Service.
  6. In the Internet Information Services (IIS) Manager, select your server name.
  7. Double-click ISAPI and CGI Restrictions, and click Add.
  8. Enter the path to the cognos.cgi file. The file is located in the ccr_location\cgi-bin directory.
    Note: The variable ccr_location/ refers to the installation location of IBM Cognos Controller. The default Controller installation location is C:\Program Files\IBM\Cognos\ccr_64

    You must enter the full path including the filename. If the path includes spaces, ensure that the path is enclosed in quotation marks; for example, use quotation marks as shown in the following path:

    "C:\Program Files\IBM\Cognos\ccr_64\cgi-bin\cognos.cgi"

  9. Select Allow extension path to execute, and click OK.
  10. Select Application Pools.
  11. Select Add Application Pool.
  12. Set the .Net Framework Version value to v2.0.50727.
  13. Enter a name for the application pool and click OK.
  14. Click Advanced Settings.
  15. Ensure that the .Net Framework Version value to v2.0.
  16. Ensure that the Enable 32-Bit Applications value is set to False (the default setting).
  17. Set the Identity value to LocalSystem.
  18. Click OK.
  19. Expand Sites and, under your web site, create the following virtual directories as shown in the table.
    Table 1. Required virtual directories
    Alias Location

    ibmcognos

    		 ccr_location/webcontent

    ibmcognos/cgi-bin

    		 ccr_location/cgi-bin

    ibmcognos/controller

    		 ccr_location/ccrvdir

    ibmcognos/controllerbin

    		 ccr_location/webcontent/ccr

    ibmcognos/controllerhelp

    		 ccr_location/webcontent

    You can use a name other than ibmcognos in the aliases. However, you must use cgi-bin as the second part of the alias, including the virtual directory in the Gateway URI property to match the new Cognos® alias.

    Remember: If you use ibmcognos in the web aliases and embed the aliases within other applications, such as Microsoft Excel reports, should you upgrade to a future version of IBM Cognos Controller, you must also update the embedded aliases.
  20. Select the cgi-bin virtual directory you created.
  21. Double-click Handler Mappings.
  22. Under Actions, click Add Module Mapping.
    1. In Request Path, type cognos.cgi.
    2. In Module, type CgiModule.
    3. Leave Executable (optional) blank.
    4. In Name, enter a name for the entry, such as CognosCGI.
    5. Click OK.
  23. Right-click the ibmcognos virtual directory, and click Add Application.
    1. In the Alias box, type controllerserver.
    2. In the Physical path box, enter ccr_location/ControllerProxyServer
  24. Select the controller virtual directory.
    1. Double-click HTTP Redirect.
    2. Select Redirect requests to this destination, and enter the following path:

      /ibmcognos/controllerbin/ccr.exe

  25. Click Apply and click OK.