Parallels H-Sphere Documentation System Administrator Guide


Adding New H-Sphere Servers and Services

(H-Sphere 2.5 and up)

Related Docs:   Adding H-Sphere Winbox (Latest Stable Version) H-Sphere Updater Adding Servers (before 2.5) Adding Services (before 2.5)

Last modified: 27 Dec 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 provides a step-by-step instruction on adding new H-Sphere physical boxes and adding new logical servers (or services: Web, mail, DNS, etc.).

  1. If you are adding a new physical server, add physical server in admin CP. Please make sure to specify the root password in the form to provide SSH connection between CP and the newly added server.

    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.

    Important: Make sure you created respective custom DNS records for this logical server. To do this automatically for this logical server's DNS zone, click the button Generate in front of Generate custom DNS records for this logical server in the Logical Server options.

  3. If you are adding new physical servers to a NAT configured H-Sphere cluster, you must log into the CP server as cpanel user and add the new physical servers' IPs to the ~cpanel/shiva/psoft_config/ips-map.xml file.

  4. Physically install new H-Sphere server/services on the box:

    • H-Sphere 3.1 and up

      Run Update Wizard in admin CP: go to E.Manager -> Update -> Update Boxes check the server(s) you need to install the server on and click Start Update.

      Alternatively, you can still choose to download and run the respective H-Sphere 3.1+ update script (as for H-Sphere 2.5 and 3.0 - see the instruction below) to install new servers and services.

    • H-Sphere 2.5 and 3.0

      Download and run H-Sphere updater to install an H-Sphere server/service:

      1. Log into the CP server as root.

      2. Check the H-Sphere version you have:

        # cat ~cpanel/shiva/psoft_config/HS_VERSION

      3. Download the H-Sphere update script for the version you have (must be H-Sphere 2.5 Beta 2 or higher). For example, for H-Sphere 3.0 Patch 7:


        # wget


        # fetch

      4. Run the update script, for example, for H-Sphere 3.0 Patch 7:

        # sh U30.0P7

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

Related Docs:   Adding H-Sphere Winbox (Latest Stable Version) H-Sphere Updater Adding Servers (before 2.5) Adding Services (before 2.5)

© Copyright 2018. Parallels Holdings. All rights reserved.