QPR Knowledge Base 2014.1

Appendix C - Web Server Configuration

Appendix C - Web Server Configuration

Previous topic Next topic  

Appendix C - Web Server Configuration

Previous topic Next topic JavaScript is required for the print function  

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 QPR2014-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

 

 

Additional configuration in 64-bit edition

In order to run qpr.isapi.dll you must enable 32-bit applications in IIS 7.0 / 7.5. The settings are done in the same way as in 32-bit environment (see System Requirements.pdf for normal settings). In addition, verify that “Enable 32-Bit Application” is set to TRUE in the application pool you are using (the QPR application pool does this automatically).

 

 

 

Configuring Internet Information Services 8 / 8.5 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 or Microsoft Internet Information Services (IIS) 8.5 in Windows 8.1 and Windows Server 2012 R2.

 

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

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 and 8.1 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 QPR2014-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

 

 

Additional configuration in Windows Server 2012 / 2012 R2 and 64-bit edition of Windows 8 / 8.1

In order to run qpr.isapi.dll you must enable 32-bit applications in IIS. The settings are done in the same way as in 32-bit environment, but you will need to additionally verify that “Enable 32-Bit Application” is set to TRUE in the application pool you are using (the QPR application pool does this automatically).

 

 

 

Configuring Web Site Manually

QPR installation creates the QPR2014-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.On 64-bit machines, set the application to use the QPR2014-1 application pool (or some other application pool that has the "Enable 32-Bit Application" option set as true).

2.Create the MIME type mappings as instructed above.

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

.svc

.aspx

.axd

WebResource.axd

ScriptResource.axd