ASP.NET Support

In H-Sphere 2.3.2 and higher 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 H-Sphere 2.5, ASP.NET requires enabled SOAP. Also, H-Sphere 2.5 and up provides ASP.NET 2.0 support.

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

Upgrading ASP.NET

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

Enabling ASP.NET 2.0

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