Doc/Tutorials/Deployment/IIS

Installing OpenRasta Under IIS

Install OpenRasta from the binary, or build it from source on the web server.

IIS7

Needs to be filled in.

IIS6

As of 2.0 Beta 2, you must create an ISAPI Wildcard mapping pointing to the ASP.NET ISAPI filter.

  • Open the IIS Manager and expand the treeview to find your website (not the Web Sites folder).
  • Right-click your site and choose Properties.
  • Select the Home Directory tab.
  • Click the Configuration button.
  • The Application Mappings tab should be visible.
  • Click the Insert button.
  • In the Executable text box, enter the full pathname to the ASP.NET ISAPI filter DLL.
    • For ASP.NET 2.0 this is usually: c:\windows\microsoft.net\framework\v2.0.50727\aspnet_isapi.dll
  • Important: Uncheck the Verify option.
  • Click Ok on both dialogs to return to IIS Manager. The changes are complete.

Note that this will disable IIS default page mapping. The work-around is to either expose your default pages using OpenRasta itself, or you can implement your RESTful URIs on a subdirectory below your website root.