H-Sphere 3.0 Patch 7 is the latest stable version.
Release Notes | Update | Change Log | Package List
Consider this before you install H-Sphere:
Step 1. Download the Installation/Update Script
Log into the server where you install H-Sphere as root:
$ su -l
Download the 3.0 Patch 7 install/update script:
# wget http://www.psoft.net/shiv/HS/releases/U30.0/U30.0P7/U30.0P7
# fetch http://www.psoft.net/shiv/HS/releases/U30.0/U30.0P7/U30.0P7
Important: Since H-Sphere 3.0 +,
you can download installation/update script from our mirror site at
More information in H-Sphere install/update script options
Step 2. Run the Installer
To start installation, run the install/update script with the install option:
# sh U30.0P7 install
Then, choose one of the options, depending on the installation mode:
More about H-Sphere install/update script options.
1) Regular Installation From Scratch
If you need a fresh H-Sphere installation:
Choose the cpinstall mode to install basic H-Sphere packages on the CP server
to be able to run H-Sphere Control Panel. In the installer's command line type in the following command:
cpinstall zone=SERVICE_ZONE ip=SERVICE_IP
where SERVICE_ZONE is the service domain name (for example, samplehosting.com), and
SERVICE_IP is the service domain IP.
This will start the Control Panel installation process.
Upon successful installation, run H-Sphere Control Panel at http://SERVICE_IP:8080/ in your favorite browser.
Note: If you have problems with running Control Panel, please try to
stop CP service and start it again.
Log into H-Sphere Control Panel as admin with password admin.
Later on you will be able to change the admin password.
After you log in, you must enter your valid H-Sphere license purchased from PSoft.
Otherwise, you won't be able to proceed with the installation.
Run H-Sphere Installation Wizard
which allows shaping your H-Sphere cluster by adding boxes and hosting services and configuring basic H-Sphere settings.
To install SiteStudio with H-Sphere, run after the H-Sphere installation:
# sh U30.0P7 install postinstall sitestudio
2) Installation with Prepared H-Sphere Configuration
Now it is possible to perform H-Sphere installation by importing a specially formatted config.xml file
with all H-Sphere physical and logical servers' configuration.
More on config.xml |
Run the install script with the install option. In the installer's command line, enter:
install xml=CONFIG_XML_LOCATION [ skip-sitestudio ]
Learn how to form config.xml by means of
H-Sphere Installation Wizard in Control Panel.
When the installation is finished, H-Sphere Control Panel
will be available at http://SERVICE_IP:8080
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 on post-installation issues