Parallels H-Sphere Documentation System Administrator Guide


Adding Services To Live H-Sphere Servers

(outdated in H-Sphere 2.5 Beta 2 and up)

Related Docs:   Adding Servers To H-Sphere Cluster Adding H-Sphere Servers and Services (HS 2.5+)

Last modified: 29 Aug 2007


WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

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


Step 1. Download Current Installer

  1. Log into the CP server as root.

  2. Check your current H-Sphere version:

    # cat ~cpanel/shiva/psoft_config/ | grep HS_VERSION

    Find out your current version by its build number in the list of H-Sphere versions.

    Important: It is strongly recommended to update your H-Sphere to the latest stable build of your current H-Sphere version.

    Important: This instruction is valid for H-Sphere versions under 2.5. For H-Sphere 2.5 and up, please refer to Adding H-Sphere Servers and Services.

  3. Important: Make sure the operating system on the server you are adding is supported in your current H-Sphere version.

  4. Download H-Sphere installer for your version of H-Sphere:
    Important: Before the download, make sure you don't have installers for older versions in the download directory. If you do, please remove them.

    H-Sphere 2.3.2:     wget
    H-Sphere 2.4:     wget
    H-Sphere 2.4.1:     wget
    H-Sphere 2.4.2:     wget
    H-Sphere 2.4.3:     wget
  5. Unpack the downloaded archive and cd into the installation directory:

    tar xfz <ARCHIVE_NAME>


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:


    You will see the list of physical servers in your H-Sphere cluster.

    1. Choose a physical server you want to add a service to by typing in its number in the list and pressing Enter. You will see the physical server's configuration menu with the list of services that can be enabled/disabled for this server.

      Important: Remember the ID of the target physical server! You'll need it later.

    2. Add a service choosing its ID from the displayed list of services by typing in the number of the required service. For example, to add a DNS server to the physical server, press '3' corresponding to the "DNS server" option in the list of services. Then, type '-' to return to the server configuration menu. You will see the '+' mark in front of the "DNS server" option in the list of services which means this service is enabled for this server, i.e.:

      |-[3] [+] DNS Server

    3. Type '-' and return to the main menu. You will see the service enabled in front of the new server's IP in the list of your servers, for example:

      |-[2] [DNS]

    4. Save configuration and exit with the 's' and 'q' commands from the main menu.
  3. If you are adding services with new IPs to a NAT configured H-Sphere cluster, you must add these IPs to the ~cpanel/shiva/psoft_config/ips-map.xml file.

  4. 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.

  5. Log into 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 Server
    Mail Server
    Webmail server (this option is not provided since H-Sphere 2.4.2)
    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 logical servers in admin Control Panel.


Resolving conflicts between Web and mail services

(outdated since HS 2.4.1)

  • If you have a mail server and want to add a web server:
    1. Stop Apache:
      - Linux: /etc/rc.d/init.d/httpd stop
      - FreeBSD: /usr/local/etc/rc.d/ 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
    make add-service S=weblite

Related Docs:   Adding Servers To H-Sphere Cluster Adding H-Sphere Servers and Services (HS 2.5+)

© Copyright 2018. Parallels Holdings. All rights reserved.