Installation and Administration Guide

Configuring the IIS to host Sitefinity projects

If you are using Microsoft Internet Information Server (IIS) to host your Sitefinity projects, you must configure the server in the following way, depending on your operating system:

Operating system  Setup procedure 
Microsoft® Windows Server 2003 with IIS 6.0
  1. Open Internet Information Services Manager, by opening your Start Menu and clicking Run.
  2. Enter inetmgr and click OK.
  3. Expand your server node and click Web Service Extensions.
  4. In the right pane, make sure ASP.NET v4.0 extension is in status Allowed.
  5. After you have created your website, expand node Web Sites, select your website and in the context menu, select Properties.
  6. Click ASP.NET tab, make sure that ASP.NET version is set to 4.0.30319, and click OK.
  7. On Home Directory tab, in Application pool dropdown box, select an application pool in which you run only .NET 4.0 applications.
  8. Click Configuration… button.
    Application Configuration window appears.
  9. On Mappings tab, perform the following:
    • Make sure you have mappings to the .svc and .xamlx extensions and make sure their Executable Path is set to one of the following:
      • For 64-bit OS: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll
      • For 32-bit OS: %windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
    • In Wildcard application maps, click Insert… button and in Executable: input field, enter one of the following:
      • For 64-bit OS: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll
      • For 32-bit OS: %windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
      • Deselect Verify that file exist checkbox and click OK.
  10. Click OK.
    The Application Configuration window closes.
  11. Click Directory Security tab.
  12. In Authentication and access control, click Edit.
    The Authentication Methods window appears.
  13. Make sure that Enable anonymous access checkbox is selected and that none of the checkboxes in Authenticated access is selected.
  14. Click OK » OK.
  15. Close Internet Information Services Manager.
Microsoft® Windows Server 2008 with IIS 7.0
  1. Open the Server Manager by opening your Start Menu and clicking Administrative Tools » Server Manager.
  2. Select and expand Roles.
  3. If you do not see Web Server (IIS) role, you must add it using the Add Roles button.
  4. Click Web Server (IIS) and in the right pane, expand Role Services.
  5. Make sure you have installed the following services:
    • Common HTTP Features » Static Content.
    • Application Development » ASP.NET, .NET Extensibility, ISAPI Extensions, and ISAPI Filters.
    • Management Tools » IIS Management Console, IIS Management Scripts and Tools, and Management Service.
  6. In the navigation tree on the left, click Features.
  7. Make sure you have the following features installed:
    • Desktop Experience.
    • .NET Framework 3.5.1 Features » WCF Activation » HTTP Activation.
  8. After you have created your website, expand Web Server (IIS) node and click Internet Information Services (IIS) Manger.
    In the right pane, the Internet Information Services (IIS) Manager appears.
  9. In the navigation of the IIS manager, expand your server node.
  10. Expand Sites node and click your website.
  11. In section IIS on the right, double-click Authentication.
  12. Perform one of the following:
    • If you are using Forms authentication, make sure Anonymous Authentication and Forms Authentication are enabled and all other authentications are disabled.
    • If you are using Claims-based authentication, make sure only Anonymous Authentication is enabled and all other authentications are disabled.
  13. Click your website again and in IIS section, double-click Handler Mappings.
  14. Make sure you have enabled handler mappings for *.svc and *.xamlx with executable path set to one of the following:
    1. For 64-bit OS: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll
    2. For 32-bit OS: %windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
  15. Close the Server Manager.
Microsoft® Windows Vista and Windows 7 with IIS 7.5
  1. Open your Control Panel and click Programs and Features » Turn Windows features on or off.
  2. Turn on Internet Information Services.
  3. Under Internet Information Services, turn on the following features:
    • Web Management Tools » IIS Management Console, IIS Management Scripts and Tools, and Management Service.
    • Microsoft .NET Framework 3.5.1 Features » Windows Communication Foundation HTTP Activation.
  4. After you have created your website, open the Internet Information Services (IIS) Manger.
  5. Expand your server node.
  6. Expand Sites node and click your website.
  7. In section IIS on the right, double-click Authentication.
  8. Perform one of the following:
    • If you are using Forms authentication, make sure Anonymous Authentication and Forms Authentication are enabled and all other authentications are disabled.
    • If you are using Claims-based authentication, make sure only Anonymous Authentication is enabled and all other authentications are disabled.
  9. Click your website again and in IIS section, double-click Handler Mappings.
  10. Make sure you have enabled handler mappings for *.svc and *.xamlx with executable path set to one of the following:
    • For 64-bit OS: %windir%\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll
    • For 32-bit OS: %windir%\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
  11. Close the Internet Information Services (IIS) Manger.
