Revision as of 20:03, 20 January 2008

Important Note

Please note that these manual installation instructions should only be used on Ubuntu distributions, such as Ubuntu Gutsy Gibbon 7.10 server, the distribution the document was written for. It is highly recommended to perform installation using the Scalix Installer on all supported platforms. If you manually install any version of Scalix, this may invalidate your ability to receive Scalix support for that software. Thank you for your understanding and compliance.

This document might be inaccurate and under construction. Do not trust this document.

Manual Installation on Ubuntu 7.10 Server (Gutsy Gibbon)

As Ubuntu 7.10 is an unsupported platform there is currently no manual describing the installation on this platform. It took me a lot of time to have the Scalix Community Edition installed on my Ubuntu server. To do so I had to combine the information of a lot of sources (wiki pages, forums posts, etc) together. At last I managed to get Scalix it up and running and just felt like sharing this with the community. Simply my way to give something back.

So below you'll find a how-to that describes the manual installation of Scalix on Ubuntu 7.10 server.

Applicable Environments

These Installation instructions have been tested with

• Scalix CE 11.3.0
• Ubuntu 7.10 Server (Gutsy Gibbon)

They might not apply unmodified to any other version of Scalix or Ubuntu.

Hardware

Scalix Community Edition software is currently available as an i386 build only. It will run on i386 and x86_64 Intel and AMD platforms.

System Preparation

The following items may be helpful in preparing your system for Scalix Installation:

Network Configuration

• Make sure you have at least one properly configured network interface.
• Use a static IP address; running a Scalix server on a machine using DHCP is not recommended.
• Correct hostname resolution/DNS setup is vital. It is also best to use DNS in a Scalix/mail environment. File-based hostname resolution can be used (/etc/hosts). However, the following should always be true:
  • Your system should have a fully-qualified hostname
  • The "hostname" command should return the short hostname, while the "hostname --fqdn" command should return the fully-qualified hostname
  • Both the hostname and the fully-qualified hostname should resolve to the system's IP address (not the loopback 127.0.0.1 IP address).
  • The special name "localhost" should resolve to 127.0.0.1
  • The IP address of the system should reverse-resolve to the fully-qualified hostname (not the short hostname or localhost)

To achieve this your /etc/hosts file should contain at least the following two lines:

127.0.0.1         localhost
<yourexternalip>  <hostname.domain.com> <hostname>

Disk/File System Configuration

• Scalix Software is installed in /opt. You need 200 MB in this directory
• Scalix Data is kept in /var/opt/scalix. You need a minimum of 200 MB plus the size of any mailboxes.

Disabling Conflicting Services

Scalix comes with its own POP3, IMAP, LDAP and SMTP services. These might conflict with components already installed on the system.

• To check for processes listening on the POP3 and IMAP ports, use the

  lsof -i :110  or  netstat -anp | grep 110

  and

  lsof -i :143  or  netstat -anp | grep 143 

  commands. If you see any process/service running, shut it down and disable it from starting with system startup
• To check for processes listening on the standard LDAP port, use the

  lsof -i :389  or  netstat -anp | grep 389

  command. If you see any process/service running, use an alternate port number for Scalix LDAP. Please see below for details.
• To check for processes listening on the standard SMTP port, use the

  lsof -i :25  or netstat -anp | grep 25

  command. If sendmail listens on 127.0.0.1:25 it's OK, you can leave it. However, it should not listen on your external IP address. If you see a sendmail process/service listening on the external IP address, reconfigure your MTA. If you see another proces (MTA) than sendmail, make sure you remove your current MTA to replace it by sendmail (described below).

Software Selection

apt-get update

The following additional packages that come with Ubuntu are needed after base installation.

• Apache Webserver 2.x: the apache2 package

• Gnu AWK: the gawk package

• Kerberos (MIT Kerberos 5): the krb5-config, krb5-doc, krb5-user, libkadm55 and libkrb53 packages

• libglib2: the libglib2.0-0 package

• libstdc++: the libstdc++2.10-glibc2.2, gcc-4.2-base and libstdc++6 packages are also required

• libxml2: the libxml2, sgml-base and xml-core packages

• Postgres: the postgresql and postgresql-client packages

• SASL2 and modules for plain, crammd5 and gssapi (for MIT Kerberos): the libsasl2-modules and libsasl2-modules-gssapi-mit packages

• Tk: the tk8.3 package

• Tcl: the tcl8.3 package

• text-based web browser: the elinks package

• sendmail (if not installed yet, see Disabling Conflicting Services above): the sendmail package

To install all these packages together with their dependencies run the following command:

apt-get install apache2 gawk krb5-config krb5-doc krb5-user libkadm55 libkrb53 libglib2.0-0 libstdc++2.10-glibc2.2 postgresql postgresl-client libxml2 sgml-base xml-core libsasl2-modules libsasl2-modules-gssapi-mit tk8.3 tcl8.3 elinks gcc-4.2-base libstdc++6