H-Sphere Documentation Upgrades

 

Upgrading H-Sphere to 2.3.1 Patch 2

 

This document explains how to upgrade H-Sphere:
- 2.3 Final
- 2.3 Patches
- 2.3.1 Final
- 2.3.1 Patch1
- 2.3.1 RCs
- 2.3.1 Betas
to H-Sphere version 2.3.1 Patch 2. If you have H-Sphere older than 2.3, make sure to upgrade your H-Sphere to 2.3 Final first.

IMPORTANT:

1. To ensure correct performance of new features, please upgrade your winbox to 2.3.1.

2. Prior to the upgrade, please adjust your custom design implementation into accordance with the rules described here. Otherwise, your custom designs may be displayed incorrectly.

Procedure

  1. Make sure to have any of 2.3 or 2.3.1 versions installed:
    # cat ~cpanel/shiva/psoft_config/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 2 installation package from the Positive Software site:
    # wget http://www.psoft.net/shiv/HS/U23/U23.1P2/U23.1P2
    * Make sure the directory you are downloading it to doesn't contain any other U23.1P2 file!
  3. 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
  4. Run the update script by typing:
    sh ./U23.1P2
  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
    Note: Updating SiteStudio may cause malfunction of the SiteStudio demo. To fix this problem, please refer to 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. 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.3.1.377.20030804
    Where:
    2.3.1 is the version of H-Sphere,
    377 is H-Sphere the build number,
    20030807 is the build date (in YYYYMMDD format)

  13. Important: If you offer virtual private servers, please update hsphere-vps packages.



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