Parallels H-Sphere Documentation System Administrator Guide

 

ASP.NET Support

(revised for H-Sphere 2.5 and up)
 

Last modified: 21 Nov 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

H-Sphere uses some of ASP.NET features. That's why ASP.NET should already be installed before installing or upgrading H-Sphere on a Winbox (according to Winbox Pre-Installation Guide).

Starting with HSphere 3.0, it is possible to switch between ASP.NET versions in user CP.

 

Enabling ASP.NET 2.0

(H-Sphere 2.5+)

Starting with H-Sphere 2.5, ASP.NET requires SOAP enabled. Also, H-Sphere 2.5 and up provides ASP.NET 2.0 support.

To enable ASP.NET 2.0 hosting on your H-Sphere Winbox:

  • Install ASP.NET Framework 2.0 according to the installation instructions.
  • In the command line type:

    %WinDir%\Microsoft.NET\Framework\2.0\aspnet_regiis.exe -i

    where
    %WinDir% is a path to the directory where Windows is installed (usually C:\WINNT)
    %version% is a version of ASP.NET (v1.0.3705 or later)
  • Reconfigure ASP.NET resource in the HSphere.config file (usually, C:\HSphere.Net\bin\HSphere.config) to use resource "aspnet2_0" instead of "aspnet1_1". For this, edit HSphere.config and replace the line:

    <resource name="aspnet" type="Psoft.HSphere.Resources.IIS.AspNet1_1" location="Resources.IIS.ASPNET" />

    with this line:

    <resource name="aspnet" type="Psoft.HSphere.Resources.IIS.AspNet2_0" location="Resources.IIS.ASPNET" />

  • Restart H-Sphere Winbox service
  • Download ASP.NET Migration Tool, unpack and execute this tool to reconfigure machine.config with the new version of ASP.NET.

    For example, to migrate from ASP.NET 1.1 to ASP.NET 2.0, run the following command:

    aspnetmigrate -from 1.1.4322.0 -to 2.0.50727.0

 

Upgrading ASP.NET

(H-Sphere 2.4.x)

If you want to upgrade ASP.NET on your H-Sphere Winbox, follow the instructions below:

  1. Download ASP.NET Framework from Microsoft site and install this product following the installation instructions.
  2. In the command line type:

    %WinDir%\Microsoft.NET\Framework\%version%\aspnet_regiis.exe -i

    where
    %WinDir% is a path to the directory where Windows is installed (usually C:\WINNT)
    %version% is a version of ASP.NET (v1.0.3705 or later)
  3. If you have the latest H-Sphere version and you don't need to update, simply restart the service by typing in the command line:

    net stop hssvc
    net start hssvc



© Copyright 2017. Parallels Holdings. All rights reserved.