Parallels H-Sphere Documentation System Administrator Guide

 

Choosing Remote Web and MySQL Logical Servers for Horde Webmail Frontend

H-Sphere 3.0 RC 4 and up
 
 

Related Docs:   Logical Server Settings H-Sphere Webmail Configuration Choosing Remote MySQL for SpamAssassin

Last modified: 27 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.

H-Sphere mail logical server is by default installed on a physical box together with Web and MySQL servers on the same box, thus Webmail frontend uses Apache and MySQL on the same server.

In H-Sphere 3.0 RC 4 and up it is made possible to choose an alternative remote Web and MySQL servers for Horde Webmail frontend. This is in particular important for the implementation of load balanced mail cluster where it is required that Webmail is configured to use remote Web and MySQL servers. Also, now you can configure one Horde Webmail frontend to manage multiple mail servers.

To choose remote Web and MySQL servers for Webmail:

  1. Login as cpanel user and set the following property in ~cpanel/shiva/psoft_config/hsphere.properties:

    EXTERNAL_SERVICE_USAGE = TRUE

    Then, restart H-Sphere to apply changes. Important: If EXTERNAL_SERVICE_USAGE is not set or is not TRUE, you won't be able to choose external Web and MySQL servers for Webmail!
  2. In admin CP, go to E.Manager -> Servers -> L.Servers, proceed to settings for this mail logical server, and Choose Unix Hosting server for Horde under Mail Server Additional Options.
  3. Proceed to the selected Web (Unix Hosting) logical server settings in the E.Manager -> Servers -> L.Servers list and select a remote MySQL server for Horde database from the Choose External Horde DB Server dropdown menu.
  4. Login to CP server as root, download and run the H-Sphere 3.0 RC 4+ updater with the hspackages reconfig option:

    hspackages reconfig=frontend

    Note: Regular H-Sphere update to 3.0 RC 4 and up automatically includes the reconfig option. However, for best performance we recommend running H-Sphere updater with this option separately.

  5. To move Horde's Web and DB content to respective remote Web and MySQL logical server locations, run the following script on the source box:
    /hsphere/pkg/scripts/uprocedures/dbs_content -h

              Usage: dbs_content [ -h ] -d dbtype [ -i ip ] [ -p password ]
              dbtype: horde or spamassassin or phpmyadmin
              ip: this option is required only in the case, if redefinition took place from current external MySQL server to another
                        one or MySQL service, located on the corresponding mail logical server.
              password:  this option is required only in the case, if redefinition took place from current external MySQL server to
                         MySQL service, located on the corresponding mail logical server.

Related Docs:   Logical Server Settings H-Sphere Webmail Configuration Choosing Remote MySQL for SpamAssassin



© Copyright 2017. Parallels Holdings. All rights reserved.