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

1. Download the installation scripts onto your CP server if you don't have them downloaded:
   wget http://www.psoft.net/shiv/HS/hsinst.tgz
2. untar/ungzip the hsinst.tgz archive:
   tar xfz ./hsinst.tgz
   and cd into the installation directory:
   cd ./hsinst

Step 2. Configuration

At this step, you will create configuration files.

1. If your current H-Sphere hasn't been installed with the 2.3 installer, collect your current H-Sphere configuration:
   # ./import
2. Launch the configuration wizard to enter installation data:
   ./configure
3. In the configuration menu, add server with the 'a' command and configure its services.
4. Save the number of the new server in the configuration menu.
5. Save configuration and exit with '-' or 's'+'q' commands
6. 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.
7. Login to the new server as root and execute:
   cd /hsphere/install
   make install
   This will install and configure a new server.
8. 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