This document explains how to add services to a live H-Sphere box. If you need to add a new box to H-Sphere cluster, please refer to the Adding Servers document.

Step 1. Download the Installer

1. Log into the CP server as root:
   su -
2. Make sure you don't have installers for older versions. If you do, delete them.
3. Download H-Sphere installater for your version of H-Sphere:
   H-Sphere 2.3.2:
   wget http://www.psoft.net/shiv/HS/hsinst.tgz
   H-Sphere 2.4:
   wget http://www.psoft.net/shiv/HS/hsinst24.tgz
4. untar/ungzip the downloaded archive:
   tar xfz ./ARCHIVE_NAME
   and cd into the installation directory:
   cd ./INSTALLATION_DIRECTORY

Step 2. Configuration

At this step, you will create configuration files.

1. Collect your current H-Sphere configuration:
   # ./import
2. Launch the configuration wizard to enter installation data:
   ./configure
3. Choose a physical server you want to add a service to.
4. In the configuration menu, add a service choosing its ID from the displayed list of services.
5. Save the ID number of the physical server where you added a service to, in the configuration menu.
6. Save configuration and exit with '-' or 's'+'q' commands
7. Execute:
   make add-server-ID
   where ID is the number of the server that you added the service on. This will regenerate install configuration, upload install scripts to this server and configure SSH keys to access it.
8. Login to the server where you install the new service and execute:
   cd /hsphere/install
   make add-service S=<SERVICE>
   where <SERVICE> is be one of the following:
   

   dns mail weblite web mysql psql

   DNS Server Mail Server Webmail server Web server MySQL server PostgreSQL server

Step 3. Enabling added services from the admin Control Panel.

On this step, please follow the instructions about how to add servers in admin Control Panel.

Resolving conflicts in the system.

• If you have a mail server and want to add a web server:
  1. stop apache by running the following command:
     - Linux: /etc/rc.d/init.d/httpd stop
     - FreeBSD: /usr/local/etc/rc.d/apache.sh stop
  2. uninstall webmail apache rpm or package:
     - Linux: rpm -e hsphere-apache-lite
     - FreeBSD: pkg_delete `pkg_info | grep ^hsphere-apache-lite`
• If you want to add a mail server and don't have a web server, after:
  make add-service S=mail
  execute:
  make add-service S=weblite