QPR Knowledge Base 2016.1

Appendix C - Web Server Configuration

Appendix C - Web Server Configuration

Previous topic Next topic No directory for this topic  

Appendix C - Web Server Configuration

Previous topic Next topic Topic directory requires JavaScript Mail us feedback on this topic!  

Common Microsoft Internet Information Services Configuration

In order for QPR Portal and QPR Web Services Foundation to work properly, handlers for the CGI binary/ISAPI DLL and the .svc extension need to be able to use both GET and POST methods (verbs).

 

 

Using QPR Portal with Internet Information Services 7.0 / 7.5

The following things need to be done if you are using QPR Portal with Microsoft Internet Information Services (IIS) 7.0 in Windows Server 2008 or IIS 7.5 in Windows 7 and Windows Server 2008 R2.

 

IIS Setup

In addition to the default selections (including common HTTP features such as static content), the following extra modules need to be installed for IIS 7.0 / 7.5:

World Wide Web Services -> Application Development Features -> .NET Extensibility

World Wide Web Services -> Application Development Features -> ASP.NET (for QPR Web Services Foundation)

World Wide Web Services -> Application Development Features -> ISAPI Extensions

World Wide Web Services -> Application Development Features -> ISAPI Filters

Web Management Tools -> IIS Management Console (if not already installed)

Web Management Tools -> IIS Management Scripts and Tools

 

In addition to the default selections, the following role services need to be installed for IIS 7.0 on Windows Server 2008:

Application Development -> ASP.NET (for QPR Web Services Foundation)

Application Development -> .NET Extensibility

Application Development -> ISAPI Extensions

Application Development -> ISAPI Filters

 

On Windows 7 these selections can be made in the "Turn Windows features on or off" section in the Control Panel. On Windows Server 2008 the selection is available at Server Manager -> Roles -> Web Server (IIS) -> Add Role Services.

 

Do the following to allow qpr.isapi.dll (for QPR Portal) to be executed:

 

1.Go to Start Menu -> Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.

2.Expand the Server name and open the ISAPI and CGI Restrictions section.

3.Select Add.

4.Browse the path to the QPR.isapi.dll (using qpr.cgi.exe with IIS 7 is not supported. Note that you'll need to verify that also QPR Web Application Server is configured to use the qpr.isapi.dll) into the ISAPI or CGI Path field.

5.Input a description for the extension and check the "Allow extension path to execute" checkbox.

6.Click the OK button.

 

 

The following MIME type mappings are created automatically for the Portal virtual directory under the QPR2016-1 application in IIS, but in the case there are issues with Silverlight or SVG views, verify that the following mappings exist:

Extension: .svg, MIME type image/svg+xml

Extension: .xaml, MIME type application/xaml+xml

Extension: .xap, MIME type application/x-silverlight-app

Extension: .xbap, MIME type application/x-ms-xbap

 

To define these mappings, do the following:

 

1.Go to Start Menu -> Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.

2.Select Default Web Site.

3.Open the MIME Types section.

4.If the extension is not listed, select Add and input the extension and the correct MIME type.

5.Click OK and restart the website

 

 

Application pool configuration

The application pool created by QPR installation is typically configured properly and the settings don't have to be touched. However, if you are reconfiguring the IIS application and/or application pool manually or the installation has not succeeded in the configuration, note that for configuring the application pool so that qpr.isapi.dll can be run, the "Enable 32-bit Applications" flag needs to be set to false when running 64-bit servers (and the system is naturally 64-bit as well).

 

 

Configuring Internet Information Services 8 / 8.5 / 10 for QPR Suite

The following things need to be done if you are using QPR Portal and/or QPR Web Services Foundation with Microsoft Internet Information Services (IIS) 8.0 in Windows 8 and Windows Server 2012, Microsoft Internet Information Services (IIS) 8.5 in Windows 8.1 and Windows Server 2012 R2, or Microsoft Internet Information Services (IIS) 10.0 in Windows 10.

 

IIS Setup

In addition to the default selections (including common HTTP features such as static content), the following extra modules and their dependencies need to be installed for IIS 8.0 / 8.5 / 10.

World Wide Web Services -> Application Development Features -> .NET Extensibility 3.5

World Wide Web Services -> Application Development Features -> ASP.NET 3.5 (for QPR Web Services Foundation)

World Wide Web Services -> Application Development Features -> ISAPI Extensions

World Wide Web Services -> Application Development Features -> ISAPI Filters

Web Management Tools -> IIS Management Console (if not already installed)

Web Management Tools -> IIS Management Scripts and Tools

 

In addition to the default selections, the following role services need to be installed for IIS 8.0 / 8.5 on Windows Server 2012 / 2012 R2:

Web Server -> Application Development -> ASP.NET 3.5 (for QPR Web Services Foundation)

Web Server -> Application Development -> .NET Extensibility 3.5

Web Server -> Application Development -> ISAPI Extensions

Web Server -> Application Development -> ISAPI Filters

 

Also make sure that the ".NET Framework 3.5 (included .NET 2.0 and 3.0)" feature is selected on the main level.

 

On Windows 8 / 8.1 / 10 these selections can be made in the "Turn Windows features on or off" section in the Control Panel. On Windows Server 2012 and 2012 R2 the selection is available at Server Manager -> IIS -> select "Add Roles and Features" from the Tasks drop-down menu in the Roles and Features section.

 

Do the following to allow qpr.isapi.dll (for QPR Portal) to be executed:

 

1.Go to Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.

2.Expand the Server name and open the ISAPI and CGI Restrictions section.

3.Select Add.

4.Browse the path to the QPR.isapi.dll (using qpr.cgi.exe with IIS 7 and newer is not supported. Note that you'll need to verify that also QPR Web Application Server is configured to use the qpr.isapi.dll) into the ISAPI or CGI Path field.

5.Input a description for the extension and check the "Allow extension path to execute" checkbox.

6.Click the OK button.

 

 

The following MIME type mappings are created automatically for the Portal virtual directory under the QPR2016-1 application in IIS, but in the case there are issues with Silverlight or SVG views, verify that the following mappings exist:

Extension: .svg, MIME type image/svg+xml

Extension: .xaml, MIME type application/xaml+xml

Extension: .xap, MIME type application/x-silverlight-app

Extension: .xbap, MIME type application/x-ms-xbap

 

To define these mappings, do the following:

 

1.Go to Control Panel -> Administrative Tools -> Internet Information Services (IIS) Manager.

2.Select Default Web Site.

3.Open the MIME Types section.

4.If the extension is not listed, select Add and input the extension and the correct MIME type.

5.Click OK and restart the website

 

 

Application pool configuration

The application pool created by QPR installation is typically configured properly and the settings don't have to be touched. However, if you are reconfiguring the IIS application and/or application pool manually or the installation has not succeeded in the configuration, note that for configuring the application pool so that qpr.isapi.dll can be run, the "Enable 32-bit Applications" flag needs to be set to false when running 64-bit servers (and the system is naturally 64-bit as well).

 

 

Configuring Web Site Manually

QPR installation creates the QPR2016-1 application under the default web site in IIS. If you want to use a different site, the application and its virtual directories should be created manually. The following changes are needed to the default configuration:

 

1.See the "Application pool configuration" section above for information about proper application pool configuration.

2.Create the MIME type mappings as instructed above.

3.If QPR Web Service Foundation is used, remove the following mappings from the QPR2016-1 application:

.svc

.aspx

.axd

WebResource.axd

ScriptResource.axd