H-Sphere Versions

For more information contact us

Updating H-Sphere to 2.4.3 Patch 11

10 Apr 2006


Release Notes  |     Install  |     Winbox Install  |     Winbox Update  |     Change Log  |     Package List

This H-Sphere version is outdated and is not supported. Please refer to latest supported versions.

This document explains how to upgrade H-Sphere to 2.4.3 Patch 11 from 2.3.1 Patch 9 and up. If your H-Sphere is lower than 2.3.1 Patch 9 (build, please upgrade to 2.3.1 Patch 9 first.

To upgrade from a version lower than 2.2, please contact H-Sphere support.



Consider this before you update H-Sphere:



  1. Make sure you have H-Sphere 2.3.1 Patch 9 or higher installed:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
    If you have an older version, contact support or read how to upgrade from previous versions.
  2. Download the 2.4.3 Patch 11 upgrade package:
    # wget http://www.psoft.net/shiv/HS/U24/U24.3P11/U24.3P11
    # fetch http://www.psoft.net/shiv/HS/U24/U24.3P11/U24.3P11
  3. Make sure that permissions to /usr/bin/wget are set to 0755 during the installation.
  4. Stop H-Sphere using one of the following commands:
    # /etc/rc.d/init.d/httpdcp stop
    # /usr/local/etc/rc.d/apachecp.sh stop
    Stop SiteStudio ImageMaker by running:
    # /hsphere/shared/SiteStudio/imaker.sh stop
  5. Run the update script:
    # sh ./U24.3P11

    You will see a help window with a prompt to enter update options.

  6. Update H-Sphere.
    • to update H-Sphere and Site Studio, type:


    • to update only H-Sphere, enter:


    • to update only Site Studio, enter:


    Note: After the update, you'll be able to add more servers or services to the cluster by following the Adding Servers and Adding Services documentation.

  7. If your system database is not in UNICODE (UTF-8), convert it to UTF-8.
  8. (H-Sphere 2.4.3 RC 2 and up) If your H-Sphere runs on Java 1.3 (especially when CP server is installed under FreeBSD), you may wish to update Java to version 1.4.2. For this, after you have successfully updated H-Sphere, type the following option in the update script interface:

    This will also update your H-Sphere Java classes.

  9. Upgrade your Winbox to 2.4.3 Patch 11.
  10. H-Sphere update script will automatically launch H-Sphere CP after the update. Check if H-Sphere is running, and if not, start CP Apache:
    # /etc/rc.d/init.d/httpdcp start
    # /usr/local/etc/rc.d/apachecp.sh start
  11. Start ImageMaker if your H-Sphere is integrated with SiteStudio, for Linux & FreeBSD:
    # /hsphere/shared/SiteStudio/imaker.sh start
  12. Check the version of H-Sphere by executing the following command on your CP box:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION

    You will see a line similar to this:

    2.4.3 is the version of H-Sphere,
    517 is the H-Sphere build.
  13. (H-Sphere 2.4.3 branch, since 2.4.3 Patch 11)
    Important: Run the separate package updater to update specific third-party packages excluded from the H-Sphere 2.4.3 update script to their latest versions.


Post-Update Issues

After you have updated H-Sphere, please make sure you meet the following requirements:

  • Winbox Update. Don't forget to upgrade Winbox to 2.4.3 Patch 11 if you haven't done this yet.

  • Customization. If you have custom H-Sphere templates, you may probably need to update them according to changes introduced in this version.

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