H-Sphere Single Server Edition 3.0 Patch 6 Installation

H-Sphere SSE 3.0 Patch 6 is the latest stable version.

Release Notes  |     Update  |     Change Log  |     Package List

This document explains how to install H-Sphere SSE 3.0 Patch 6.

Pre-Requisites

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

Step 1. Download the Installation/Update Script

Log into the server where you install H-Sphere SSE as root:

$ su -l

Download the H-Sphere SSE 3.0 Patch 6 install/update script:

Linux:

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

FreeBSD:

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

Please make sure that permissions to /usr/bin/wget are set to 0755 during the installation.

Step 2. Run the Installer

To start installation, run the install/update script with the install option eiter in interactive or non-interactive mode:

Interactive mode:

# sh U30.0P6SSE install

Non-interactive mode:
* This mode allows you to run the install/update script without the need to enter the wrapper and type in the options there. For example:

# sh U30.0P6SSE install cpinstall

More about H-Sphere SSE install script options.

Step 3. Prepare Preconfigured H-Sphere SSE

Before you install H-Sphere SSE on a datacenter, prepare a preconfigured H-Sphere single server installation with a set of services (Web, mail, DNS, MySQL, MRTG) you need. In the installer's command line type in the following command:

presingle [ skip-sitestudio ] [ group=cp,mail,unix_hosting,mysql,dns,mrtg ]

Specify the skip-sitestudio option to skip installing SiteStudio with H-Sphere. Choose custom comma-delimited list of required services in the optional group parameter. If you omit this parameter, H-Sphere installer will install all the services.

After pre-configuration, you may create an ISO image of the server's hard drive to be later on exported to other servers so that you are .

Step 4. Install Preconfigured H-Sphere SSE

To install H-Sphere from the prepared Single Server Edition pre-installation, run the H-Sphere installer with the postsingle option. You must specify at least:

• zone=SERVICE_ZONE - server's service zone domain name
• ip=SERVICE_IP - service zone IP
• ip2=SECOND_DNS_IP - second DNS server IP. It is required by domain registration systems like Enom, OpenSRS.

postsingle zone=SERVICE_ZONE ip=SERVICE_IP ip2=SECOND_DNS_IP [ skip-sitestudio ] [ group=cp,mail,unix_hosting,mysql,dns,mrtg ] [ natip=NAT_IP ] [ mask=MASK ]

Here, group is the list of services to be installed; NAT_IP is external NAT IP if NAT mapping is implemented; the mask parameter is set if your IP mask is different from 255.255.255.0.

Post-Installation Guidelines

When the installation is finished, H-Sphere SSE admin's Control Panel will be available at http://SERVICE_IP:8080

After you enter H-Sphere SSE admin CP, enter a valid Master Key to be able to work further on.

H-Sphere SSE installation 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