TOTKat: (hand coded) online journal of a girl geek since April 1999.
WARNING: contains personal opinions. A sense of perspective is required when reading.

Installing and configuring horde (and IMP)

This is specifically for a Solaris 8 install.
Errors or omissions, please mail to documentation@totkat.org.

!!-- The following explains how to install and configure Horde on a prepared system which already has all of the pre-requisites. If you need to tackle pre-requisites first, then see the Horde Preparation guide first. --!!

This is the engine on top of which IMP will sit. If you already have this part installed yadda yadda, skip, blah, foo, get on with it to the next part, you know what you're doing.

Untar Horde and sort out the config files:-

  cd $DOCROOT
  tar xvf $STAGE/horde-2.1.tar.gz
  mv horde-2.1 horde
  cd horde/config
  for foo in *.dist; do cp $foo `basename $foo .dist`; done

[top]

Untar IMP and sort out the config files:-

  cd $DOCROOT/horde
  tar xvf $STAGE/imp-3.1.tar
  mv imp-3.1 imp
  cd imp/config
  for foo in *.dist; do cp $foo `basename $foo .dist`; done

[top]

Initially, I'll handle Horde 2.0. Edit $DOCROOT/horde/config/registry.php:-

To make IMP handle authentication, which means that users won't have to log in to Horde and then again to access IMP, uncomment lines 23 and 24, which should be:-

  $this->registry['auth']['login'] = 'imp';
  $this->registry['auth']['logout'] = 'imp';

  $this->applications['imp'] = array(
    'fileroot' => dirname(__FILE__) . '/../imp',
    'webroot' => $this->applications['horde']['webroot'] . '/imp',
    'icon' => $this->applications['horde']['webroot'] . '/imp/graphics/imp.gif',
    'name' => _("Mail"),
    'allow_guests' => false,
    'show' => true
  );

  $conf['mailer']['type'] = 'smtp';
  //$conf['mailer']['params'] = array('sendmail_path' => '/usr/sbin/sendmail');
  $conf['mailer']['params'] = array('host' => 'smtp.yoursmtpserver.com');

  'allow_guests' => false,

$this->applications['horde'] = array(
    'fileroot' => dirname(__FILE__) . '/..',
    'webroot' => '/horde',
    'initial_page' => 'login.php',
    'icon' => '/graphics/home.gif',
    'name' => _("Horde"),
    'allow_guests' => true,
    'status' => 'active',
    'templates' => dirname(__FILE__) . '/../templates',
    'cookie_domain' => $_SERVER['SERVER_NAME'],
    'cookie_path' => '/horde',
    'server_name' => $_SERVER['SERVER_NAME'],
    'server_port' => $_SERVER['SERVER_PORT']
);

   'server_name' =>  'horde.domain.com',
   'cookie_domain' => 'horde.domain.com',

$this->applications['imp'] = array(
    'fileroot' => dirname(__FILE__) . '/../imp',
    'webroot' => $this->applications['horde']['webroot'] . '/imp',
    'icon' => $this->applications['horde']['webroot'] . '/imp/graphics/imp.gif',
    'name' => _("Mail"),
    'allow_guests' => false,
    'status' => 'active'
);

  'allow_guests' => false,

// What method should we use for sending mail? Valid options are
// currently 'sendmail' and 'smtp'.
$conf['mailer']['type'] = 'sendmail';


// $conf['mailer']['params'] = array();
// $conf['mailer']['params'] = array('sendmail_path' => '/usr/lib/sendmail');
$conf['mailer']['params'] = array('host' => 'smtp.example.com');

[top]

There appear to be no significant differences between IMP 3.1 and IMP 3.2.1 for basic configuration purposes. So, apart from line numbers in the config files possibly being different, the configuration should be the same, regardless of which you are using. Edit $APACHEHOME/horde/imp/config/conf.php

Line 37 should be modified for turba:-

  $conf['menu']['apps'] = array('turba');

  $conf['user']['allow_resume_all'] = true;
  $conf['user']['allow_resume_all_in_drafts'] = true;

Edit $APACHEHOME/horde/imp/config/servers.php

You need to insert your own mail servers here:-

  'server' => 'localhost',
  'protocol' => 'imap',
  'port' => 143,

  'maildomain' => 'yourdomain.com',
  'smtphost' => 'localhost',
  'realm' => 'yourdomain.com',

[top]

Test whether you need to do this by telnetting the IMAP port on the machine (while logged in at the command line, "telnet localhost 143"). If you get a response something like this:

Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
* OK [CAPABILITY IMAP4REV1 LOGIN-REFERRALS AUTH=LOGIN] localhost...

  crle -l /usr/lib:/usr/local/lib:/usr/local/ssl/lib

Remember, your system may be using libraries in other places in addition to these locations. Take care to include those if you need to.

[top]

Start her up and see what happens!

  $APACHEHOME/apachectl startssl

Then point your browser at: http://yourserver/horde/imp/ and attempt to log in.

[top]