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.
Make sure ASP.NET v4 is properly registered with IIS
Depending on the sequence of install and role addition operations it may happen that ASP.NET v4 is not properly registered with IIS.
To verify, open a Command Prompt window as an Administrator, navigate to C:\Windows\Microsoft.NET\Framework\v4.0.30319 folder, and execute this command: aspnet_regiis -lv
The output produced should contain a line like this one:
If your server is a 64-bit machine, you may need to do the same from C:\Windows\Microsoft.NET\Framework64\v4.0.30319 folder.
Note: It's important that the 4.0.30319.0 version of ASP.NET is set as Root. Your system is likely to have multiple versions of ASP.NET installed. If the 4.0.30319.0 version of ASP.NET is not listed as the Root one, execute aspnet_regiis.exe -i and follow with aspnet_regiis.exe -lv to verify.
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
Click OK to create the Application Pool.
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 Admin 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 Admin web application (for example, http://www.MyCompany.com/< agent >).
Select Next.
Enter the path, or browse to the directory which contains the Dovetail Admin 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.
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 Admin web application, choose Properties. In the Application Pool drop-down list, select the application pool created above.
Click on the ASP.Net Tab. In the ASP.Net Version drop down select version 4.0.x of the Microsoft .Net Framework.
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 Admin does use parent paths.
Navigate to your web application in IIS Manager.
Right click on the virtual root(s) you created for Dovetail Admin 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 Admin 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 Admin 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.
Make sure all managed modules can process all requests
Dovetail Admin ships with web.config file containing this setting:
It is required on Windows Server 2008 or earlier. If not present, it may cause HTTP error 404 on clone and delete actions against user-defined pop-up list element.
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 Admin 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 Admin.
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.
If you are using a remote file server for storage of attachments, refer to:Set IIS Configuration and Permissions for Remote File Attachments
