This document explains how to update your H-Sphere from 2.3, 2.3.1 Beta 1-4, and 2.3.1 RC 1-2
to 2.3.1 RC 3.
To perform this update, you have to be logged in as root.
IMPORTANT:
1. To ensure correct performance of new features,
please upgrade your winbox to 2.3.1.
2. Prior to the upgrade, please adjust your custom design implementation into accordance with the
rules described
here.
Otherwise, your custom designs may be displayed incorrectly.
3. If you are upgrading from 2.3.1 RC 2, check the the build of your H-Sphere.
If it's 2.3.360, you need to reinstall 2.3.1 RC2
to get a newer build (2.3.361) with fixes to some templates.
To perform the upgrade:
- Make sure to have H-Sphere 2.3 final (build 2.3.321) or later installed:
# cat ~cpanel/shiva/psoft_config/HS_VERSION
- Download 2.3.1 RC 3 installation script from the Positive Software web site at:
- Stop H-Sphere Control Panel using the following commands:
(they depend on the OS type and java servlet running engine):
Linux + ApacheJServ:
# /etc/rc.d/init.d/httpdcp stop
FreeBSD + ApacheJserv:
# /usr/local/etc/rc.d/apachecp.sh stop
Any OS + Tomcat:
# ~cpanel/tomcat/tomcat.sh stop
- Run the update script by typing:
sh ./U23.1RC3
Note: The help shows. Choose what you want to update and follow the help.
- To update H-Sphere, type:
# install
- To update WebShell 3 to the latest available build, type:
# webshell
- If you have custom templates using H-Sphere Freemarker validation function calls,
back them up and run
# convtempl
This will update them to work with the improved H-Sphere data validation.
- If you updated SiteStudio, restart your SiteStudio ImageMaker. The simplest way to do it is type:
# killall java
Kill these processes one by one if you have any other java processes running.
- Start H-Sphere CP using one of the following commands:
Linux + ApacheJServ:
# /etc/rc.d/init.d/httpdcp start
FreeBSD + ApacheJserv:
# /usr/local/etc/rc.d/apachecp.sh start
Any OS + Tomcat:
# ~cpanel/tomcat/tomcat.sh start
- After your have completed the upgrade, check the version
of H-Sphere using the following command:
# cat ~cpanel/shiva/psoft_config/HS_VERSION
You will get something similar to this:
Where:
2.3.1 is the version of H-Sphere,
370 is the build number,
is the build date (in the YYYYMMDD format)
The following steps explain how to update hsphere-vps RPM file. If you don't run VPS on your servers, skip it.
- Check the Virtual Private Server tools version:
rpm -qa|grep hsphere-vps
You will see something similar to:
hsphere-vps-0.98-7
- Uninstall old VPS tools:
rpm -e hsphere-vps-x.xx-xx
where x.xx-xx is the old VPS version and release.
- Install the latest package (for now it's:hsphere-vps-0.98-30.noarch.rpm):
rpm -ivh hsphere-vps-0.98-30.noarch.rpm
|