H-Sphere Administrator Guide

Logical Servers

 
 

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:

  1. Go to your admin control panel.
  2. Click Add L.Server in the E.Manager menu.
  3. 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.
  4. Add DNS records for this logical server.
  5. 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:

  1. Select L.Servers in the E.Manager menu.
  2. You will be taken to the list of all logical servers in the system. Click the server you would like to edit:
  3. 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:

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

 

 



© Copyright 1998-2007. Positive Software Corporation.
All rights reserved.