H-Sphere Versions

For more information contact us

H-Sphere 2.5.1 Beta 3 Installation

22 Aug 2006


Release Notes  |     Update  |     Winbox Install  |     Winbox Update  |     Change Log  |     Package List

This H-Sphere version is outdated and is not supported. Please refer to latest supported versions.

Since H-Sphere 2.5.1 Beta 2, H-Sphere is installed and updated by means of single install/update script.



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 2.5.1 Beta 3 install/update script:


# wget http://www.psoft.net/shiv/HS/releases/U25.1/U25.1b3/U25.1b3


# fetch http://www.psoft.net/shiv/HS/releases/U25.1/U25.1b3/U25.1b3


Step 2. Run the Installer

To start installation, run the install/update script with the install option:

# sh U25.1b3 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:

  1. 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.

  2. 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.

  3. Log into H-Sphere Control Panel as admin with password admin. Later on you will be able to change the admin password.

  4. 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.

  5. 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 U25.1b3 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 | Sample 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.


Post-Installation Issues

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:

  1. 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.
  2. 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

Copyright 1998-2018. Positive Software Corporation.
All rights reserved.