| 
    This document explains how to upgrade H-Sphere to 2.4.1 Patch 2 from 2.3.1 Patch 9,   2.3.2,   2.4 and all of 2.4.1 
     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 one after the other, from lower to higher. 
    
    IMPORTANT: 
    
       - hsphere-mail2-all-8 is included into 2.4.1 Patch 2.
 
       
       - Don't forget to upgrade Winbox to 2.4.1 Patch 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.x, and FreeBSD (4.7 - 4.10) 
      - 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.
 
      
     
     
    Procedure 
   
    
    - Download 2.4.1 Patch 2 installation package from the Positive Software site:
 
       
    Make sure the target directory doesn't contain any other U24.1P2 file! 
    - Make sure that permissions to /usr/bin/wget are set to 0755 during the installation.
 
    - 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}'`  
    - Run the update script:
 
      # sh ./U24.1P2 
      You will see a help window with a prompt to enter update options.
      
       - To update H-Sphere to version 2.4.1 Patch 2 and Site Studio to version 1.6 Patch 1, enter:
 
        update 
      - To update only H-Sphere to version 2.4.1 Patch 2, enter:
 
        hsupdate 
      - To update only Site Studio to 1.6 Patch 1, enter:
 
        ssupdate 
      Important:
        To work with H-Sphere 2.4.1 upgraded from version 2.3, Site Studio must be updated to 1.6 Patch 1 
      
     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. 
    - If your system database is not in UNICODE (UTF-8),
      convert it to UTF-8.
 
    - Upgrade your Winbox to 2.4.1 Patch 1 if you have an older version.
 
    - Start H-Sphere CP:
 
       Linux: 
       # /etc/rc.d/init.d/httpdcp start 
       FreeBSD: 
       # /usr/local/etc/rc.d/apachecp.sh start 
      - 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 &
  
    - Check the version of H-Sphere:
 
       # cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION 
        
       You will see a line similar to this: 
       
       Where: 
       2.4.1 is the version of H-Sphere, 
       462 is the H-Sphere build, 
       
         You can have a later build of version 2.4.1.
  
    
                 |