H-Sphere Documentation Upgrades

 

Upgrading H-Sphere to 2.4 Beta 4

 

This document explains how to upgrade H-Sphere from 2.3.1 Patch 9 or earlier 2.4 betas to 2.4 Beta 4. If your H-Sphere is lower than 2.3.1 Patch 9, please update to this version first.

IMPORTANT:

This version is not yet stable and should not be installed on production servers or systems with over 1000 accounts.

Don't forget to upgrade Winbox to 2.4 beta 3 to ensure correct performance of Windows-based hosting.

Procedure

  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
    If you have an older version, contact support@psoft.net or read how to upgrade from previous versions.
  2. Download 2.4 Beta 4 installation package from the Positive Software site:
    # wget http://www.psoft.net/shiv/HS/U24/U24.0b4/U24.0b4
    Make sure the target directory doesn't contain any other U24.0b4 file!
  3. Stop H-Sphere using one of the following commands:
    Linux:
    # /etc/rc.d/init.d/httpdcp stop
    FreeBSD:
    # /usr/local/etc/rc.d/apachecp.sh stop
  4. Run the update script by typing:
    sh ./U24.0b4
  5. Note: The help shows. Choose what you want to update and follow the help.
  6. To update H-Sphere, type:
    # install
  7. Important! Do not update Site Studio or WebShell without updating H-Sphere control panel.

  8. To update your SiteStudio to 1.6 RC3, type:
    # ss
    then kill your SiteStudio ImageMaker:
    # killall java
    Kill these processes one by one if you have any other java processes running.
  9. If the update breaks SiteStudio demo, follow the Troubleshooter.
  10. H-Sphere 2.4 will use WebShell4 by default. To use WebShell3, set in hsphere.properties:
    WEBSHELL=3
    For correct performance of WebShell4, you must have 1.3.29 apache update.
  11. If your system database holds data in international encoding format, update it to UTF-8.
  12. Update your Winbox to 2.4 beta 3.
  13. Start H-Sphere CP using one of the following commands:
    Linux:
    # /etc/rc.d/init.d/httpdcp start
    FreeBSD:
    # /usr/local/etc/rc.d/apachecp.sh start
  14. Check the version of H-Sphere using the following command:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION

    You will see a line similar to this:
    HS_VERSION = 2.4.0.413.20040114
    Where:
    2.4.0 is the version of H-Sphere,
    413 is H-Sphere build,
    20040114 is the build date (in YYYYMMDD format)
    You can have a later build of version 2.4.0.



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