This document explains how to add services to a live H-Sphere system. To add a service:

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

1. Log into your admin Control Panel.
2. Go to E.Manager - > P.Servers and choose the physical server you've added this service on.
3. At the bottom of the form to open, select this service group and click the Add button.
4. Go to E.Manager - > Add L.Server and create a new logical server on this physical server with the service group you've added to it.
5. Add IPs to this logical server
6. Go to E.Manager - > DNS Manager, choose your main service DNS zone, click the Edit icon next to it in the Action entry.
7. Add an A DNS record to map the new logical server to its IP.

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