Updating H-Sphere to 2.4.3 Patch 9

Release Notes  |     Install  |     Winbox Install  |     Winbox Update  |     Change Log  |     Package List

This document explains how to upgrade H-Sphere to 2.4.3 Patch 9 from 2.3.1 Patch 9 and up. If your H-Sphere 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, please contact H-Sphere support.

• Pre-Requisites
• Update Procedure
• Post-Update Issues

Pre-Requisites

Consider this before you update H-Sphere:

• The upgrade won't work without a valid H-Sphere license to cover all accounts in the system!

• Please refer to the list of operating systems supported by H-Sphere.

• Before the upgrade make sure you've upgraded:

  • MySQL to the latest available version
  • custom PostgreSQL and system PostgreSQL to 7.3 (for HS versions earlier than 2.4.1 Patch 2) or else to the latest available version.
  • Apache must be updated to the latest available version. Otherwise H-Sphere web boxes won't work.

• 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/home/cpanel/apache/conf/httpd.conf or contact H-Sphere support.

• In H-Sphere 2.4.3 RC 1 and up, custom server groups for name (DNS) logical servers are no longer supported! If you are upgrading from an earlier version, please remove all custom name server groups (including all respective logical/physical servers). Please refer to Server Groups for details.

• MySQL Updates.
  • If you are running MySQL version 3.x, please update to the latest MySQL 4.x version prior to updating H-Sphere to 2.5+.
  • Update MySQL v. 4.0 to 4.1 (HS 2.5 Patch 3+ or HS 2.5.1 Beta 2+) If your clients created databases/tables/fields in the tables with specific charset, please refer to the following documentation:
    - Character set upgrade
    - Connection Character Sets and Collations
    - MySQL service and ISAM storage engine available until MySQL 3.23

• Make sure that port 144 (localhost:144) is opened on all mailboxes.

Procedure

1. Make sure you 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 the 2.4.3 Patch 9 upgrade package:
   Linux:
   # wget http://www.psoft.net/shiv/HS/U24/U24.3P9/U24.3P9
   FreeBSD:
   # fetch http://www.psoft.net/shiv/HS/U24/U24.3P9/U24.3P9
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
   Stop SiteStudio ImageMaker by running:
   # /hsphere/shared/SiteStudio/imaker.sh stop
5. Run the update script:
   # sh ./U24.3P9

   You will see a help window with a prompt to enter update options.

6. Update H-Sphere.

   • to update H-Sphere and Site Studio, type:

     update

   • to update only H-Sphere, enter:

     hsupdate

   • to update only Site Studio, enter:

     ssupdate

   Note: After the update, you'll be able to add more servers or services to the cluster by following the Adding Servers and Adding Services documentation.

7. If your system database is not in UNICODE (UTF-8), convert it to UTF-8.
8. (H-Sphere 2.4.3 Patch 2 and up) You may update ProFTPd to the latest available version by typing in the following HS update option:
   proftpd
9. (H-Sphere 2.4.3 Patch 2 and up) As new H-Sphere versions update your vpopmail, you may need to reset mail quota settings to resolve possible problems followed by vpopmail update. To do this, type the following HS update script option:
   resetmailquota
   Note that this procedure, if performed separately of normal H-Sphere update, does not require downtime but may take long for large number of mail domains.
10. (H-Sphere 2.4.3 RC 2 and up) If your H-Sphere runs on Java 1.3 (especially when CP server is installed under FreeBSD), you may wish to update Java to version 1.4.2. For this, after you have successfully updated H-Sphere, type the following option in the update script interface:
    javaupdate

    This will also update your H-Sphere Java classes.

11. Upgrade your Winbox to 2.4.3 Patch 9.
12. H-Sphere update script will automatically launch H-Sphere CP after the update. Check if H-Sphere is running, and if not, start CP Apache:
    Linux:
    # /etc/rc.d/init.d/httpdcp start
    FreeBSD:
    # /usr/local/etc/rc.d/apachecp.sh start
13. Start ImageMaker if your H-Sphere is integrated with SiteStudio, for Linux & FreeBSD:
    # /hsphere/shared/SiteStudio/imaker.sh start
14. Check the version of H-Sphere by executing the following command on your CP box:
    # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
    
    You will see a line similar to this:
    
    HS_VERSION = 2.4.3.514
    Where:
    
    2.4.3 is the version of H-Sphere,
    514 is the H-Sphere build.
    

Post-Update Issues

After you have updated H-Sphere, please make sure you meet the following requirements:

• Winbox Update. Don't forget to upgrade Winbox to 2.4.3 Patch 9 if you haven't done this yet.

• Customization. If you have custom H-Sphere templates, you may probably need to update them according to changes introduced in this version.