|
This document explains how to upgrade H-Sphere to 2.4.1 Patch 1 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 1.
- 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.1, 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 1 installation package from the Positive Software site:
Make sure the target directory doesn't contain any other U24.1P1 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.1P1
You will see a help window with a prompt to enter update options.
- To update H-Sphere to version 2.4.1 Patch 1 and Site Studio to version 1.6 Patch 1, enter:
update
- To update only H-Sphere to version 2.4.1 Patch 1, 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.
-
[-]
If you have a custom CP URL...
If you have customized your CP URL,
log in as root and run the jakarta_servlet_upt.pl script to apply custom servlet name
and mount point to Tomcat configuration files
and to the index page template ~cpanel/shiva/shiva-templates/index.html:
cd ~cpanel/shiva/psoft_config
./jakarta_servlet_upt.pl
The script replaces old servlet name and mount point in the following files:
~cpanel/apache/etc/mod_jk.conf
~cpanel/shiva/shiva-templates/index.html
Original configuration files are backed up:
~cpanel/apache/etc/mod_jk.conf.ORG
~cpanel/shiva/shiva-templates/index.html.ORG
- 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,
460 is the H-Sphere build,
You can have a later build of version 2.4.1.
|
