Updating H-Sphere to 2.3.2 Patch 5


This document explains how to upgrade H-Sphere from:
- 2.3.1 Final
- 2.3.1 Patches
- 2.3.2 Release
- 2.3.2 Patches
to 2.3.2 Patch 5.

If you have H-Sphere older than 2.3.1, make sure to upgrade your H-Sphere to 2.3.1 Final first.

This patch brings improvements to reseller traffic and disk usage and introduces phpBB 2.0.8.


  • Owners of 2.4 betas - DON'T update to version 2.3.2.
  • To ensure correct performance of Windows-based hosting, upgrade your Winbox to 2.3.2 Patch 5.
  • 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)


  1. Make sure to have H-Sphere 2.3.1 Final installed:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
  2. Download 2.3.2 Patch 5 installation package from the Positive Software site:
    Make sure the target directory doesn't contain any other U23.2P5 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 ./U23.2P5
    You will see a help window with a prompt to enter update options.
    To update H-Sphere to version 2.3.2 Patch 5 and Site Studio to version 1.6 RC 3, enter:
    To update only H-Sphere to version 2.3.2 Patch 5, enter:
    To update only Site Studio to 1.6 RC 3, enter:
  5. If you have windows servers, update your Winbox to 2.3.2 Patch 5.
  6. Perform optional tasks that are not included into the above upgrade options. They have to be performed only once. If you've performed them before, don't do it now.
    • To correct the sizes of H-Sphere DB fields, run:
      Note: It backs up DB before resizing fileds. Backup can be found in var/backup/hs_bck.tgz.
    • If you have custom templates using H-Sphere Freemarker validation function calls, back them up and run:
      Note: It will convert them to accomodate new customer template style as of version 2.3.1. It's required if you are upgrading your system from any of 2.3 versions and you have custom templates.
  7. Start H-Sphere CP:
    # /etc/rc.d/init.d/httpdcp start
    # /usr/local/etc/rc.d/apachecp.sh start
  8. 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 &
  9. 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.3.2 is the version of H-Sphere,
    391 is H-Sphere build,

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