Parallels H-Sphere Documentation System Administrator Guide

 

H-Sphere Webmail

 
 

Related Docs:   Webmail Updates Webmail Updates (2.5 Beta 5 +) Introduction to H-Sphere Mail H-Sphere Mail Package H-Sphere IMAP Server H-Sphere Mail Installation From Sources

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.

 

Included Software

H-Sphere comes with such webmail clients:

Please refer to Webmail Updates for H-Sphere before 2.5 and for H-Sphere 2.5 + to see the versions of the packages included into H-Sphere Webmail.

The default client is IMP, and you don't need to do anything to use it. To enable SqWebMail over IMP, see Enabling SqWebMail.

Horde IMP webmail client is installed on each mail server. In earlier versions, it was installed on one of the H-Sphere web servers.

 

Installation/Updates

H-Sphere webmail is normally installed by the H-Sphere server installation script as outlined in the Adding Servers document and updated for H-Sphere before 2.5 and H-Sphere 2.5 +.

Alternatively, H-Sphere webmail can be set up from sources.

 

Enabling SqWebMail

To set SqWebmail instead of IMP:

  1. Log into the CP server as the cpanel user.
  2. Open the hsphere.properties file:
    vi ~cpanel/shiva/psoft_config/hsphere.properties
  3. Comment out the following line:
    WEB_MAIL = IMP
  4. Restart H-Sphere.

 

Setting SMTP Server For IMP

IMP configuration is written in the ~httpd/htdocs/horde/config/conf.php file.

IMP is configured in such a way that it uses local sendmail as SMTP server by default.

(H-Sphere 2.5 Beta 2) IMP is automatically switched to use external SMTP server when smdcheck qmail parameter is enabled. When you make an update to a version, reenable the parameter. If you want to make an update with disabled smdcheck parameter, execute the following script:

/hsphere/shared/scripts/mailsend_type.sh smtp
Usage:
mailsend_type.sh [ smtp | sendmail ]

To configure IMP to use external SMTP server, modify conf.php in the following way:

  1. Change the mailer type to smtp. For this, change the line:
    $conf['mailer']['type'] = 'sendmail';
    to:
    $conf['mailer']['type'] = 'smtp';
  2. Uncomment the following line and specify the smtp server:
    $conf['mailer']['params'] = array('host' => 'smtp.example.com');
    where smtp.example.com should be a valid smtp server name.

 

Configuring IMP with IMAP

Important: Starting with hsphere-webmails-2-1 (which is included in H-Sphere 2.4.3 RC 2), IMP uses only IMAP protocol and discontinues POP3 support for webmail autologon. Thus, the MAIL_PROTOCOL parameter in hsphere.properties becomes obsolete.

In H-Sphere below 2.4.3 RC 2, to configure IMP to work with IMAP:

  1. Log into the CP server as the cpanel user.
  2. Open the hsphere.properties file:
    vi ~cpanel/shiva/psoft_config/hsphere.properties
  3. Add the following line:
    MAIL_PROTOCOL=imap
  4. Restart H-Sphere.

 

Enabling/Disabling ImapProxy

ImapProxy 1.2.4, which is included in Webmail package, is disabled by default.
To enable it, run the script:

/hsphere/shared/scripts/imapproxy-init set
To disable ImapProxy 1.2.4, run:
/hsphere/shared/scripts/imapproxy-init drop

 

Webmails Localization

Starting with hsphere-webmails-2-10, the /hsphere/local/config/mail/scripts/add_locales script that fixes the Horde localization problem on TRUSTIX OSs is included into the package.

Usage:

add_locales [ locale1 locale2 ... localeN ] [ usage ] [ list ]
Where:
no options - adds all supported by HORDE locales
locale1 ... localeN - adds listed locales
list - lists all supported by Horde locales
usage - prints this message

This script is called out from the post-install script and during the hsphere-webmails installation adds utf8 locales only for Russian, Italian, French, German, Dutch, Spanish, Portugese.

To add the languages supported by Horde but not installed with package by default, run the script with necessary language codes (the codes should be delimited by a space). For instance, to add Hungarian and Chinese, run:

/hsphere/local/config/mail/scripts/add_locales hu_HU zh_CN
You can view all possible language codes by running:
/hsphere/local/config/mail/scripts/add_locales list

Note: you need to have the package glibc-locales installed on the server for the proper work of the script!


Related Docs:   Webmail Updates Webmail Updates (2.5 Beta 5 +) Introduction to H-Sphere Mail H-Sphere Mail Package H-Sphere IMAP Server H-Sphere Mail Installation From Sources



© Copyright 2017. Parallels Holdings. All rights reserved.