QPR Knowledge Base 2012.1

Appendix C - Web Server Configuration

Appendix C - Web Server Configuration

Previous topic Next topic  

Appendix C - Web Server Configuration

Previous topic Next 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).

 

 

Configuring Microsoft Internet Information Services 6.0

This section applies to Microsoft IIS 6.0, which is shipped with Windows Server 2003.

 

There are two things you need to do if you are running the Microsoft Internet Information Services 6.0 web server software:

Create a virtual directory for the CGI binary or ISAPI DLL

Allow CGI or ISAPI extensions

 

To perform the abovementioned tasks, follow the instructions below:

 

How to make a new virtual directory

1.Go to Start Menu -> Programs -> Administrative Tools -> Internet Information Services (IIS) Manager.
2.Expand the Server name and the Web Sites section
3.Right-click the Default Web Site option and select New -> Virtual Directory from the pop-up menu
4.The Virtual Directory Creation Wizard appears. In the first page, type an alias for the virtual directory (for example Scripts for QPR Portal) and click Next.
5.In the second page, click the Browse button and locate the CGI binary / ISAPI DLL installation folder. Click Next.
6.In the third page, select the following rights from the list: Read, Run scripts, and Execute. Make sure that the other check boxes are unchecked. Click Finish to complete the wizard.

 

How to allow CGI/ISAPI Extensions

1.Go to Start Menu -> Programs -> Administrative Tools -> Internet Information Services (IIS) Manager.
2.Expand the Server name and the Web Service Extensions sections
3.Select All Unknown CGI Extensions (in the case you use qpr.cgi.exe) or All Unknown ISAPI Extensions (in the case you use qpr.isapi.dll) from the list in the right side of the window.
4.Click the Allow button.

 

 

The following MIME type mappings are created automatically for the Portal virtual directory under the QPR2012 application in IIS, but in the case there are issues with Silverlight or SVG views or you are using Apache (where automatic mapping does not occur), 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.Right-click the Default Web Site directory and click Properties.

3.Click the HTTP Headers tab.

4.Click MIME Types.

5.If the extension is not listed, select New and input the extension and the correct MIME type.

6.Click OK and restart the website

 

 

Additional configuration in 64-bit edition

In order to run qpr.isapi.dll you must configure IIS 6.0 to run 32-bit applications on a 64-bit Windows. To do this, follow the instructions below:

1.Open a command prompt and navigate to the <System root drive>\Inetpub\AdminScripts directory.
2.Type the following command: cscript.exe adsutil.vbs set W3SVC/AppPools/Enable32BitAppOnWin64 “true”
3.Press Enter

 

If you want to use qpr.exe, you don’t have to set the IIS 6.0 to run 32-bit applications.

 

For more information see: http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/13f991a5-45eb-496c-8618-2179c3753bb0.mspx?mfr=true

 

 

 

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 Vista and Windows Server 2008 or IIS 7.5 in Windows 7 and Windows Server 2008 R2.

 

IIS Setup

In addition to the default selections, the following extra modules need to be installed for IIS 7.0 / 7.5:

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

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 (for QPR Web Services Foundation)

Application Development -> ISAPI Extensions

Application Development -> ISAPI Filters

 

On Windows Vista and 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.

 

If you intend to use QPR Web Services Foundation, you may need to perform some additional configuration depending on whether IIS was installed by the time the .NET Framework 4.0 was installed (note that the framework is installed during the QPR 2012 installation if you select the QPR Web Services Foundation or the QPR Add-In for Microsoft Office 2007/2010 to be installed).

If IIS was installed at the time the .NET Framework 4.0 was installed, all necessary associations should already be configured properly

If IIS was installed when .NET Framework 4.0 was already present on the machine, you need to register .svc and .aspx extensions by running the following command:

o"%WINDIR%\Microsoft.Net\Framework\v3.0\Windows Communication Foundation\ServiceModelReg.exe" -r

oAlternatively follow the instructions at http://msdn.microsoft.com/en-us/library/ms752252.aspx

 

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 QPR2012 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 Web Site Manually

QPR installation creates the QPR2012 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 QPR2012 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 QPR2012 application:

.svc

.aspx

.axd

WebResource.axd

ScriptResource.axd