Upgrading H-Sphere to 2.4 RC 1


This document explains how to upgrade H-Sphere from 2.3.1 Patch 9, any of 2.3.2 versions, or earlier 2.4 betas to 2.4 RC 1. If your H-Sphere is lower than 2.3.1 Patch 9, please update to this version first.

This candidate includes ability to create custom XML files by means of XML Merger, adds improvements in 2CheckOut merchant gateway and more.


  • Don't forget to upgrade Winbox to 2.4 RC 1 to ensure correct performance of Windows-based hosting.
  • The upgrade won't work without a valid H-Sphere license. Please check if you have enough licenses to cover all accounts in the system.
  • Before update, remember that H-Sphere supports the following operation systems:
    Linux RedHat (7.2, 7.3, RHES 2.1, RHWS 2.1, RHAS 2.1, RHWS3, RHES3, RHAS3) and FreeBSD (versions 4.7, 4.8, 4.9)
  • For correct performance of WebShell4, you must have 1.3.29 apache update.


  1. Make sure to have H-Sphere 2.3.1 Patch 9 or an earlier 2.4 beta installed:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
  2. Download 2.4 RC 1 installation package from the Positive Software site:
    Make sure the target directory doesn't contain any other U24.0RC1 file!
  3. Stop H-Sphere using one of the following commands:
    # /etc/rc.d/init.d/httpdcp stop
    # /usr/local/etc/rc.d/apachecp.sh stop

    To stop SiteStudio, stop Imaker by running:
    # kill -9 `ps -axw|grep imaker.sh |grep -v grep|awk '{print $1}'`
    # kill -9 `ps -axw|grep ImageMaker|grep -v grep|awk '{print $1}'`

  4. Run the update script:
    # sh ./U24.0RC1
    You will see a help window with a prompt to enter update options.
    To update H-Sphere to version 2.4 RC1 and Site Studio to version 1.6 RC 3, enter:
    To update only H-Sphere to version 2.4 RC1, enter:
    To update only Site Studio to 1.6 RC 3, enter:
    Later you'll be able to add more servers or services to the cluster by following the Adding Servers and Adding Services manuals.
  5. If you have windows servers, update your Winbox to 2.4 RC1.
  6. Start H-Sphere CP:
    # /etc/rc.d/init.d/httpdcp start
    # /usr/local/etc/rc.d/apachecp.sh start
  7. Start ImageMaker:
    # /hsphere/shared/SiteStudio/imaker.sh >& /hsphere/shared/SiteStudio/var/error_log 2>&1 &
    # /hsphere/shared/SiteStudio/imaker.sh >& /hsphere/shared/SiteStudio/var/error_log &
  8. Check the version of H-Sphere:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION

    You will see a line similar to this:
    2.4.0 is the version of H-Sphere,
    422 is H-Sphere build,
    You can have a later build of version 2.4.0.

Home   Products   Services   News
© Copyright. . PSOFT. All Rights Reserved. Terms | Site Map