Parallels H-Sphere Documentation System Administrator Guide

 

Adding Servers To H-Sphere Cluster

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

Related Docs:   Adding Services 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.

As the number of your customers grows, you may find it necessary to add more Linux/FreeBSD boxes where you will place Web, mail, and other H-Sphere services.

To add a new server to H-Sphere cluster:

 

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/hsphere.properties | 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. If you do, delete them.

    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
    H-Sphere 2.4.1:     wget http://www.psoft.net/shiv/HS/hsinst241.tgz
    H-Sphere 2.4.2:     wget http://www.psoft.net/shiv/HS/hsinst242.tgz
    H-Sphere 2.4.3:     wget http://www.psoft.net/shiv/HS/hsinst243.tgz
  5. Unpack the downloaded archive and cd into the installation directory:

    tar xfz <ARCHIVE_NAME>
    cd <INSTALLATION_DIRECTORY>

 

Step 2. Collect your current configuration

Collect your current H-Sphere configuration:

# ./import

 

Step 3. Run the configuration wizard

Launch the configuration wizard to enter installation data:

# ./configure

In the configuration menu:

  1. add server with the 'a' command. You will be prompted to add the server's IP and mask. After that, it returns to the main configuration menu and you will see the server's IP in the list of physical servers;
  2. choose the newly added server by typing in its number in the list and pressing Enter. You will see the list of services that can be enabled/disabled for this server.
  3. to enable a service for the newly added server, type in the number of the required service. For example, to make the server a DNS 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

  4. When you 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] 1.2.3.4 [DNS]

  5. Save configuration and exit with the 's' and 'q' commands from the main menu.

Important: 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.

 

Step 4. Finish configuration

  1. Upload install scripts to the new server and configure SSH keys to access it:
    make add-server-<ID>
    where <ID> is the number of the new server you have saved.
  2. Login to the new server as root, then install and configure the new server:
    cd /hsphere/install
    make install
  3. Change back to the install directory on the control panel server and import server configuration to H-Sphere:
    make add-server-<ID>-import

    where <ID> is the number of the new server you have saved.

    Important: This will also stop the control panel for a few minutes.

    Note: After you have run import, your new physical server and its logical servers will appear in the E.Manager menu in admin control panel. Alternatively to this step, you can manually add new server from your admin CP.

 

Notes on adding Web servers

H-Sphere Web server's Apache suexec is configured to run users' cgi scripts only in the subtree /hsphere/local/home/.
If you need to add an extra HDD with new users, make sure you mount it inside the existing directory, for example: /hsphere/local/home/home2.
Warning: If you create users' homes outside the existing subtree, cgi scripts will fail to be executed.
Note: Make sure that all users have the fourth nesting level, for example:
/hsphere/local/home/user1 or
/hsphere/local/home2/user2


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



© Copyright 2017. Parallels Holdings. All rights reserved.