H-Sphere Documentation Upgrades

 

Updating H-Sphere to 2.3.2 Patch 5

 

This document explains how to upgrade H-Sphere from:
- 2.3.1 Final
- 2.3.1 Patches
- 2.3.2 Release
- 2.3.2 Patches
to 2.3.2 Patch 5.

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 brings improvements to reseller traffic and disk usage and introduces phpBB 2.0.8.

IMPORTANT:

  • Owners of 2.4 betas - DON'T update to version 2.3.2.
  • To ensure correct performance of Windows-based hosting, upgrade your Winbox to 2.3.2 Patch 5.
  • The upgrade won't work without a valid H-Sphere license. Please check if you have enough licenses to cover all accounts in the system.
  • Before update, remember that H-Sphere supports the following operation systems:
    Linux RedHat (7.2, 7.3, RHES 2.1, RHWS 2.1, RHAS 2.1, RHWS3, RHES3, RHAS3) and FreeBSD (versions 4.7, 4.8, 4.9)

Procedure

  1. Make sure to have H-Sphere 2.3.1 Final installed:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
    If you have an older version, contact support@psoft.net or read how to upgrade from previous versions.
  2. Download 2.3.2 Patch 5 installation package from the Positive Software site:
    # wget http://www.psoft.net/shiv/HS/U23/U23.2P5/U23.2P5
    Make sure the target directory doesn't contain any other U23.2P5 file!
  3. Stop H-Sphere using one of the following commands:
    Linux:
    # /etc/rc.d/init.d/httpdcp stop
    FreeBSD:
    # /usr/local/etc/rc.d/apachecp.sh stop

    To stop SiteStudio, stop Imaker by running:
    # kill -9 `ps -axw|grep imaker.sh |grep -v grep|awk '{print $1}'`
    # kill -9 `ps -axw|grep ImageMaker|grep -v grep|awk '{print $1}'`

  4. Run the update script:
    # sh ./U23.2P5
    You will see a help window with a prompt to enter update options.
    To update H-Sphere to version 2.3.2 Patch 5 and Site Studio to version 1.6 RC 3, enter:
    update
    To update only H-Sphere to version 2.3.2 Patch 5, enter:
    hsupdate
    To update only Site Studio to 1.6 RC 3, enter:
    ssupdate
  5. If you have windows servers, update your Winbox to 2.3.2 Patch 5.
  6. Perform optional tasks that are not included into the above upgrade options. They have to be performed only once. If you've performed them before, don't do it now.
    • To correct the sizes of H-Sphere DB fields, run:
      moddb
      Note: It backs up DB before resizing fileds. Backup can be found in var/backup/hs_bck.tgz.
    • If you have custom templates using H-Sphere Freemarker validation function calls, back them up and run:
      convtempl
      Note: It will convert them to accomodate new customer template style as of version 2.3.1. It's required if you are upgrading your system from any of 2.3 versions and you have custom templates.
  7. Start H-Sphere CP:
    Linux:
    # /etc/rc.d/init.d/httpdcp start
    FreeBSD:
    # /usr/local/etc/rc.d/apachecp.sh start
  8. Start ImageMaker:
    Linux:
    # /hsphere/shared/SiteStudio/imaker.sh >& /hsphere/shared/SiteStudio/var/error_log 2>&1 &
    FreeBSD:
    # /hsphere/shared/SiteStudio/imaker.sh >& /hsphere/shared/SiteStudio/var/error_log &
  9. If the update breaks SiteStudio demo, follow the Troubleshooter.
  10. Check the version of H-Sphere:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION

    You will see a line similar to this:
    HS_VERSION = 2.3.2.391.20040408
    Where:
    2.3.2 is the version of H-Sphere,
    391 is H-Sphere build,
    20040408 is the build date (in YYYYMMDD format)



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