Parallels H-Sphere Documentation System Administrator Guide

 

IMP Setup

(before v.2.4)
 

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.

 

IMP Installation

Since H-Sphere 2.1, two webmail clients included in H-Sphere installation:

  • SqWebMail written in C - default webmail client, installed on the same box with mail server and runs on its Apache server;
  • Horde IMP webmail client written in PHP, installed on one of the H-Sphere web servers.

IMP should be installed and configured only on one of H-Sphere web servers. It is automatically installed with the first Web server. To check where IMP is installed, find the following line in hsphere.properties:

IMP_HOST = NN

where NN is the web server ID; this ID can be obtained from E.Manager -> LServers.

To install IMP manually:

  1. Login as root to the web server where you are intending to install IMP.
  2. Go to the Apache htdocs directory:
    cd /hsphere/shared/apache/htdocs/
  3. Download the Horde IMP package, e.g., from the Psoft site:
    wget http://www.psoft.net/shiv/HS/horde-imp.tgz
  4. Untar the package:
    tar xfz horde-imp.tgz
  5. Configure H-Sphere mail servers in the following IMP config file:
    vi horde/imp/config/servers.php
  6. Enable IMP for this server.
 

Enabling IMP

To set IMP instead of SqWebmail, follow these steps:

  1. Log in as cpanel user:
    su -l cpanel
  2. Open the hsphere.properties file:
    vi ~cpanel/shiva/psoft_config/hsphere.properties
  3. Add or uncomment the following line:
    WEB_MAIL = IMP
  4. Make sure the file has the following line:
    IMP_HOST = NN
    where NN is the ID of the web server where IMP is installed; this ID can be obtained from E.Manager -> LServers.
  5. Restart H-Sphere.

To switch back to SqWebMail, repeat 1-2 steps above. Then comment out the "WEB_MAIL = IMP" string and restart H-Sphere CP.
After this H-Sphere will start using the SqWebMail instead of IMP.

Note: You can download custom IMP themes at the developers' site http://www.horde.org/themes/

 

Setting SMTP Server For IMP

IMP configuration is written in the /hsphere/shared/apache/htdocs/horde/config/horde.php file.

IMP is configured in such way that it uses local sendmail as SMTP server by default. To configure IMP to use external SMTP server, modify horde.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.


© Copyright 2017. Parallels Holdings. All rights reserved.