This document explains how to upgrade H-Sphere to version 2.2.

Requirements

• H-Sphere v.2.1 installed
• Apache 1.3.23 or higher and PHP 4.1.2 or higher installed on each H-Sphere web box.
• If you want to download the latest versions of these products, turn to support@psoft.net
• gcc compiler installed on each box.

Procedure

1. Make sure to have version 2.1 installed:
   # cat ~cpanel/shiva/psoft_config/HS_VERSION
   If you have an older version, contact support@psoft.net or read the upgrade instruction for previous versions.
2. Download 2.2 installation package from the Positive Software web site at http://www.psoft.net/shiv/HSUpdate-22/U22.tgz
3. ungzip&untar the downloaded file:
   # wget ...
   # tar xfz [FILENAME]
   # cd [DIRECTORY]
4. Stop H-Sphere Control Panel using the following commands:
   (they depend on the OS type and java servlet running engine):
   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
5. Run the upgrade:
   # make install
6. You need to restart your SiteStudio ImageMaker, the simplest way to do it is to execute:
   killall java
   command under root.
   BE CAREFUL if you have any additional java processes running.
7. 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
8. After your have completed the upgrade, check the version of H-Sphere using the following command:
   # cat ~cpanel/shiva/psoft_config/HS_VERSION
   
   You will get something similar to this:
   2.2.266.20020529
   Where:
   2.2 is the version of H-Sphere,
   266 is H-Sphere the build number,
   20020730 is the build date (in YYYYMMDD format)