H-Sphere Sysadmin Guide

H-Sphere Installation

 

This document explains how to install H-Sphere 2.09 using public installation scripts. Please make sure to have your servers prepared as instructed in the Preparing Servers for H-Sphere Installation manual.

  1. Installation
  2. Postinstallation note

 

Installation.

To install H-Sphere, you need to perform the following steps:

  1. Download the installation scripts. They are available at our site at
    http://www.psoft.net/shiv/HS209/HS209n.tgz
  2. untar/ungzip the HS209n.tgz archive:
    # tar xfz ./HS209n.tgz
    and cd into the installation directory:
    # cd ./HS209
  3. Execute the following command:
    # ./configure
    The script asks you to add the installation data in the interactive mode.
    - H-Sphere domain name: specify the main H-Sphere domain name for your admin control panel and the login page, i.e. mydomain.com
    - Main CP Postgrsql: specify the main H-Sphere DB required data:
    1. server name (cp.mydomain.com)
    2. server IP (the CP server IP)
    3. CP Postgresql user (the DB user which will be created and configured by the installation scripts, use "wwwuser" for this purpose)
    4. CP Postgresql password (passowrd for this DB user, you can specify any to your liking, it will be assigned to this user)
    5. CP IP (the CP server ip, it can be the same IP; if the H-Sphere DB is placed on an additional server, the access to the postgresql server from this IP will be allowed).

    * H-Sphere is installed as 2.09 version then it is upgraded to 2.097 version (step 1) then to 2.1 version (step 2).

    If you have any problems with it, please describe them, we'll be glad to help you.

  4. When the data have been entered, type
    # make build
    As the result, the directories "serverN" will be created for each H-Sphere server (N - number of the server).
  5. Further steps must be repeated with each H-Sphere box:

  6. Move the "serverN" directory to the target server.
  7. cd into this directory
  8. Type make build.
  9. Type make preinstall. This will run Linux resource check, users creation and installation of the DBs packages).
  10. Type make hs-install. This will run H-Sphere RPMs installation and postconfiguration.

Note: the "make" command returns a quick help.

The needed RPMs will be downloaded from the www.psoft.net site in the installation process. You can download them once and then change the "http://www.psoft.net/shiv/HS209" URL to the one with downloads in the HS209/src/hsphere.[OS].conf file.
("[OS]" is one of the following: rh62, rh71, rh72, mdk81 )

Note: If you get an error saying, the package can't be installed because it conflicts with the package already installed, you should delete the conflicting package and repeat the installation step again.

Note: If you have several servers, make sure to install the server with the H-Sphere Control Panel in the end.

 

Postinstallation note

When the installation is finished, H-Sphere Control Panel will be available at http://_IP_OF_HSphere_CP_:8080
The current version of H-Sphere contains the SiteStudio site builder, you can install it additionally. To do it, cd to the serverN directory which contain the H-Sphere Control panel installation scripts and execute the following command:
# make ss-install
Mind that this installation doesn't contain:
- the Xvfb package installation and startup and
- the ImageMaker startup.
You need to install the Xvfb package manually and start it:
# /usr/X11R6/bin/Xvfb ':0' -screen 0 100x100x8 &
(this example uses the 0th screen)

While the Xvfb is running, you can start the ImageMaker daemon:
# /hsphere/shared/SiteStudio/imaker.sh 1>/hsphere/shared/SiteStudio/var/error_log 2>&1 &

Also, you may need to add these strings into the server startup.

 



© Copyright 1998-2004. Positive Software Corporation.
All rights reserved.