Parallels H-Sphere Documentation Administrator Guide

 

Logical Servers

 
 

Related Docs:   Physical Servers

Last modified: 25 Dec 2007

 

WARNING: This documentation covers Parallels H-Sphere versions up to 3.1. For the latest up-to-date Parallels H-Sphere documentation, please proceed to the official Parallels site.

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:

To add a new logical server to H-Sphere, do the following:

  1. Go to your admin control panel.
  2. Go to E.Manager -> Servers -> Add L.Server.
  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: redundant parameter, not in use any longer.
    • File Path: redundant parameter, not in use any longer.
  4. Click Submit to create a logical server. You will proceed to the page where you can configure other parameters for this logical server:
    1. Enable user signup on this server
    2. Automatically generate custom DNS records by clicking Generate in front of Generate custom DNS records for this logical server
    3. Add IP range available for hosting on this server
    4. Configure additional options specific to this logical server type (Web, mail, DNS, Windows, ...)
  5. Add DNS records for this logical server.
  6. 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.
  7. For each type of logical servers, configure specific additional options.

 

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. Go to E.Manager -> Servers -> L.Servers.
  2. You will be taken to the list of all logical servers in the system. Click the server you would like to edit:
  3. On the page that appears, turn on the Available for signup option.

 

Logical Server Additional Options

Once a 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.

 

Web server 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.
  • Webshell (File Manager): this option allows choosing between Webshell4 and Webshell5 (CGI Mode)
  • Prohibit users from switching to dedicated IP: disables switching to dedicated IP for all users
  • Choose External Horde DB Server: set MySQL logical server for Horde Webmail Frontend. If you set LOCAL, H-Sphere will use the default server.
  • ( HS 3.0 Patch 8+) Outgoing rsync connection IP address: Usually, rsync would connect from the Web server's shared IP, but for non-default rsync allow host parameters you can set the outgoing rsync connection IP(s) (delimited with comma) in the logical server options.

Make sure to click Set to apply changes.

 

Windows server additional options

You can set the following parameters for the Windows server:

  • Set FTP Server: you can choose between IIS and FTP
  • 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.
  • Maximum number of worker processes by Shared Application Pool: once you set the restriction, users won't be able to exceed it in their User CP. (H-Sphere 3.0 Patch 7+)
  • Maximum number of worker processes by Dedicated Application Pool: once you set the restriction, users won't be able to exceed it in their User CP. (H-Sphere 3.0 Patch 7+)
  • Prohibit users from switching to dedicated IP: disables switching to dedicated IP for all users, if necessary
 

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

 

VPS server additional options:

(HS 3.1 Beta 1+) Additional VPS server options allow to choose between FreeVPS and OpenVZ solutions.

See also Changing H-Sphere VPS Solution in Sysadmin guide.

 

Load Balancer File Server (Filer) Settings

Load Balancer File Server Settings

Once the physical server for this logical server (master server only!) is configured in the load balanced server cluster, the following Load Balancer File Server Settings should be set in Logical Server options:

  • File Server Type: file storage OS type, like UNIX for generic Linux NFS;
  • File Server: file storage volume location, like 10.9.8.7:/vol/vol0;
  • File Path: (optional) file storage path to H-Sphere directory, like /vol/vol0/hsphere.
  • File server Volume ID: file storage volume ID, like vol0.

See Installation of Load Balanced Web/Mail Clusters in H-Sphere for explanations.

 

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

Related Docs:   Physical Servers



© Copyright 2017. Parallels Holdings. All rights reserved.