H-Sphere Documentation Upgrades

For more information contact us

Upgrading H-Sphere to 2.4.1 RC 3

 

This document explains how to upgrade H-Sphere to 2.4.1 RC 3 from 2.3.1 Patch 9,   2.3.2,   2.4, 2.4.1 Betas and 2.4.1 RCs.
If your H-Sphere version is lower than 2.3.1 Patch 9 (build 2.3.1.385), please upgrade to 2.3.1 Patch 9 first.

To upgrade from a version lower than 2.2, you must upgrade to all transitional versions (marked with asterisks in the list of H-Sphere versions) one after the other, from lower to higher.

This candidate fixes problems with PayPal accounts autocreation and improper encoding of autoresponder message.

IMPORTANT:

  • hsphere-mail2-all-8 is included into 2.4.1 RC 3 update.
  • Don't forget to upgrade Winbox to 2.4.1 RC 1 if you have an older version.
  • The upgrade won't work without a valid H-Sphere license to cover all accounts in the system.
  • H-Sphere currently supports only the following operation systems:
    Linux RedHat (7.2, 7.3, RHES 2.1, RHWS 2.1, RHAS 2.1, RHWS3, RHES3, RHAS3), CentOS 3.1, and FreeBSD (4.7 - 4.9)
  • Before the upagrade make sure you've upgraded MySQL to 4.x, your user PostgreSQL to 7.3, and system PostgreSQL to 7.3.
  • For correct performance of WebShell4, you need 1.3.31 apache update.
  • If you have custom templates, you'll have to update them according to the new requirements.
  • If you have a mail server running on the same box as the CP server, and CP server uses port 80, change CP port to 8080 in /hsphere/local/config/httpd/httpd.conf or contact hsphere support.

Procedure

  1. Make sure to have H-Sphere 2.3.1 Patch 9 or higher installed:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
    If you have an older version, contact support or read how to upgrade from previous versions.
  2. Download 2.4.1 RC 3 installation package from the Positive Software site:
    # wget http://www.psoft.net/shiv/HS/U24/U24.1RC3/U24.1RC3
    Make sure the target directory doesn't contain any other U24.1RC3 file!
  3. Make sure that permissions to /usr/bin/wget are set to 0755 during the installation.
  4. 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}'`

  5. Run the update script:
    # sh ./U24.1RC3
    You will see a help window with a prompt to enter update options.
    • To update H-Sphere to version 2.4.1 RC 3 and Site Studio to version 1.6 Final, enter:
      update
    • To update only H-Sphere to version 2.4.1 RC 3, enter:
      hsupdate
    • To update only Site Studio to 1.6 Final, enter:
      ssupdate
      Important: To work with H-Sphere 2.4.1 RC 3 upgraded from version 2.3, Site Studio must be updated to 1.6 Final
    Note: After the installation, you'll be able to add more servers or services to the cluster by following the Adding Servers and Adding Services manuals.
  6. If your system database is not in UNICODE (UTF-8), convert it to UTF-8.
  7. Upgrade your Winbox to 2.4.1 RC 1 if you have an older version.
  8. Start H-Sphere CP:
    Linux:
    # /etc/rc.d/init.d/httpdcp start
    FreeBSD:
    # /usr/local/etc/rc.d/apachecp.sh start
  9. Start ImageMaker:
    Linux:
    # /hsphere/shared/SiteStudio/imaker.sh start >& /hsphere/shared/SiteStudio/var/error_log 2>&1 &
    FreeBSD:
    # /hsphere/shared/SiteStudio/imaker.sh start >& /hsphere/shared/SiteStudio/var/error_log &
  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.4.1.457.20040826
    Where:
    2.4.1 is the version of H-Sphere,
    457 is H-Sphere build,
    20040826 is the build date (in YYYYMMDD format)
    You can have a later build of version 2.4.1.


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