IIS7

Enable Classic ASP, Server Side Includes, and ASP.NET

When you are adding the Web Server (IIS) role to Windows Server 2008 that the ASP feature is not added by default.

Start Server Manager select the Web Server (IIS) Role. Click on Add Role Services. Make sure you have ASP and Server Side Includes and ASP.NET selected.

Also select the IIS 6 Management Compatibility features which are found near the bottom of the list of features.

Create a Application Pool

You need to run each of your Dovetail web applications in their own Application Pool.

  1. To open IIS Manager, select Start - type IIS, and select Internet Information Services (IIS) Manager
  2. Click on your computer host name to expand the top-level node.
  3. Click on Application Pools
  4. Right-click on Application Pools and choose Add Application Pool
  5. Enter a name, such as DovetailAgent_AppPool
  6. Set the Managed Pipeline Mode to Classic
  7. Set the .NET Framework Version to version 2. If version 2 is not available, select version 3.5.
  8. If you are running a 64bit operating system, and using the 32-bit Dovetail SDK, you will need to Enable 32-Bit Applications for the Application Pool. Click on Advanced Settings… Set Enable 32-Bit Applications to True. Note that his is not the recommendation configuration.
    The recommendation is to use the 64-bit Dovetail SDK on 64-bit systems, and leave the Enable 32-Bit Applications application pool setting set to False.

Create the web application(s)

  1. To open IIS Manager, select Start - type IIS, and select Internet Information Services (IIS) Manager
  2. Click on your computer host name to expand the top-level node.
  3. Right-click Default Web Site and select Add Application
  4. In the Alias text box, type a short name (alias) for the directory into which the Dovetail Agent product was installed (i.e. agent). The alias is what users see as part of the URL path when they are browsing to the Dovetail Agent web application (for example, http://www.MyCompany.com/< agent >).
  5. Enter the path, or browse to the directory which contains the Dovetail Agent web application files (the pages folder under the installation directory).
  6. Select the Application Pool that you created earlier
  7. Select OK.
  8. To create two more required virtual directories, use the same process as you did in steps 1-7. These directories should be named 'uploads' and 'attachments'. The names 'uploads' and 'attachments' must match the values you set in the global.asa file step (see the Modify the global.asa file section for more information). You can use other names, as long as they match.The 'uploads' directory is just a temporary directory for attachments uploaded on your web server machine; The 'attachments' application should point to the location where your attachments will be stored;
  9. Close the ISM.

Enable Parent Paths

Parent Paths need to be enabled when an asp page includes a script with a path containing a ".." An example would be:

<!--#include file="../include/inc_room.asp"-->

Dovetail Agent does use parent paths.

  1. Navigate to your web application in IIS7 Manager.
  2. Click on ASP.
  3. Set Enable Parent Paths to True.
  4. Click on Apply.

Enforce Compatibility Level

For Dovetail Agent to work with all versions of MS Internet Explorer equal to and higher than 8, a proper HTTP Response Header must be set:

  1. Navigate to your web application in IIS7 Manager.
  2. Click on HTTP Response Headers.
  3. On Actions pane, click Add.
  4. Use X-UA-Compatible as a header name and IE=5 as a value.

Click OK to save.

Send Script Errors To The Browser

When you try to browse your web application you may run into this message telling you... "Something went going wrong but sorry I won't tell you what." That error looks like this:"

An error occurred on the server when processing the URL. Please contact the system administrator.
If you are the system administrator please click here to find out more about this error.

To see the actual error, you can configure the application to send errors to the browser. This is helpful when debugging a problem.

  1. Navigate to your web application in IIS7 Manager.
  2. Click on ASP.
  3. Expand the Debugging section
  4. Set Send Errors to Browser to True.
  5. Click on Apply.

Additional Information on configuring ASP applications on IIS7 is available online.

If you are using a remote file server for storage of attachments, refer to: Set IIS Configuration and Permissions for Remote File Attachments

See Also

Configure the Web Server

IIS6

Set IIS Configuration and Permissions for Remote File Attachments

Next

Set IIS Configuration and Permissions for Remote File Attachments

IIS7