Open WebMail

1. 简介Open WebMail 是一个由 Neomail version 1.14 发展而来的 webmail，经由几年的发展，目前的功能愈来愈多，效能上也提供很多，它详细的功能可以在 Open WebMail 总站中查看：

http://turtle.ee.ncku.edu.tw/openwebmail/

2. 安装 Open WebMail2.1. 以 packages 安装下面介绍如何以 packages 来安装 openwebmail-2.10 (版本序号自行更改)。
安装前要注意，因为 openwebmail package 档案预设会安装到 /usr/local/www/cgi-bin 和 /usr/local/www/data 中，所以，如果 apache 的设定档已经修改了 DocumentRoot 和 ScriptAlias 的设定，要注意路径问题。
执行下面指令 (packages URL 自行调整)：

pkg_add -v ftp://ftp.tku.edu.tw/OS/FreeBSD/ ... penwebmail-2.10.tgz

如果安装成功，预设应该会多了下面两个目录:

/usr/local/www/cgi-bin/openwebmail
/usr/local/www/data/openwebmail

2.2. 安装失败的检查FreeBSD 以 packages 安装软体如果失败，多半是少安装相依的 packages
下面是在安装成功的机器上利用 pkg_info 列出需安装的相依 packages 供叁考：

pkg_info -r openwebmail-2.10

Information for openwebmail-2.10:
Depends on:
Dependency: libiconv-1.9.1_1
Dependency: p5-Authen-SASL-2.04
Dependency: p5-MIME-Base64-2.20
Dependency: p5-File-Spec-0.82
Dependency: p5-CGI.pm-2.97,1
Dependency: p5-CGI-SpeedyCGI-2.21_3
Dependency: p5-Net-1.12,1
Dependency: p5-Text-Iconv-1.2_1

所以，如果 openwebmail-2.10 安装失败时可以检查上面的清单，看看到底少了哪个 packages

3. Open WebMail 安装后的首次设定如果登入 Open WebMaill 时出现下面的讯息：

Open WebMail ERROR

无法开启 /usr/local/www/cgi-bin/openwebmail/etc/sessions! (No such file or directory)

或是：

Open WebMail ERROR

无法开启 /usr/local/www/cgi-bin/openwebmail/etc/sessions/xxxx*-session-0.742660565767437! (Permission denied)

表示没有在 /usr/local/www/cgi-bin/openwebmail/etc 中建立好 sessions 的目录，或是权限没设定好，可以执行下面的指令：

cd /usr/local/www/cgi-bin/openwebmail/etc
mkdir sessions
chown root:mail sessions
chmod 770 sessions

上面的错误讯息已经是 FAQ，在 Open WebMaill 的 faq.txt 中已有说明罗!!

4. 如何排除执行时的错误
因为 Open WebMail 是 apache 下的 CGI ，发生错误时当然是要先查看一下 apache 的 error log
马上执行下面指令，看看最后几行：

tail /var/log/httpd-errors.log

如果还是无法由 apache 的 error log 看出问题的所在，先看一下Open WebMail的 readme.txt 和 faq.txt，
说明文件安装时即已置入 /usr/local/www/data/openwebmail
所以假设 server 叫 mail.x.y.z 文件的网址应该是：

http://mail.x.y.z/openwebmail/

不然也可连回 Open WebMail 的总站查看：

http://turtle.ee.ncku.edu.tw/openwebmail/

如果该安装的配合套件都安装了，大部份都是档案的权限有问题， FAQ 中写得很详细，绝对值得一看。

5.所有人透过 POP3 收别台主机上的信件假设 openwebmail 是在 www.test.tp.edu.tw 而使用者的信件却在 mail.test.tp.edu.tw 为了让所有的使用者可以透过 openwebmail 以 POP3 来收 mail.test.tp.edu.tw 上的信件，我们可以修改在 www.tp.edu.tw 主机上的 OpenWebmail 的设定档 etc/openwebmail.conf ，在里面加入下面的设定：

domainnames mail.test.tp.edu.tw
auth_module auth_pop3.pl
pop3_authserver mail.test.tp.edu.tw
pop3_authport 110
getmail_from_pop3_authserver yes
use_syshomedir no
use_homedirspools yes
frombook_for_realname_only yes
default_realname none

设定说明：

• domainnames：设定使用者寄信时，电子邮件地址小老鼠(@)右边的 domainnames 预设值。如果不设定，以前面例子来说，会是 www.test.tp.edu.tw ，这样，别人的回信会寄错地址。
• auth_module ：告诉 OpenWebmail 以 auth_pop3.pl 来做使用者认证。
• pop3_authserver：指定 POP3 主机是哪一台。
• getmail_from_pop3_authserver：这个要设为 yes ，不然，使用者看不到在 POP3 server 上的信件。
• use_syshomedir：以本机系统直接认证时，OpenWebmail 直接将资料储存在该使用者位在 home 的个人目录下，但是，透过本方式来收信，OpenWebmail 会以 web server 设定的身份来当使用者，一般都是 nobody:nobdy 或是 www:www ，所以不能让 OpenWebmail 使用 syshomedir，因此，我们设定 user_syshomedir 为 no ，它会为每个使用者自动建立一个目录 (预设是放在 OpenWebmail 的 etc/users 中，例如：gsyan 登入时，它会自动产生 cgi-bin/openwebmail/etc/users/gsyan )。
• use_homedirspools：理由类似前项说明，我们无法使用预设的 mail spool ，所以本选项设为 yes ，让 OpenWebmail 将邮件储存在为使用者自动产生的虚拟 home 中。
• frombook_for_realname_only：本选项设为 yes 的目的是，只让使用修改寄件人地址的真实姓名部份，邮件地址则不可修改。
• default_realname：配合前项设定，将预设的真实姓名设为 none ，也就是设为空的值，不然它会被设为跑 web server 的帐号的 realname 。

Q:当我们使用 use_syshomedir no 时如何设定使用者的虚拟 homedir ？
A:预设是在 openwebmail 的 etc/users ，我们可以依下列方法修改：

• 在 openwebmail.conf 中设定 ow_usersdir

  例如：要让使用者放在 /home/webmail 中则，加入下面这行
  ow_usersdir /home/webmail
  

• 建立前项所设定的目录，以前例来说就执行：

  mkdir /home/webmail
  

附注：

• 使用这种方式要注意 ow_usersdir 所在 partition 的空间够不够。
• openwebmail.conf 的相关设定可以叁考 cgi-bin/openwebmail/etc/openwebmail.conf.help
• 本部份目前在 openwebmail-2.30 上测试成功。