H-Sphere Versions

For more information contact us

Updating H-Sphere to 2.5 Beta 3 (Private Build 702)

Under development - not for production servers!


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

This version is a private release for beta testers. This version is not recommended for production servers! Please refer to the latest stable version.
Note for beta testers: Please report all bugs and issues to our Bugzilla system. Please send info on successful installation/upgrade to bugreport@psoft.net.

This document explains how to upgrade H-Sphere to 2.5 Beta 3 (Private Build 702) from H-Sphere 2.4.3 Patch 11 and up. If you have a lower version, please upgrade to 2.4.3 Patch 11 first.



Consider this before you update H-Sphere:

    WARNING: We have found problems with updating H-Sphere to 2.5 Beta 2 on FreeBSD 4.x up to version 4.9. We recommend upgrading your FreeBSD servers to at least 4.10 or 4.11 before the H-Sphere update!

  • The upgrade won't work without a valid H-Sphere license to cover all accounts in the system!

  • Please refer to the list of operating systems supported by H-Sphere.

    1. Update to H-Sphere 2.5 and up is not recommended for H-Sphere clusters with CP servers under FreeBSD 4.x up to FreeBSD 4.9, as these FreeBSD versions do not fully support Java 1.5.
    2. H-Sphere Winbox versions earlier than 2.5 won't work correctly with H-Sphere 2.5 Beta 2 and up! In the same way, Winbox 2.5 Beta 2 and up won't work with H-Sphere under 2.5!
    3. Serv-U FTP is no longer supported in H-Sphere Winbox 2.5 and up. If you are currently using it and would like to update to this version, first switch to MS FTP.
    4. We currently don't recommend updating H-Sphere to version 2.5 and up when there are 512 and more ColdFusion mappings on a Windows server (i.e., ColdFusion is turned on for more than 511 Winbox users)
  • If you have CP installed on a FreeBSD box, especially in case of multiprocessor architecture, please make sure you have the /etc/libmap.conf file on the CP box with this content.

  • If you have a mail server running on the same box as the CP server, and CP server uses port 80, change CP port to 8080 in /hsphere/local/home/cpanel/apache/conf/httpd.conf or contact H-Sphere support.

  • In H-Sphere 2.4.3 RC 1 and up, custom server groups for name (DNS) logical servers are no longer supported! If you are upgrading from an earlier version, please remove all custom name server groups (including all respective logical/physical servers). Please refer to Server Groups for details.

  • MySQL Updates.
  • Make sure that port 144 (localhost:144) is opened on all mailboxes.



  1. Make sure you have H-Sphere 2.4.3 Patch 11 or higher installed:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
    If you have an older version, update to H-Sphere 2.4.3 Patch 11 first and run a separate PostgreSQL update script to update PostgreSQL to 7.4.x version.
  2. Download the 2.5 Beta 3 (Private Build 702) upgrade package:
    # wget http://www.psoft.net/shiv/HS/releases/U25.0/U25.0b3/U25.0b3
    # fetch http://www.psoft.net/shiv/HS/releases/U25.0/U25.0b3/U25.0b3
  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 ./U25.0b3

    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 Services documentation.

  7. Update PostgreSQL:
    hspackages postgres
  8. Upgrade your Winbox to 2.5 Beta 3 (Private Build 702).
  9. 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
  10. Start ImageMaker if your H-Sphere is integrated with SiteStudio, for Linux & FreeBSD:
    # /hsphere/shared/SiteStudio/imaker.sh start
  11. 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.5.0 is the version of H-Sphere,
    702 is the H-Sphere build.


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.5 Beta 3 (Private Build 702) 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.
    Starting with HS 2.5 Beta 1, the check! client-side validation attribute is no longer supported in the input and textarea tags. Please update your custom templates with the check="${validation_variable}" construction everywhere instead of check!, where ${validation_variable} is a Freemarker variable which is evaluated to the real name of a validation function (regexp) during the template processing.

  • Web Payments. If you are updating from H-Sphere versions earlier than 2.5 Beta 1, please update the format of instant payment notification URL in affected Web payment systems' settings.

  • Web traffic calculation and log rotation. H-Sphere 2.5 Beta 1 and up introduces a completely different approach in Web traffic calculation and log rotation. Now it takes into account both incoming and outgoing traffic. Therefore, after you upgrade from versions earlier than 2.5 Beta 1, your clients may find their traffic increased.

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