This document explains how to upgrade H-Sphere:
- 2.3 Final
- 2.3 Patches
- 2.3.1 Betas
- 2.3.1 RCs
- 2.3.1 Final
- 2.3.1 Patches 1 to 8
to H-Sphere version 2.3.1 Patch 9. If you have H-Sphere older than 2.3, make sure to upgrade your H-Sphere to 2.3 Final first.

This patch eliminates an account information security hole.

Procedure

1. Make sure to have any of 2.3 or 2.3.1 versions installed:
   # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
   
2. Download 2.3.1 Patch 9 installation package from the Positive Software site:
   * Make sure the directory you are downloading it to doesn't contain any other U23.1P9 file!
3. Stop H-Sphere using one of the following commands:
   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.1P9
Note: The help shows. Choose what you want to update and follow the help.
5. To update H-Sphere, type:
   # install
6. To update your SiteStudio to 1.6 RC2, type:
   # ss
   
7. To update WebShell 3 to the latest available build, type:
   # webshell
8. 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.
9. 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.
10. 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
11. 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.3.1 is the version of H-Sphere,
    385 is H-Sphere build,
    is the build date (in YYYYMMDD format)