Parallels H-Sphere - 3.6 Upgrade Guide
Parallels® H-Sphere
Parallels H-Sphere Upgrade Guide
Revision 1.0
Legal and Copyright Notice
ISBN: N/A
Parallels Holdings, Ltd.
c/o Parallels International GmbH
Vordergasse 59
CH-Schaffhausen
Switzerland
Phone: +41-526320-411
Fax: +41-52672-2010
© Copyright 2011,
Parallels, Inc.
All rights reserved
www.parallels.com
This product is protected by United States and international copyright laws. The product’s
underlying technology, patents, and trademarks are listed at
http://www.parallels.com/trademarks.
Microsoft, Windows, Windows Server, Windows NT, Windows Vista, and MS-DOS are
registered trademarks of Microsoft Corporation.
Linux is a registered trademark of Linus Torvalds.
Mac is a registered trademark of Apple, Inc.
All other marks and names mentioned herein may be trademarks of their respective owners.
Contents
Preface 5
Typographical Conventions ........................................................................................................... 5
Feedback ....................................................................................................................................... 6
About This Guide 7
Preparing for Parallels H-Sphere Upgrade 8
Upgrading Parallels H-Sphere 9
Step 1. Updating Parallels H-Sphere Control Panel Core ............................................................. 9
Step 2. Starting Control Panel Apache ........................................................................................ 10
Step 3. installing a new License .................................................................................................. 10
Step 4. Updating Physical Boxes ................................................................................................ 10
Option 1. Updating Physical Boxes from the Control Panel .............................................. 11
Option 2. Updating Physical Boxes from Command Line ................................................. 11
Finalizing update of Physical Boxes carrying Database Servers ...................................... 11
Step 5. Starting ImageMaker ....................................................................................................... 12
Step 6. Checking the Version of Parallels H-Sphere ................................................................... 12
Post-Upgrade Issues 13
Appendix A. Supported Operating Systems 14
Appendix B. HDD Partitioning 16
Appendix C. Customizing Server Configuration Files by Means of Templates 17
Control Panel Apache .................................................................................................................. 19
Extra Control Panel Apache Configuration Files ......................................................................... 19
Apache ......................................................................................................................................... 21
Extra Apache Configuration Files ................................................................................................ 22
PHP 4 .......................................................................................................................................... 23
PHP 5 .......................................................................................................................................... 23
FTP .............................................................................................................................................. 24
MySQL ......................................................................................................................................... 26
PostgreSQL ................................................................................................................................. 27
DNS ............................................................................................................................................. 28
Other Files Included into Parallels H-Sphere Packages ............................................................. 29
Appendix D. Download Locations 30
Mirror Server for Updating Parallels H-Sphere ............................................................................ 31
Preface 4
Appendix E. Creating Update Profiles for Physical Servers 32
hsphere-update Package Reference ........................................................................................... 34
Appendix F. Parallels H-Sphere Update and Installation Script 36
Update Modes and Options ......................................................................................................... 38
Selective Update of Parallels H-Sphere *nix Packages .............................................................. 43
Updating Parallels H-Sphere with Default Configuration Files Not Customized By Means of File
Templates .................................................................................................................................... 44
In this chapter:
Typographical Conventions ............................................................................... 5
Feedback .......................................................................................................... 6
Formatting convention
Type of Information
Example
Special Bold
Items you must select,
such as menu options,
command buttons, or
items in a list.
Go to the System tab.
Titles of chapters,
sections, and
subsections.
Read the Basic
Administration chapter.
Italics
Used to emphasize the
importance of a point, to
introduce a term or to
designate a command
line placeholder, which is
to be replaced with a real
name or value.
The system supports the
so called wildcard
character search.
Monospace
The names of
commands, files,
directories, and domain
names.
The license file is located
in the
http://docs/common/
licenses directory.
C H A P T E R 1
Preface
Typographical Conventions
Before you start using this guide, it is important to understand the documentation
conventions used in it.
The following kinds of formatting in the text identify special information.
6 Preface
Preformatted
On-screen computer
output in your commandline sessions; source
code in XML, C++, or
other programming
languages.
# ls –al /files
total 14470
Preformatted
Bold
What you type,
contrasted with on-screen
computer output.
# cd /root/rpms/php
CAPITALS
Names of keys on the
keyboard.
SHIFT, CTRL, ALT
KEY+KEY
Key combinations for
which the user must
press and hold down one
key and then press
another.
CTRL+P, ALT+F4
Feedback
If you have found a mistake in this guide, or if you have suggestions or ideas on how to
improve this guide, please send your feedback using the online form at
http://www.parallels.com/en/support/usersdoc/. Please include in your report the
guide's title, chapter and section titles, and the fragment of text in which you have found
an error.
This guide provides instructions on upgrading Parallels H-Sphere 3.5.1 to version 3.6.0.
C H A P T E R 2
About This Guide
If you have an older version, you need to upgrade to 3.5.1.
Before you start upgrading Parallels H-Sphere to version 3.6, please obtain a license
C H A P T E R 3
Preparing for Parallels H-Sphere Upgrade
for this version, as you will need it to access the upgraded Control Panel.
As both MySQL and PostgreSQL are updated in Parallels H-Sphere 3.6, it is strongly
recommended that you back up all databases hosted in MySQL and PostgreSQL: all
user databases on database servers, Control Panel database on Control Panel server.
In a straightforward and simple approach it can be done with the following shell
commands:
For FreeBSD:
# stop
/usr/local/etc/rc.d/apachecp.sh stop # actual only for CP server, but
no problem to run it everywhere
/usr/local/etc/rc.d/010.pgsql.sh stop
/usr/local/etc/rc.d/mysql-server stop
cp -pR /var/db/mysql /var/db/mysql-backup # you can specify other
destination directory
cp -pR /usr/local/pgsql /usr/local/pgsql-backup # you can specify other
destination directory
# start
/usr/local/etc/rc.d/mysql-server start
/usr/local/etc/rc.d/010.pgsql.sh start
/usr/local/etc/rc.d/apachecp.sh start # actual only for CP server, but
no problem to run it everywhere
For RedHat:
# stop
service httpdcp stop # actual only for CP server, but no problem to run
it everywhere
service postgresql stop
service mysql stop
cp -pR /var/lib/mysql /var/lib/mysql-backup # you can specify other
destination directory
cp -pR /var/lib/pgsql /var/lib/pgsql-backup # you can specify other
destination directory
# start
service mysql start
service postgresql start
service httpdcp start # actual only for CP server, but no problem to run it everywhere.
To upgrade Parallels H-Sphere, please perform the steps provided in this chapter.
In this chapter:
Step 1. Updating Parallels H-Sphere Control Panel Core .................................. 9
Step 2. Starting Control Panel Apache .............................................................. 10
Step 3. installing a new License ........................................................................ 10
Step 4. Updating Physical Boxes ....................................................................... 10
Step 5. Starting ImageMaker ............................................................................. 12
Step 6. Checking the Version of Parallels H-Sphere .......................................... 12
C H A P T E R 4
Upgrading Parallels H-Sphere
Step 1. Updating Parallels H-Sphere
Control Panel Core
To update Parallels H-Sphere CP core:
1. Download H-Sphere updater:
# wget
http://download.hsphere.parallels.com/shiv/HS/releases/U36.0/U36.0/U36.
0
2. Run the installation/update script:
# sh ./U36.0
You will see a help window with a prompt to enter update options.
3. Update Parallels H-Sphere core (templates, classes, jars):
cpupdate [OPTIONS]
To finalize update of Parallels H-Sphere CP core:
1. Set PostgreSQL service automatically startable on Linux:
# chkconfig --levels 2345 postgresql on
Step 2. Starting Control Panel Apache
In this section:
Option 1. Updating Physical Boxes from the Control Panel ................................ 11
Option 2. Updating Physical Boxes from Command Line ................................... 11
Finalizing update of Physical Boxes carrying Database Servers ........................ 11
Parallels H-Sphere update script will automatically launch Parallels H-Sphere CP after the
update. Check if Parallels H-Sphere is running, and if not, start CP Apache:
Linux:
# /etc/rc.d/init.d/httpdcp start
FreeBSD:
# /usr/local/etc/rc.d/apachecp.sh start
Step 3. installing a new License
1. Log in to the Control Panel as administrator.
You will be prompted to enter new license activation code.
2. Enter the code.
Now you can log out from Control Panel, unless you are going to update physical boxes
using it.
Step 4. Updating Physical Boxes
You have two options for updating Parallels H-Sphere packages on physical boxes:
Option 1. From the Control Panel (it is the only option available for Windows boxes).
Option 2. From the command line by running the installation/update script (on page 36).
After Parallels H-Sphere packages are updated, please finalize update on physical boxes
carrying database servers.
Option 1. Updating Physical Boxes from the Control Panel
To update Parallels H-Sphere on selected physical servers:
1. Go to E.Manager > Update > Update Boxes.
2. Check the servers you need to update.
3. If necessary, you can get info about the box by checking boxes and clicking
the Fetch Boxes Info button.
4. Click Start Update.
Update process indicator legend:
Yellow: ready for update
Blue: update is running
Green: update successfully finished
Red: update finished with error. If update fails, you will see an error message with details.
Option 2. Updating Physical Boxes from Command Line
Run the installation/update script:
# $ sh ./U36.0
To update Parallels H-Sphere and Parallels SiteStudio, type:
update [OPTIONS]
To update only Parallels H-Sphere, enter:
hsupdate [OPTIONS]
To update only Parallels SiteStudio, enter:
sitestudio [OPTIONS]
Important: If you have a non-standard setup of Parallels H-Sphere, please refer to Appendix
F. Parallels H-Sphere Update and Installation Script. You can refer to it also for details on the
above mentioned options.
Finalizing update of Physical Boxes carrying Database
Servers
For the Linux based physical boxes carrying PostgreSQL servers, set PostgreSQL service
automatically startable:
# chkconfig --levels 2345 postgresql on
For the physical boxes carrying MySQL server, perform databases upgrade:
# mysql_upgrade -v -u USER -p
# mysqlcheck -o -A -a -r -u USER -v -p
where value to specify instead of USER, and the corresponding password - could be read
from file ~mysql/.my.cnf on this physical box.
Step 5. Starting ImageMaker
Start ImageMaker if your Parallels H-Sphere is integrated with Parallels SiteStudio, for Linux
and FreeBSD:
# /hsphere/shared/SiteStudio/imaker.sh start
Step 6. Checking the Version of Parallels HSphere
Check the version of Parallels H-Sphere by executing the following command on your CP
box:
# cat ~cpanel/shiva/psoft_config/HS_VERSION
You will see a line similar to this:
HS_VERSION = <HSphere-branch>.<HSphere-build>
Where:
<HSphere-branch> is the version of Parallels H-Sphere
<HSphere-build> is the Parallels H-Sphere build
Please contact support at http://www.parallels.com/support/hsphere/ and inform them
C H A P T E R 5
Post-Upgrade Issues
about the upgrade. This is required to get appropriate support from Parallels. Also
make sure you meet the following requirements:
1. Customization. If you have custom Parallels H-Sphere templates, you may
probably need to update them according to changes introduced in this version.
More in the section Template Customization of Parallels H-Sphere Customization
Guide.
2. Ownership. In Parallels H-Sphere HTML pages, images, Javascript and CSS files
and respective directories have cpanel:httpdcp ownership. Parallels H-Sphere
updater checks and automatically sets correct ownership and permissions on
respective default and custom files and directories. Please make sure however that
newly created custom files have correct ownership and permissions (this does not
relate to Parallels H-Sphere packages).
3. VPS: After you have updated Parallels H-Sphere, please also make sure you run
Steps 3-8 of the Parallels H-Sphere VPS update instruction. For this, refer to the
section Updating Parallels H-Sphere Virtual Private Servers of Adding New HSphere Servers and Services guide.
4. DBD::mysql Perl driver. If you want to update DBD::mysql driver or system Perl
version, make sure to execute the script that updates DBD::mysql driver as
described at http://hsphere.parallels.com/misc/socket_location_mysql_server.html.
5. Set up Kronolith Reminders: If you use Kronolith reminders, make sure to set
them up according to
http://wiki.horde.org/KronolithReminders?Horde=b80c80a948f71e51023fe0c5d7584
7bc&referrer=HowTo.
Before requesting Parallels H-Sphere installation, make sure to install one of the
Operating System
Supported OS Version
RedHat Enterprise Linux
3.x
4.x; 4.x (x86_64)
5.x; 5.x (x86_64)
6.x; 6.x (x86_64)
CentOS
3.x
4.x; 4.x (x86_64)
5.x; 5.x (x86_64)
6.x; 6.x (x86_64)
CloudLinux
5.5
White Box Enterprise
Linux
3.x
4.x; 4.x (x86_64)
FreeBSD
6.1
6.2
6.3
6.4
7.0; 7.0 (amd64)
7.1; 7.1 (amd64)
7.2; 7.2 (amd64)
C H A P T E R 6
Appendix A. Supported Operating
Systems
following operating systems:
Loading...