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:
- Login as cpanel user and set the following property in
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!
- 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.
- 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.
- Login to CP server as root, download and run the
H-Sphere 3.0 RC 4+ updater with the hspackages reconfig option:
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.
- 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:
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.