Adding New H-Sphere Servers and Services

(H-Sphere 2.5 Beta 2 and up; for your consideration)

Related Docs:   H-Sphere Updater (2.5 and up) Adding Servers (before 2.5) Adding Services (before 2.5)


H-Sphere 2.5 introduces a new approach to installing and updating H-Sphere. Now, H-Sphere update script is used for adding new H-Sphere physical and logical servers to H-Sphere cluster.

This document provides a step-by-step instruction on adding new H-Sphere physical boxes and adding new logical servers (or services: Web, mail, DNS, etc.) on H-Sphere 2.5 Beta 2 and up.

The old instructions on adding new boxes to H-Sphere cluster or adding new services to a live H-Sphere box are no more applicable to H-Sphere 2.5 Beta 2 and up!


  1. If you are adding a new physical server, add physical server in admin CP. Important: for cp server to establish SSH connection with the newly added server, make sure to specify root password in the server adding form.
    Skip this step if you are adding new H-Sphere services (logical servers) to a live H-Sphere box.

  2. Add new logical servers in admin CP. Please remember the IP of physical servers you are adding new logical servers into.

  3. Log into the CP server as root.

  4. Check the H-Sphere version you have:

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

  5. If you are adding new physical servers to a NAT configured H-Sphere cluster, you must add new physical servers' IPs to the ~cpanel/shiva/psoft_config/ips-map.xml file.

  6. Run the update script, for example, for H-Sphere 2.5 Beta 5:

    # sh U25.0b5

  7. In the update script's command prompt, type:

    hspackages ips=list_of_ips

    where list_of_ips is the list of IPs delimited with comma and without spaces for the physical servers where new logical servers are to be added. For example:

    hspackages ips=,

    The script will install all the necessary packages into the target boxes. See the complete list of options for the hspackages script.

  8. Add custom DNS A record for each new logical server within the corresponding DNS zone.

Related Docs:   H-Sphere Updater (2.5 and up) Adding Servers (before 2.5) Adding Services (before 2.5)

© Copyright. . PSOFT. All Rights Reserved. Terms | Site Map