H-Sphere Versions

For more information contact us

H-Sphere 2.5 Beta 3 (Private Build 702) Installation

Under development - not for production servers!

 

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


WARNING:
This version is a private release for beta testers. This version is not recommended for production servers! Please refer to the latest stable version.
Note for beta testers: Please report all bugs and issues to our Bugzilla system. Please send info on successful installation/upgrade to bugreport@psoft.net.

This document explains how to install H-Sphere 2.5 Beta 3 (Private Build 702) using public installation scripts. Please make sure to have your servers prepared as instructed in the Preparing Servers for H-Sphere Installation manual.

  1. Download
  2. Configuration
  3. Preparing H-Sphere
  4. Installing H-Sphere
  5. Post-installation note

WARNING: We have found problems with H-Sphere to 2.5 Beta 2 installation on FreeBSD 4.x up to version 4.9. We recommend upgrading your FreeBSD servers to at least 4.10 or 4.11 before the H-Sphere intallation!

 

Step 1. Download

Now that you have prepared the servers, you can start the installation. At this step, you will download the install.

  1. Download the installation scripts:
    Linux:
    # wget http://www.psoft.net/shiv/HS/releases/U25.0/U25.0b3/hsinst.tgz
    FreeBSD:
    # fetch http://www.psoft.net/shiv/HS/releases/U25.0/U25.0b3/hsinst.tgz

    Note: Latest public version in this H-Sphere branch is 2.5 Patch 11. Latest stable H-Sphere version is 3.3 Patch 1.

  2. Untar/ungzip downloaded tarball:
    # tar xfz ./hsinst.tgz
    and cd into the installation directory:
    # cd hsinst

 

Step 2. Configuration

At this step, you will create configuration files.

  1. Launch the configuration wizard to enter installation data:
    # ./configure
  2. Follow the wizard to provide configuration data. If you perform multi-server installation, when asked to enter IPs of your servers, begin with IP of your CP server. 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:

  1. create hsphere directory if it doesn't exist;
  2. generate all config files;
  3. remove old version of H-Sphere, if it's installed;
  4. generate ssh keys and places them to all servers. You'll need to enter root password to each server;
  5. upload install to all servers;
  6. create hsphere directory on each server;
  7. export all passwords to /root/hsphere.info.txt.

 

Step 4. Installing H-Sphere

Log into each server as root and execute:

cd /hsphere/install
make install
IMPORTANT:
In multiserver installation, Control Panel server must be installed the last, as it includes configuration of other servers in H-Sphere cluster. Otherwise, CP will be installed incorrectly!

To install H-Sphere without SiteStudio, instead of "make install" execute:

make hs-install
If you decide to add SiteStudio, log into your control panel server and execute:
make ss-install

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.

For more details, check with the README file that comes with the installation.

 

Post-Installation Note

When the installation is finished, H-Sphere Control Panel will be available at http://_IP_OF_HSphere_CP_: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..



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