Permalink
Switch branches/tags
Nothing to show
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
85 lines (60 sloc) 5.38 KB

IIS6

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.

  1. Open the Manage Server Console (Start menu->Manage Your Server in the upper-left of the Start Menu)
  2. 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.

  1. Open the IIS Manager(Start->Administrative Tools->Internet Information Services (IIS) Manager)
  2. Expand the Internet Information Services (IIS) Manager in the tree view on the left and then expand your computer's tree node.
  3. Click on the "Web Service Extensions" node.
  4. Click on "Active Server Pages" then click the "Allow" button.
  5. Click on "Server Side Includes" then click the "Allow" button.

Create an Application Pool

  1. Open 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 Dovetail Bolt_AppPool

Create the web application

  1. Open Internet Information Services (IIS) Manager

  2. Click the tree node icon on your computer host name (or double-click the computer host name) to expand the top-level node.

  3. Within the Web Sites node, right-click Default Web Site and select New and Virtual Directory.

  4. In the Virtual Directory Creation Wizard, select Next to continue.

  5. In the Alias text box, type a short name (alias) for the directory into which the Dovetail Bolt product was installed (i.e. Bolt). The alias is what users see as part of the URL path when they are browsing to the Dovetail Bolt web application, for example:

    http://www.MyCompany.com/Bolt
  6. Select Next.

  7. Enter the path, or browse to the directory which contains the Dovetail Bolt web application files (the 'pages' folder under the installation directory).

  8. Select Next and set the access permissions to Read and Run Scripts.

  9. Select Next and then Finish.

  10. 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.

  11. Right-click on the root of your Dovetail Bolt 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 Bolt does use parent paths.

  1. Navigate to your web application in IIS Manager.
  2. Right click on the virtual root(s) you created for Dovetail Bolt and select Properties
  3. On the "Virtual Directory" tab of the property page that appears, click the "Configuration" button under the "Application Settings" section.
  4. Click on the "Options" tab of the new property page that appears
  5. Check the Enable Parent Paths checkbox.

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 IIS Manager.
  2. Right click on the virtual root(s) you created for Dovetail Bolt and select Properties
  3. On the "Virtual Directory" tab of the property page that appears, click the "Configuration" button under the "Application Settings" section.
  4. Click on the "Debugging" tab of the new property page that appears
  5. Click on the Send detailed ASP messages to client option.

Grant filesystem permissions to the IUSR_[COMPUTERNAME] user

  1. Open My Computer or an Explorer window and navigate to the location which you installed Dovetail Bolt.
  2. Right-click on the directory and click Properties.
  3. Click the "Security' tab.
  4. Click "Add" to add a new group/user.
  5. For the object name to select, type: [COMPUTERNAME]\IUSR_[COMPUTERNAME] where [COMPUTERNAME] is the Windows computer/host name of your Server (i.e. WEBSVR01).
  6. Click OK.
  7. 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.