As your customer base grows, you may find it necessary to add more boxes where you will place web, mail, or other servers. To add a server:

Step 1. Download Current Installer

1. Log into the CP server as root:
   su -
2. Make sure you don't have installers for older versions. If you do, delete them.
3. Download H-Sphere installater for your version of H-Sphere:
   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
4. untar/ungzip the downloaded archive:
   tar xfz ./ARCHIVE_NAME
   and cd into the installation directory:
   cd ./INSTALLATION_DIRECTORY

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:
   ./configure
   In the configuration menu:
   (i) 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;
   (ii) 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.
   (iii) 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
   (iv) 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, i.e.:
   |-[2] 1.2.3.4 [DNS]
3. Save configuration and exit with the 's' and 'q' commands from the main menu.
4. Execute:
   make add-server-ID
   where ID is the number of the new server you have saved. This will regenerate install configuration, upload install scripts to the new server and configure SSH keys to access it.
5. Login to the new server as root and execute:
   cd /hsphere/install
   make install
   This will install and configure a new server.
6. Change back to the install directory on the control panel server and execute
   make add-server-ID-import
   where ID is the number of the new server you have saved. This will import server configuration to H-Sphere. Note: This will also stop the control panel for a few minutes. Alternatively to this step, you can manually add the new server from E.Manager in your admin control panel.

Notes on Adding Web Servers

H-Sphere WebBox 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

Step 3. Control Panel Settings