Last modified: 27 Dec 2007
WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the
official Parallels site.
This document explains how to install H-Sphere 2.3.2 Patch 5 using public installation
scripts. Please make sure to have your servers prepared as instructed in the
Preparing Servers for H-Sphere Installation manual.
- Preparing H-Sphere
- Installing H-Sphere
Step 1. Download
Now that you have prepared the servers, you can start the installation.
At this step, you will download the install.
- Download the installation scripts:
- untar/ungzip the hsinst.tgz archive:
# tar xfz ./hsinst.tgz
and cd into the installation directory:
# cd hsinst
Step 2. Configuration
At this step, you will create configuration files.
- If your current H-Sphere hasn't been installed with the 2.3.2 installer,
collect your current H-Sphere configuration:
Skip this step if you are installing H-Sphere for the first time.
- Launch the configuration wizard to enter installation data:
- Follow the wizard to provide configuration data. Make sure to specify
real SMTP server IP in the web and cp server configuration. In most cases
this is the IP of your future mail server. The mail service must have all
relays configured properly. Note that SingleDNS must be selected only when
one DNS server is present in system. In SingleDNS configuration, usual DNS
is required too.
Step 3. Preparing H-Sphere
Once you have completed the configuration wizard, type make build
to compile H-Sphere. This will:
- create hsphere directory if it doesn't exist;
- generate all config files;
- remove old version of H-Sphere, if it's installed;
- generate ssh keys and places them to all servers. You'll need to enter root password to each server;
- upload install to all servers;
- create hsphere directory on each server;
- export all passwords to /root/hsphere.info.txt.
Step 4. Installing H-Sphere
Log into each server as root and execute:
To install H-Sphere without SiteStudio, execute:
instead of make install
If you decide to add SiteStudio, log into your control panel server and execute:
If you have chosen to setup your web server without or separately from the mail server,
you need to install (if not installed) and configure an MTA (Mail Transport Agent)
such as sendmail to ensure the performance of formmail scripts.
If you have installed H-Sphere with NAT support, you need to run the
DNSCreator tool afterwards
using the -m db -dz parameters.
For more details, check with the README file that comes with the installation.
When the installation is finished, H-Sphere Control Panel
will be available at http://_IP_OF_HSphere_CP_:8080
The current version of H-Sphere comes with SiteStudio, which requires
XFree86 Virtual Framebuffer installed. H-Sphere installer checks for
missing XFree86 libs and packages and sets them up if they are missing.
If you have a custom version of XFree86 (different from the one
included into your OS distribution), you need to install XFree86 Virtual
Framebuffer manually and execute make install again on the
control panel server.
H-Sphere install program doesn't set up missing service IPs. You
should set them up manually.
After H-Sphere is installed, it includes two accounts which may not be deleted:
- the admin account (login: admin, password: admin)
to configure system settings. It is very highly recommended to
change the password of the admin account after the installation
and testing have been completed.
- the wwwuser account to manage the control panel domain, which
is also used by the other servers of the system. More..