| 
    This document explains how to upgrade H-Sphere to 2.4.1 RC 2
     from 2.3.1 Patch 9,   2.3.2,   2.4, 2.4.1 Betas and 2.4.1 RC 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.
    
    This candidate introduces Qmail update and IMP webmail version 3.2.5. 
    
    IMPORTANT: 
    
      - hsphere-mail2-all-8 is included into 2.4.1 RC 2 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.
 
     
     
                Procedure 
                 
    
    - 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.1RC2 
      You will see a help window with a prompt to enter update options.
      
       - To update H-Sphere to version 2.4.1 RC 2 and Site Studio to version 1.6 Final, enter:
 
      update 
      - To update only H-Sphere to version 2.4.1 RC 2, enter:
 
      hsupdate 
      - To update only Site Studio to 1.6 Final, enter:
 
      ssupdate 
      Important:
        To work with H-Sphere 2.4.1 RC 2 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. 
    - If your system database is not in UNICODE (UTF-8),
      convert it to UTF-8.
 
    - Upgrade your Winbox to 2.4.1 RC 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 >& /hsphere/shared/SiteStudio/var/error_log 2>&1 & 
         FreeBSD: 
         # /hsphere/shared/SiteStudio/imaker.sh >& /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, 
       456 is H-Sphere build, 
       
       You can have a later build of version 2.4.1.
  
    
                 |