H-Sphere Documentation Upgrades


Upgrading H-Sphere to 2.3.1 Patch 9


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.

1. To ensure correct performance of new features, upgrade your winbox to 2.3.1.
2. Prior to the upgrade, adjust your custom designs into accordance with the design implementation rules.


  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
    If you have an older version, contact support@psoft.net or read upgrade instruction for previous versions.
  2. Download 2.3.1 Patch 9 installation package from the Positive Software site:
    # wget http://www.psoft.net/shiv/HS/U23/U23.1P9/U23.1P9
    * 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
  5. Note: The help shows. Choose what you want to update and follow the help.
  6. To update H-Sphere, type:
    # install
  7. To update your SiteStudio to 1.6 RC2, type:
    # ss
    If the update breaks SiteStudio demo, follow the Troubleshooter.
  8. To update WebShell 3 to the latest available build, type:
    # webshell
  9. 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.
  10. 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.
  11. 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
  12. 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:
    2.3.1 is the version of H-Sphere,
    385 is H-Sphere build,
    20031215 is the build date (in YYYYMMDD format)

Copyright 1998-2006. Positive Software Corporation.
All rights reserved.