IIS 4 and 5 Setup

A virtual directory is created in IIS which points to the FogBugz Website folder.
(By default this is C:\Program Files\FogBugz\website)

The following settings are made in the IIS metabase. All but the last one, UploadReadAheadSize, can be set using the IIS management console (Internet Information Services Manager).

• An application is created for this directory. By default it is named FogBugz.
  
• Access flags are set to read only/scripts only, Directory browsing is disabled.
• • IIS Properties dialogue > Virtual Directory tab (or Home Directory tab if using root folder):
    Read should be checked off. The following should not be checked off: Script source access, Write, Directory Browsing. Execute Permissions should be "Scripts only".
    
• The following are set to TRUE: AspAllowSessionState, AspBufferingOn, EnableParentPaths, AspSessionTimeout is set to 60 minutes.
• • Virtual Directory tab > click Configuration > App Options tab:
    These should all be checked: Enable session state (set to 60 minutes), Enable buffering, Enable parent paths.
    
• The default document is set to default.asp.
• • Documents tab
    
• Authorization is set to Anonymous account ONLY.
• • Directory Security tab > Edit... Anonymous Access:
    "Anonymous access" should be checked off, "Integrated Windows authentication" should not.
    
•  The account for anonymous access user and password are set. By default this is the "FogBugz" user account.
• • Edit... Account used
    
    
• AnonymousPasswordSync is set to FALSE.
• • "Allow IIS to control password" must be un-checked.
    
• The 500;100 error handler (Windows 2000 and later) is set to internalError.asp.
• Custom Errors tab 

The following setting is changed, which cannot be accessed using the IIS console:

• UploadReadAheadSize is set to 0x40000000

To modify this setting, which is required for file uploads to work correctly in FogBugz, you will need to modify the IIS MetaBase directly. For IIS 4 and 5, you will need an application available from Microsoft called the MetaBase editor (MetaEdit).