Configuring QBO3 to run with QBO 2.0

posted Nov 21, 2011, 12:07 PM by Eric Patrick   [ updated Feb 6, 2012, 4:04 PM ]


QBO 3 can be run alongside QBO 2.0. No code changes are required for either QBO 3 or QBO 2.0, but to coexist, the website must be running ASP.NET 4.0.

Steps include:
  1. Install the .NET Framework 4.0 on the server
  2. For IIS 6 on x64 machines:
    • Open the command prompt and navigate to the .NET 4.0 framework folder (C:\WINDOWS\Microsoft.NET\Framework\v4.0*)
    • Register ASP.NET 4.0: aspnet_regiis -i
    • List all sites: aspnet_regiis -lk (-LK)
    • Change the desired site: aspnet_regiis -s PATH (e.g. aspnet_regiis -s W3SVC/1391644868/root/)
    • For IIS 6, ensure Web Service Extensions allow ASP.NET 4.0
  3. For IIS 7+:
    • From App Pools, select your App Pool > Advanced Settings
    • Under .NET Framework Version, choose v4.0
    • From IIS Click the server/machine name (should be the top level item)
    • Double click  "ISAPI and CGI Restrictions"
    • Then set the value under the restriction column to "Allowed" for ASP.NET v4.0****
  4. Modify web.config so that the <machineKey/> uses a hard coded validationKey and decryption key.  Example below.  Machine key code generators are available on the internet.

  5. <machineKey
    validation="SHA1" decryption="AES"/>
  6. Modify web.config to include this line:

    <httpRuntime maxRequestLength="..." executionTimeout="..."  requestValidationMode="2.0" />
Note that if you re-installed QBO 2.0 to a site installed with ASP.NET 4.0, the MSI will "revert" the site to ASP.NET 2.0. Simply re-execute the steps above to "fix" this issue.

To set up VS 2010 Web Deployment, do the following:
Thanks to:
Eric Patrick,
Jan 18, 2012, 10:10 AM