This document explains how to upgrade H-Sphere from 2.3.1 Patch 9, any of 2.3.2 versions,
earlier 2.4 betas and 2.4 RCs to 2.4 Final. If your H-Sphere is lower than 2.3.1 Patch 9, please
update to this version first.
This new version incorporates a great number of new features,
like packaging, AntiSpam and AntiVirus filtering that were included into previous 2.4 versions.
IMPORTANT:
- Don't forget to upgrade Winbox to 2.4 Final 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)
- For correct performance of WebShell4, you need 1.3.29 apache update.
- If you have custom templates, you'll have to update them according to the new requirements.
Procedure
- Make sure to have H-Sphere 2.3.1 Patch 9 or an earlier 2.4 beta installed:
# cat ~cpanel/shiva/psoft_config/hsphere.properties | grep HS_VERSION
- Download 2.4 Final installation package from the Positive Software site:
Make sure the target directory doesn't contain any other U24.0 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.0
You will see a help window with a prompt to enter update options.
- To update H-Sphere to version 2.4 Final and Site Studio to version 1.6 RC 3, enter:
update
- To update only H-Sphere to version 2.4 Final, enter:
hsupdate
- To update only Site Studio to 1.6 RC 3, enter:
ssupdate
Important:
To work with H-Sphere 2.4 Final upgraded from version 2.3,
Site Studio must be updated to 1.6 RC 3
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 holds data in international encoding format,
update it to UTF-8.
- Upgrade your Winbox to 2.4 Final.
- 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.0 is the version of H-Sphere,
424 is H-Sphere build,
You can have a later build of version 2.4.0.
|