|
By logical servers we mean the software that runs on physical servers and processes client requests.
This document covers the following issues:
Adding Logical Servers
IMPORTANT!
For correct system performance, we don't recommend you to have more than one
logical server of the same type (web, mail, dns etc.) per each physical box.
As an exception, two logical dns servers are permissible under one-server installation.
As soon as the second box is added to the system, one of the name servers should be
moved to that box.
Before you begin adding a logical server to H-Sphere, make sure to have:
- the physical server added to H-Sphere configuration;
- the logical server software
installed as per the Adding Servers section of the sysadmin manual.
To add a new logical server to H-Sphere, do the following:
- Go to your admin control panel.
- Click Add L.Server in the E.Manager menu.
- On the page that appears, enter the properties of the logical server:

- Name: The domain name of the logical server;
- Group: The group of logical servers you are adding this server to.
- Type: The type of the server.
- Physical Server: The box where the logical server is installed.
If nothing is available in the dropdown box,
add this server group to the physical server first.
- Description: The note that will help you identify this server among others.
- File Server: Reserved for future implementation.
- File Path: Reserved for future implementation.
- Add DNS records for this logical server.
- If you are adding a web server, select Shared SSL Manager in the E.Manager menu,
click the Edit icon next to the domain name and enter the certificate key and certificate file
in the Install completely new certificate key and file pair boxes. Then click the Upload button.
This will update the shared SSL certificate installation on all servers, including the newly installed one.
Enabling User Signup on Logical Servers
By default, customer signup is disabled on new logical servers. Sometimes
you may want to keep it disabled to provide dedicated servers to individual
customers or to prevent them from getting overloaded. In most cases, however,
you would need to turn it on.
To enable user signup:
- Select L.Servers in the E.Manager menu.
- You will be taken to the list of all logical servers
in the system. Click the server you would like to edit:

- Starting with H-Sphere 2.4 Beta 7, on the page that appears, turn on the Available for signup option.
Logical Server Additional Options
Once logical server is added, you can set additional options for it.
To set additional options, click the logical server name in the list of
all logical servers and scroll down to the bottom of the page.
Webserver additional options:

You can set the following for the webserver:
- Miva Merchant version: this option allows setting correct extensions prior to installation:
.mv for v. 4.12 and older and .mvc for v.4.14 and later.
- Unix user home directory: enter home directory if necessary.
(since 3.0 RC 2) Webshell (File Manager): this option allows choosing between Webshell4 and Webshell5 (CGI Mode)
(since 3.0 RC 2) Prohibit users from switching to dedicated IP: disables
switching to dedicated IP for all users
- Choose External Horde DB Server:
(HS 3.0 RC4+) set MySQL logical server for Horde Webmail Frontend.
If you set LOCAL, H-Sphere will use default server.
Make sure to click Set to apply changes.
DNS server additional options:
Additional options in DNS logical server allow assigning master and slave roles
to DNS logical servers and limiting resellers to particular DNS logical servers.
For detailed information, read about DNS Servers.
Mail server additional options:

Additional options in mailserver allow to choose:
Removing mail relays on a chosen mail server
(HS 3.1 Beta 1+)
If your mail server has none of mail domains, you can remove all its mail relays in one click on the
Mail Servers Settings page. Firstly, make sure the CleanMailRelaysForMailServer cron is
enabled in Background Job Manager

Once you removed all mail relays, you can remove the corresponding logical server.
MySQL server additional options:

You can set the following for the MySQL server:
PostgreSQL server additional options:

Removing Logical Servers
To remove a logical server:
- Make sure no accounts, mail domains, web sites or other resources are run on it.
- Delete all the IPs designated to it (E.Manager ->
L.Servers -> 'selected logical server' page)
- Click the Delete icon which will then appear in the Usage field
|