H-Sphere 3.0 Patch 9 Installation

Release Notes  |     Update  |     Change Log  |     Package List

Pre-Requisites

Consider this before you install H-Sphere:

• Please make sure to have your servers prepared as instructed in the Preparing Servers for H-Sphere Installation manual.

• If you are to install CP on a FreeBSD box, especially in case of multiprocessor architecture, please make sure you have the /etc/libmap.conf file on the CP box with this content.

• Config files for Apache, FTP, PHP, DNS, MySQL, and PostgreSQL should be customized indirectly via respective template files. Otherwise, all custom changes in major default configuration files are removed with each H-Sphere update! Please carefully follow the config file templates customization instruction!

• If you are installing H-Sphere control panel on FreeBSD box running on multiprocessor computer architecture, create the /etc/libmap.conf file before H-Sphere installation. More in Preparing Servers for H-Sphere Installation.

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 9 install/update script:

Linux:

# wget http://www.psoft.net/shiv/HS/releases/U30.0/U30.0P9/U30.0P9

FreeBSD:

# fetch http://www.psoft.net/shiv/HS/releases/U30.0/U30.0P9/U30.0P9

Important: Since H-Sphere 3.0 +, you can download installation/update script from our mirror site at http://mirror.psoft.net. 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.0P9 install

Then, choose one of the options, depending on the installation mode:

• Regular installation from scratch
• Installation with prepared H-Sphere configuration

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 U30.0P9 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