This document explains how to upgrade H-Sphere from:
- 2.3.1 Final
- 2.3.1 Patches
- 2.3.2 Release
- 2.3.2 Patches
to 2.3.2 Patch 5.

This patch brings improvements to reseller traffic and disk usage and introduces phpBB 2.0.8.

Procedure

1. Make sure to have H-Sphere 2.3.1 Final installed:
   # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
   
2. Download 2.3.2 Patch 5 installation package from the Positive Software site:
   Make sure the target directory doesn't contain any other U23.2P5 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
   

   To stop SiteStudio, stop Imaker by running:
   # kill -9 `ps -axw|grep imaker.sh |grep -v grep|awk '{print $1}'`
   # kill -9 `ps -axw|grep ImageMaker|grep -v grep|awk '{print $1}'`
   

4. Run the update script:
   # sh ./U23.2P5
   You will see a help window with a prompt to enter update options.
   To update H-Sphere to version 2.3.2 Patch 5 and Site Studio to version 1.6 RC 3, enter:
   update
   To update only H-Sphere to version 2.3.2 Patch 5, enter:
   hsupdate
   To update only Site Studio to 1.6 RC 3, enter:
   ssupdate
   
5. If you have windows servers, update your Winbox to 2.3.2 Patch 5.
6. Perform optional tasks that are not included into the above upgrade options. They have to be performed only once. If you've performed them before, don't do it now.
   
   • To correct the sizes of H-Sphere DB fields, run:
     moddb
     Note: It backs up DB before resizing fileds. Backup can be found in var/backup/hs_bck.tgz.
   • If you have custom templates using H-Sphere Freemarker validation function calls, back them up and run:
     convtempl
     Note: It will convert them to accomodate new customer template style as of version 2.3.1. It's required if you are upgrading your system from any of 2.3 versions and you have custom templates.
7. Start H-Sphere CP:
   Linux:
   # /etc/rc.d/init.d/httpdcp start
   FreeBSD:
   # /usr/local/etc/rc.d/apachecp.sh start
   
8. Start ImageMaker:
   Linux:
   # /hsphere/shared/SiteStudio/imaker.sh >& /hsphere/shared/SiteStudio/var/error_log 2>&1 &
   FreeBSD:
   # /hsphere/shared/SiteStudio/imaker.sh >& /hsphere/shared/SiteStudio/var/error_log &
   
9. Check the version of H-Sphere:
   # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
   
   You will see a line similar to this:
   Where:
   2.3.2 is the version of H-Sphere,
   391 is H-Sphere build,