Microsoft® Windows Server 2012 with IIS 8.0
  1. Install ASP.NET 4.5.
  2. Open your Control Panel and click Programs and Features » Turn Windows features on or off.
  3. Turn on Internet Information Services.
  4. Under Internet Information Services, turn on the following features:
    • Web Management Tools » IIS Management Console, IIS Management Scripts and Tools, and Management Service.
    • Microsoft .NET Framework 3.5.1 Features » Windows Communication Foundation HTTP Activation.
  5. After you have created your website, open the Internet Information Services (IIS) Manger.
  6. Expand your server node.
  7. Expand Sites node and click your website.
  8. In section IIS on the right, double-click Authentication.
  9. Perform one of the following:
    • If you are using Forms authentication, make sure Anonymous Authentication and Forms Authentication are enabled and all other authentications are disabled.
    • If you are using Claims-based authentication, make sure only Anonymous Authentication is enabled and all other authentications are disabled.
  10. Click your website again and in IIS section, double-click Handler Mappings.
  11. In the right pane click Add Managed Handler… and register the following managed handlers:
    • *.svc
      1. In Request path, enter *.svc
      2. In Type input field, enter System.ServiceModel.Activation.ServiceHttpHandlerFactory, System.ServiceModel.Activation, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
      3. Click Request Restrictions.
      4. On Mappings tab deselect Invoke Handler if request is mapped to.
      5. On Verbs tab, select All verbs.
      6. On Access tab, select Script.
    • *.xamlx
      1. In Request path, enter *.xamlx
      2. In Type input field, enter System.Xaml.Hosting.XamlHttpHandlerFactory, System.Xaml.Hosting, Version=4.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35
      3. Click Request Restrictions.
      4. On Mappings tab deselect Invoke Handler if request is mapped to.
      5. On Verbs tab, enter GET,HEAD,POST,DEBUG.
      6. On Access tab, select Script.
  12. In the right pane click Add Script Map… and register the following script maps:
    • *.svc
      1. In Request path, enter *.svc
      2. In Executable input field, enter C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
      3. Click Request Restrictions.
      4. On Mappings tab deselect Invoke Handler if request is mapped to.
      5. On Verbs tab, select All verbs.
      6. On Access tab, select Script.
    • *.svc
      1. In Request path, enter *.svc
      2. In Executable input field, enter C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll
      3. Click Request Restrictions.
      4. On Mappings tab deselect Invoke Handler if request is mapped to.
      5. On Verbs tab, select All verbs.
      6. On Access tab, select Script.
    • *.xamlx
      1. In Request path, enter *.xamlx
      2. In Executable input field, enter C:\Windows\Microsoft.NET\Framework\v4.0.30319\aspnet_isapi.dll
      3. Click Request Restrictions.
      4. On Mappings tab deselect Invoke Handler if request is mapped to.
      5. On Verbs tab, enter GET,HEAD,POST,DEBUG.
      6. On Access tab, select Script.
    • *.xamlx
      1. In Request path, enter *.xamlx
      2. In Executable input field, enter C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_isapi.dll
      3. Click Request Restrictions.
      4. On Mappings tab deselect Invoke Handler if request is mapped to.
      5. On Verbs tab, enter GET,HEAD,POST,DEBUG.
      6. On Access tab, select Script.
  13. Close the Internet Information Services (IIS) Manger.

Configuring folder permissions

You must provide the identity of the application pool, in which your website in running under IIS, with Read & execute permissions for the entire folder structure of your website.

Make sure the identity has Modify, Read & execute, Read, and Write permissions set for the App_Data folder and its subfolders.

Configuring IIS for Silverlight applications

Sitefinity backend uses Silverlight RadControls. They require the following server extensions – .xaml, .xap, .xbap.

You must set the following MIME types in the server configuration:

Extension MIME Type 
.xaml application/xaml+xml
.xap
application/x-silverlight-app
.xbap application/x-ms-xbap

CAUTION: If you do not set the MIME types, error message are displayed to users browsing the backend.

For more information on how to set the MIME types, see Configuring IIS for Silverlight Applications.

Next steps

+1-888-365-2779
sales@sitefinity.com

Related topics:

Feedback

How useful is this article?

Tell us more

Submit
Your message was successfully sent.

We appreciate your feedback.

Your message could not be sent.

OK