|
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
Log into the CP server as root. 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.
Important: Make sure the operating system on the server you are adding
is supported in your current H-Sphere version.
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.
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:
- 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;
- 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.
- 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
- 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]
- 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
- 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.
- Login to the new server as root, then install and configure the new server:
cd /hsphere/install
make install
- 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
|
