H-Sphere Documentation Upgrades


Updating H-Sphere to 2.3.2 Patch 1


This document explains how to upgrade H-Sphere from:
- 2.3.1 Betas
- 2.3.1 RCs
- 2.3.1 Final
- 2.3.1 Patches 1 to 9
- 2.3.2 Release
to 2.3.2 Patch 1.

If you have H-Sphere older than 2.3.1, make sure to upgrade your H-Sphere to 2.3.1 Final first.

This patch eliminates an account information security hole.

1. Owners of 2.4 betas - DON'T update to version 2.3.2.
2. To ensure correct performance of new features, upgrade your winbox to 2.3.2.


  1. Make sure to have any of the 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.2 Patch 1 installation package from the Positive Software site:
    # wget http://www.psoft.net/shiv/HS/U23/U23.2P1/U23.2P1
    * Make sure the directory you are downloading it to doesn't contain any other U23.2 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
  4. Run the update script by typing:
    sh ./U23.2P1
    Note: The help shows. Choose what you want to update and follow the help.
  5. To update H-Sphere, type:
    # install
  6. Make sure to update H-Sphere if you are going to update WebShell!
  7. To update your SiteStudio to 1.6 RC3, type:
    # ss
    If your SiteStudio is installed on a separate server, log into that server as root and perform this procedure skipping the update of H-Sphere and WebShell.
    If the update breaks SiteStudio demo, follow the Troubleshooter.
  8. To update WebShell 3 to the latest available build, type:
    # webshell
    Note: Webshell update is related to the Microsoft Security Update.
  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
  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:
    2.3.2 is the version of H-Sphere,
    387 is H-Sphere build,
    20040206 is the build date (in YYYYMMDD format)

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