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

Requirements

• H-Sphere v.2.097 installed
• gcc compiler installed on each box.
• Apache 1.3.23 or higher and PHP 4.1.2 or higher installed on each H-Sphere web box. To download the latest versions of these products, go to Apache or PHP websites. Warning: If you have apache 1.3.19 and Mandrake as the operating system, don't perform the upgrade by yourselves, please contact psoft instead.

Procedure

1. Make sure to have version 2.097 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.1 installation package from the Positive Software web site at http://www.psoft.net/shiv/HSUpdate-21/U21.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. 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
7. After your have completed the upgrade, check the H-Sphere version using the following command:
   # cat ~cpanel/shiva/psoft_config/HS_VERSION
   
   You will get something similar to this:
   2.1.235.20020529
   Where:
   2.1 is the version of H-Sphere,
   235 is H-Sphere the build number,
   20020529 is the build date (in YYYYMMDD format)