Squirrelmail Notes

Installation Packages
-----------------------------
- php5-imap
- Do not use the Ubuntu squirrel mail package.
  
Commands of Interest
-------------------------------
1- wget           to fetch the source file
2- tar zxf        to extract the source file
3- config/conf.pl to configure squirrel mail

Files and Directories
---------------------
1- /usr/src/sqm             scratch area to store source files
2- /var/local/squirrelmail  non-browsable data for squirrel mail


Specific Configuration Tasks
-----------------------------------------------------------------------

To acquire the latest version of squirrel mail sources
------------------------------------------------------
0- su -
1- mkdir /usr/src/sqm
2- cd /usr/src/sqm
3- wget URL_FOR_LATEST_SQUIRREL_MAIL_SOURCES

   Obtain the url by visiting http://www.squirrelmail.org/download.php,
   follow the download instructions, then copy the actual url after
   going through the sourceforge pages.

   FYI: As of this writing the latest stable version of SM is 1.4.10a.
        The installation site is https://site1.horgoth.com/
	The DocumentRoot is /var/www/secure-site1.horgoth.com/


To unpack squirrel mail for an individual virtual host
------------------------------------------------------
0- su - virtual_host_admin
1- cd /var/www/secure-site1.horgoth.com
2- tar jxf /usr/src/sqm/squirrelmail-1.4.10a.tar.bz2
3- mv squirrelmail-1.4.10a sm

To configure squirrel mail for an individual virtual host
------------------------------------------------------
0- su - webadmin
1- cd /var/www/secure-site1.horgoth.com/sm
2- Read and follow the instructions in the INSTALL file
2a- create the user data and attachment directories (see below)
2b- ./config/conf.pl
    + Set the user data and attachment directories with menu options
      4.1 and 4.2
    + Modify the server settings with main menu option 2.
      * Option 2.1 to set the email domain name.
      * Option 2.A.4 to set the IMAP server
      * Option 2.A.5 to set the IMAP port to 993 (SSL enabled)
      * Option 2.A.7 to set the IMAP secure to true.
      * Option 2.B.4 to set the SMTP server 
    + Save the changes with 'S'


To create the user data and attachment directories
--------------------------------------------------
0- su -
1- mkdir -p /var/local/sm/site1.horgoth.com/attachment-dir
2- mkdir -p /var/local/sm/site1.horgoth.com/data-dir
3- chown root:www-data /var/local/sm/site1.horgoth.com/attachment-dir
4- chown www-data:www-data /var/local/sm/site1.horgoth.com/data-dir
5- chmod 0730 /var/local/sm/site1.horgoth.com/attachment-dir
6- chmod 0755 /var/local/sm/site1.horgoth.com/data-dir


To test the configuration
--------------------------------------------------
1- Visit https://site1.horgoth.com/sm/src/configtest.php
   You should find a php configuration that needs to be changed.
2- Visit https://site1.horgoth.com/sm
   Login as one of the users.
   Send and receive email.


****************************************************************
Notes:
****************************************************************
  + During use of configtest.php the TLS error can be ignored.
  + Other menu options may be of interest
  + This configuration assumes that the SMTP server has already
    been configured to receive email for the host name in question
    (site1.horgoth.com).  Also, the DNS configuration must be set
    up correctly.