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

Step 1. Download the Installer

1. Download the installation scripts to your CP server if you don't have them downloaded:
   wget http://www.psoft.net/shiv/HS/hsinst.tgz
2. untar/ungzip the hsinst.tgz archive (if you don't have them already unzipped/untarred):
   tar xfz ./hsinst.tgz
   and cd into the installation directory:
   cd ./hsinst

Step 2. Configuration

At this step, you will create configuration files.

1. If your current H-Sphere hasn't been installed with the 2.3 installer, collect your current H-Sphere configuration:
   # ./import
2. Launch the configuration wizard to enter installation data:
   ./configure
3. In the configuration menu, add service choosing it's ID from the displayed list of services.
4. Save the number of the server that you added a service on in the configuration menu.
5. Save configuration and exit with '-' or 's'+'q' commands
6. 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.
7. 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

8. Return to your hsinst installation directory and execute:
   make add-server-ID-import
   to import new configuration settings to the H-Sphere database. ID is the server number.

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

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 as descirbed in Managing Logical and Physical Servers.
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