This document explains how to update your H-Sphere from 2.3, 2.3.1 Beta 1 and 2.3.1 Beta 2 to 2.3.1 Beta 3. To perform this update, you have to be logged in as root.

To perform the upgrade:

1. Make sure to have H-Sphere 2.3 final (build 2.3.321) or later installed:
   # cat ~cpanel/shiva/psoft_config/HS_VERSION
   
2. Download 2.3.1 beta 3 installation script from the Positive Software web site at:
   
3. Stop H-Sphere Control Panel using the following commands:
   (they depend on the OS type and java servlet running engine):
   Linux + ApacheJServ:
   # /etc/rc.d/init.d/httpdcp stop
   FreeBSD + ApacheJserv:
   # /usr/local/etc/rc.d/apachecp.sh stop
   Any OS + Tomcat:
   # ~cpanel/tomcat/tomcat.sh stop
4. Run the update script by typing:
   sh ./U23.1b3
Note: The help shows. Choose what you want to update and follow the help.
5. To update H-Sphere, type:
   # install
6. To update WebShell 3 to the latest available build, type:
   # webshell
7. If you have custom templates using H-Sphere Freemarker validation function calls, back them up and run
   # convtempl
   This will update them to work with the improved H-Sphere data validation.
8. If you updated SiteStudio, restart your SiteStudio ImageMaker. The simplest way to do it is type:
   # killall java
   Kill these processes one by one if you have any other java processes running.
9. Start H-Sphere CP using one of the following commands:
   Linux + ApacheJServ:
   # /etc/rc.d/init.d/httpdcp start
   FreeBSD + ApacheJserv:
   # /usr/local/etc/rc.d/apachecp.sh start
   Any OS + Tomcat:
   # ~cpanel/tomcat/tomcat.sh start
10. After your have completed the upgrade, check the version of H-Sphere using the following command:
    # cat ~cpanel/shiva/psoft_config/HS_VERSION
    
    You will get something similar to this:
    
    Where:
    2.3.1 is the version of H-Sphere,
    352 is the build number,
    is the build date (in the YYYYMMDD format)