Skip to main content
pdf?stylesheet=default
Blackboard Help

Configuring Windows Server 2008 IIS 7 Roles and Features

Before You Begin

Windows Server 2008 uses IIS 7. Before installation of Blackboard Learn 9.1, IIS 7 needs to be configured with specific Role Services and other settings.

Blackboard recommends that you do not manually edit the %windir%\system32\inetsrv\config\applicationHost.config file to configure these options. This will result in errors that require a backup and restore of the last known good backup of the IIS 7 configuration that was managed by the IIS.

If you manually backed up the applicationHost.config file, restoring this manual backup and restarting IIS 7 will not fix errors generated by manually editing this file to configure IIS 7.

By default, IIS 7 will check every two minutes for changes to the configuration files and will automatically create backups of them, maintaining a history of ten backups. Use the oldest of these backups to restore IIS 7 to a working state.

%windir%\system32\inetsrv\appcmd.exe list backup%windir%\system32\inetsrv\appcmd.exe restore backup "CFGHISTORY_0000000021"

Once the configuration has been restored and verified through web browser access, then use the appcmd utility to configure the necessary features of IIS 7 as described in the section above.

If this approach does not solve the problem with IIS 7 generating errors, remove and then reinstall the IIS 7 Role.

If you need to reinstall the IIS 7 Role, you can use the %BLACKBOARD%\tools\admin\WebsiteReinstall.bat command to re-establish the Blackboard Web site within IIS.

To avoid installation errors, the User Account Control settings should be set to Never Notify.

How to Configure Windows Server 2008 IIS 7 Roles and Features

  1. Install the IIS 7 Role in Windows Server 2008 Server Manager and configure Role Services:
    1. Click Start, select Administrative Tools, and then select Server Manager.
    2. Click Roles, and under the Roles Summary heading, click Add Roles.
    3. From the list of displayed roles, select Web Server (IIS).
    4. Click Next.

      Required Role Services:

      Recommended Role Services:

      Optional Role Services:

      Do not enable the WebDAV role service. Enabling the WebDAV role service within IIS 7 will cause mapping issues with Blackboard Learn.

      • Role Services > Web Server > Application Development > ISAPI Extensions
      • Role Services > Web Server > Application Development > ISAPI Filters
      • Role Services > Web Server > Performance > Static Content Compression
      • Role Services > Web Server > Performance > Dynamic Content Compression
      • Role Services > Management Tools > IIS 6 Management Compatibility > IIS 6 Metabase Compatibility
      • Role Services > Management Tools > IIS 6 Management Compatibility > IIS 6 WMI Compatibility
      • Role Services > Management Tools > IIS 6 Management Compatibility > IIS 6 Scripting Tools
      • Role Services > Web Server > Common HTTP Features > HTTP Errors
      • Role Services > Web Server > Health and Diagnostics > HTTP Logging
      • Role Services > Management Tools > IIS Management Console
      • Role Services > Management Tools > IIS 6 Management Scripts and Tools
      • Role Services > Security > Windows Authentication (This authentication type is not recommended, and should only be used if you plan to perform a legacy authentication integration with Active Directory using webserver authentication. The preferred method for integration with Active Directory is by using the LDAP authentication provider.)
    5. Select Windows Process Activation Service (.NET Environment), and then click Add Required Role services.
  2. Disable the Default Web Site:
    1. Click Start, select Administrative Tools, and then select Server Manager.
    2. From the left menu, click the plus sign next to Roles to expand the tree.
    3. Click the plus sign next to Web Server IIS, and then click Internet Information Services (IIS) Manager.
    4. Under the Connections heading, click the plus sign next to the %HOSTNAME%, and then click the plus sign next to Sites.
    5. Right-click Default Web Site and from the drop-down menu select Manage Web Site, and then select Stop.
  3. Back up the current IIS 7 configuration and verify.
    1. %windir%\system32\inetsrv\appcmd.exe add backup "Blackboard Pre-Change"
    2. %windir%\system32\inetsrv\appcmd.exe list backup
  4. Modify the IIS 7 configuration to permit double escaping within URLs (applies to all sites).
    1. %windir%\system32\inetsrv\appcmd set config /section:system.webServer/Security/requestFiltering -allowDoubleEscaping:True
  5. Modify the IIS 7 configuration to allow upload files greater than 20MB and up to 100MB in size, specified in bytes (applies to all sites).
    1. %windir%\system32\inetsrv\appcmd set config -section:requestFiltering -requestLimits.maxAllowedContentLength:104857600
  6. Modify the IIS configuration to allow larger query string limits
    1. %windir%\system32\inetsrv\appcmd set config /section:requestFiltering /requestLimits.maxQueryString:4096
  7. Back up the current IIS 7 configuration and verify.
    1. %windir%\system32\inetsrv\appcmd.exe add backup "Blackboard Post-Change Backup"
    2. %windir%\system32\inetsrv\appcmd.exe list backup
  8. Restart the IIS service.
    1. Click Start, select Administrative Tools, and then select Server Manager.
    2. From the left menu, click the plus sign next to Configuration and then click Services.
    3. From the list of services, right-click World Wide Web Publishing Service and select Restart.