QPR Knowledge Base

Supported Web Servers

Hide Navigation Pane

Supported Web Servers

Previous topic Next topic No expanding text in this topic  

Supported Web Servers

Previous topic Next topic JavaScript is required for expanding text Mail us feedback on this topic!  

Comments (...)

QPR Software certifies the following web servers:

 

Web Server

Version

Apache

2.2.x

Microsoft Internet Information Services

6.0 - 7.5 (only qpr.dll is supported on IIS 7.0 & 7.5)

 

With other servers the functionality must be separately tested or separately confirmed by QPR. Note that QPR Web Services Foundation is supported only on Microsoft Internet Information Services.

 

 

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).

 

 

Things to Note with Microsoft Internet Information Services 6.0

 

There are two things you need to do if you are running the Microsoft Internet Information Services 6.0 (included in Windows 2003) 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.exe) or All Unknown ISAPI Extensions (in the case you use qpr.dll) from the list in the right side of the window.
4.Click the Allow button.

 

 

In order for SVG views to work properly, you need to verify that there is a MIME type mapping for SVG images and add it if necessary. To add the mapping, 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 .svg is not listed, select New and input .svg as the extension and image/svg+xml as the MIME type.
6.Click OK and restart the website

 

In order for Silverlight to work properly, you need to verify that there are the necessary MIME type mappings for file types used by Silverlight and add them if necessary. To add the 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 .xaml is not listed, select New and input .xaml as the extension and application/xaml+xml as the MIME type.
6.Similarly, add the following types if they are missing:
Extension: .xap, MIME type application/x-silverlight-app
Extension: .xbap, MIME type application/x-ms-xbap
7.Click OK and restart the website

 

Additional configuration in 64-bit edition

In order to run qpr.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.

 

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)

 

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

 

When using Windows 7, add also the following feature to IIS 7.5:

Microsoft .NET Framework 3.5.1 -> Windows Communication Foundation HTTP Activation

 

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 3.5 was installed (note that the framework is installed during the QPR 8 installation if you select either the QPR Web Services Foundation or the QPR Add-In for Microsoft Office 2007 or 2010 to be installed).

If IIS was installed at the time the .NET Framework 3.5 was installed, all necessary associations should already be configured properly
If IIS was installed when .NET Framework 3.5 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
oIn Windows 7 .NET Framework 3.5 is installed by default, just make sure that the necessary features are enabled prior to QPR installation (see above)

 

Do the following to allow qpr.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.dll (using qpr.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.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.

 

In order for SVG views to work properly, you need to verify that there is a MIME type mapping for SVG images and add it if necessary. To add the mapping, 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 .svg is not listed, select Add and input .svg as the extension and image/svg+xml as the MIME type.
5.Click OK and restart the website

 

In order for Silverlight to work properly, you need to verify that there are the necessary MIME type mappings for file types used by Silverlight and add them if necessary. To add the 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 .xaml is not listed, select Add and input .xaml as the extension and application/xaml+xml as the MIME type.
5.Similarly, add the following types if they are missing:
Extension: .xap, MIME type application/x-silverlight-app
Extension: .xbap, MIME type application/x-ms-xbap
6.Click OK and restart the website

 

 

Additional configuration in 64-bit edition

In order to run qpr.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).

Comments (...)