Running Multiple Versions of Microsoft .NET Framework

In order for an ASP.NET application to run correctly under Microsoft IIS, the following must be installed and set up correctly.

  1. The correct version of ASP.NET must be installed and registered with Microsoft IIS.

  2. The Microsoft IIS scriptmap for the application must be set to the correct version of ASP.NET.  For example, an application built for .NET Framework 2.0 must have a scriptmap that specifies the application use ASP.NET version 2.0.

  3. The ASP.NET client script files (.js files) must be installed under the web server root directory.

Step 1:  Register ASP.NET with Microsoft IIS without updating scriptmaps:

C:\>  aspnet_regiis -ir

Using the “-ir” option is safer if another version of ASP.NET is registered.  This option will not affect any current scriptmap configurations.

Check the current scriptmap configuration (i.e list keys):

C:\> aspnet_regiis -lk


W3SVC/  1.1.4322.0

W3SVC/1/ROOT/MyApp1/    1.1.4322.0

W3SVC/1/ROOT/MyApp2/    2.0.40607.0

The version of ASP.NET that owns the root scriptmap configuration is the one with “W3SVC/”.  If a virtual directory is not listed here is means that it inherits the root scriptmap configuration.

To specify the scriptmap of a particular virtual directory (i.e. specify which version of ASP.NET to use):

C:\> aspnet_regiis –sn <path>

For example, running version 3.0 of aspnet_regiis:

C:\> aspnet_regiis –sn “W3SVC/1/ROOT/MyApp2”

will change MyApp2 so that is uses ASP.NET 3.0 instead of ASP.NET 2.0.

Step 2:  Install the ASP.NET client script files in the webroot folder.

If these file are either missing or have been corrupted, install them:

C:\>  aspnet_regiis –c

After you perform the steps above, you should be able to run your Iron Speed Designer applications with Microsoft .NET Framework 2.0, even if .NET Framework 3.0 or 3.5 are installed.

See Also

Configuring the Microsoft .NET Framework

Deploying Applications with the Deployment Wizard

Manually Deploying an Application to a Production Server