Note: The following assumes IIS version 6.0 on Microsoft Windows 2003. Your system may vary slightly.
Install IIS
First, in order to run ASP applications, you must have the Internet Information Server installed. This is installed as part of the "Application Server" role.
Open the Manage Server Console (Start menu->Manage Your Server in the upper-left of the Start Menu)
If the "Application Server" role is not already listed, click "Add or Remove role" and select the Application Server role.
Enable Classic ASP, Server Side Includes, and ASP.NET
ASP is disabled by default on Windows 2003. You must explicitly enable ASP and Server Side Includes.
Open the IIS Manager(Start->Administrative Tools->Internet Information Services (IIS) Manager)
Expand the Internet Information Services (IIS) Manager in the tree view on the left and then expand your computer's tree node.
Click on the "Web Service Extensions" node.
Click on "Active Server Pages" then click the "Allow" button.
Click on "Server Side Includes" then click the "Allow" button.
Create an Application Pool
Open Internet Information Services (IIS) Manager
Click on your computer host name to expand the top-level node.
Click on Application Pools
Right-click on Application Pools and choose Add Application Pool
Enter a name, such as Dovetail Agent_AppPool
Create the web application(s)
Open Internet Information Services (IIS) Manager
Click the tree node icon on your computer host name (or double-click the computer host name) to expand the top-level node.
Within the Web Sites node, right-click Default Web Site and select New and Virtual Directory.
In the Virtual Directory Creation Wizard, select Next to continue.
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 >).
Select Next.
Enter the path, or browse to the directory which contains the Dovetail Agent web application files (the 'pages' folder under the installation directory).
Select Next and set the access permissions to Read and Run Scripts.
Select Next and then Finish.
Create two more required virtual directories, using the Virtual Directory Creation Wizard as you did in steps 5-10. 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; this directory must have access permissions set to Read, Write, and Run Scripts. The 'attachments' virtual directory should point to the location where your attachments will be stored; this directory must have access permissions set to Read and Run Scripts.
In the left pane of the Internet Information Services (IIS) Manager, select Default Web Site, and then press the F5 key to refresh the list of virtual folders.
Right-click on the root of your Dovetail Agent web application, choose Properties. In the Application Pool drop-down list, select the application pool created above. Choose OK.
Note: Notice that the virtual folder of your newly created application appears under the alias name you supplied previously. Also note that the icon for your virtual folder appears as a yellow gear icon. This means that your application is set up and ready to host ASP pages.
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.
Navigate to your web application in IIS Manager.
Right click on the virtual root(s) you created for Dovetail Agent and select Properties.
On the "Virtual Directory" tab of the property page that appears, click the "Configuration" button under the "Application Settings" section.
Click on the "Options" tab of the new property page that appears
Check the Enable Parent Paths checkbox.
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:
Navigate to your web application in IIS Manager.
Right click on the virtual root you created for Dovetail Agent and select Properties.
Click on HTTP Headers tab.
Within Custom HTTP headers group, click Add.
Use X-UA-Compatible as a header name and IE=5 as a value.
Click OK, then Apply.
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.
Navigate to your web application in IIS Manager.
Right click on the virtual root(s) you created for Dovetail Agent and select Properties
On the "Virtual Directory" tab of the property page that appears, click the "Configuration" button under the "Application Settings" section.
Click on the "Debugging" tab of the new property page that appears
Click on the Send detailed ASP messages to client option.
Grant filesystem permissions to the IUSR_[COMPUTERNAME] user
Open My Computer or an Explorer window and navigate to the location which you installed Dovetail Agent.
Right-click on the directory and click Properties.
Click the "Security' tab.
Click "Add" to add a new group/user.
For the object name to select, type: [COMPUTERNAME]\IUSR_[COMPUTERNAME] where [COMPUTERNAME] is the Windows computer/host name of your Server (i.e. WEBSVR01).
Click OK.
Highlight that user in the list of Groups or users with permissions to this folder and verify that the IUSR_* user has "Read & Execute", "List Folder Contents", and "Read" permissions.
