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 7
to H-Sphere version 2.3.1 Patch 8. 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/HS_VERSION
   
2. 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
3. Run the update script by typing:
   sh ./U23.1P8
Note: The help shows. Choose what you want to update and follow the help.
4. To update H-Sphere, type:
   # install
5. To update WebShell 3 to the latest available build, type:
   # webshell
6. 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.
7. 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.
8. 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
9. 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,
   384 is H-Sphere build,
   is the build date (in YYYYMMDD format)