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

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
   
2. 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
   
3. Run the update script by typing:
   sh ./U24.0b3
Note: The help shows. Choose what you want to update and follow the help.
4. To update H-Sphere, type:
   # install

Important! Do not update Site Studio or WebShell without updating H-Sphere control panel.

5. 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.
6. 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.
7. If your system database holds data in international encoding format, update it to UTF-8.
8. Update your Winbox to 2.4 beta 3.
9. 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
   
10. 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:
    Where:
    2.4.0 is the version of H-Sphere,
    411 is H-Sphere build,