H-Sphere Documentation Upgrades

For more information contact us

Upgrading H-Sphere Winboxes to 2.4.1 RC 4


This guide instructs how to upgrade H-Sphere Windows software to 2.4.1 RC 4 from 2.3.1, 2.3.2, 2.4 Betas, RC 1, 2.4 Final, 2.4 Patches, 2.4.1 Betas and 2.4.1 RCs.

This version fixes problem with ColdFusion MX service not starting at restart.


  1. Make sure your H-Sphere Windows module has version 2.3.1 or higher:
    Open the file [Disk]:\\HSphere\scripts\consts.inc and check the parameters:
    // the current version
    version = 2.31

    If the version is older, update it to version 2.3.1 or higher.
  2. Open SOAP port 10125 for data communication between Control Panel and Windows server.
  3. Important: if you're using Serv-U FTP service, make sure to disable SOAP feature in the hsphere.properties file on the Control Panel box. Currently, H-Sphere with Serv-U installed doesn't support SOAP.


  1. Download H-Sphere Windows 2.4.1 RC 4 at:
  2. Run the file you have downloaded (HSInst241RC4.exe) to upgrade H-Sphere to 2.4.1 RC 4.
  3. After the H-Sphere upgrade, IIS will still run some modules of earlier versions. Restart IIS whenever it is convenient to ensure you run the updated modules.
  4. Update your Webshell to version 4.
  5. Optionally, install Pdb package for this Winbox version. Dowload the self-extracted archive to the <H-Sphere dir>\pdb directory and extract the files there. Read more in Crash Reporting.
  6. Contact support and inform us about the upgrade. This is required to get appropriate support from PSoft.


Copyright 1998-2006. Positive Software Corporation.
All rights reserved.