Apache james mailserver + Claros inTouch webmail

准备：
     环境winxp + jdk1.6 + tomcat6.0.16
    apache james2.3.2 (邮件服务器)
    Claros inTouch2.1.war (WebMail界面程序)
安装：
    1、安装james邮件服务容器：james下载后直接解压后启动就可以了，下载到http://james.apache.org。

重点介绍一下两个文件夹bin 和 apps.

bin目录中的run.bat和run.sh是James的启动程序。只要记住这个重要文件就可以。
apps目录下在服务器第一次启动之前，只有james.sar、dummy.txt两个文件，第一次启动后apps下会生产其他文件。apps\james\SAR-INF下有一个config.xml是james中的核心配置文件。config.xml在第一次启动之前是没有的，需要启动james服务器来生成config.xml文件。
运行run.dat启动服务器

Using PHOENIX_HOME:   C:\james-2.3.2
Using PHOENIX_TMPDIR: C:\james-2.3.2\temp
Using JAVA_HOME:

Phoenix 4.2

James Mail Server 2.3.2
Remote Manager Service started plain:4555
POP3 Service started plain:110
SMTP Service started plain:25
NNTP Service started plain:119
FetchMail Disabled

  对james_home\apps\james\SAR-INF\config.xml做修改。
     1.1：修改自己的邮件服务名，如同[e-mail]  

<postmaster>[e-mail]</postmaster>
 <servernames autodetect="true" autodetectIP="true"><!-- 如果将autodetect和autodetectIP设置为false，标识邮件服务器将不侦测ip-->
     <servername>byzh.com</servername>
 </servernames>

     1.2：修改dns服务。

 <dnsserver>
       <servers>         
           <server>byzh.com</server>
          <server>smtp.163.com</server>
           <server>mail.126.com</server>
       </servers>
       <!-- 修改自动探测为false 如果为true 可能在开发时出现异常 -->
       <autodiscover>false</autodiscover>
       <authoritative>false</authoritative>
      <maxcachesize>50000</maxcachesize>
</dnsserver>

修改了dns，(在开启smtp验证的情况下)注释掉以下配置，

<mailet match="RemoteAddrNotInNetwork=127.0.0.1" class="ToProcessor">
            <processor> relay-denied </processor>
            <notice>550 - Requested action not taken: relaying denied</notice>
</mailet>

并且，开启SMTP Server 身份验证：

<authRequired>true</authRequired>

将位于<smtpserver>标签之间的<authRequired>标签得值设为true

     1.3：修改远程管理。以便在cmd控制台中执行telnet byzh.com 4566命令。

<remotemanager enabled="true">
        <port>4566</port>
        <handler>
           <helloName autodetect="true">myMailServer</helloName>
           <administrator_accounts>
              <account login="root" password="123456"/>
           </administrator_accounts>
           <connectiontimeout>60000</connectiontimeout>
           <prompt>welcome to mt Sever&gt;</prompt>
       </handler>
 </remotemanager>

1.4：修改pop3，stmp，nntp服务。

 <pop3server enabled="true">
        <port>110</port>
        <handler>
           <helloName autodetect="true">myMailServer</helloName>
           <connectiontimeout>120000</connectiontimeout>
        </handler>
 </pop3server>

<smtpserver enabled="true">
       <port>25</port>
      <handler>
         <helloName autodetect="true">myMailServer</helloName>
          <connectiontimeout>360000</connectiontimeout>
          <authRequired>true</authRequired>
           <authorizedAddresses>127.0.0.0/8</authorizedAddresses>
          <maxmessagesize>0</maxmessagesize>
       </handler>
 </smtpserver>

<nntpserver enabled="true">
       <port>119</port>
       <handler>
         <helloName autodetect="true">myMailServer</helloName>
          <connectiontimeout>120000</connectiontimeout>
          <authRequired>false</authRequired>
       </handler>
 </nntpserver>

   1.5：James邮件用户的用户信息默认保存在apps\james\var\users目录下，
           通过修改配置文件apps\james\SAR-INF\config.xml，可以把用户信息保存到数据库中，配置方法如下
    打开config.xml，找到这一项，此面默认的内容为：

<repository name="LocalUsers" class="org.apache.james.userrepository.UsersFileRepository">
          <destination URL="file://var/users/"/>
 </repository>

需要修改为:

<repository name="LocalUsers" class="org.apache.james.userrepository.JamesUsersJdbcRepository" 
              destinationURL="db://maildb/users">
         <sqlFile>file://conf/sqlResources.xml</sqlFile>
 </repository>

   通过修改，我们就把用户信息的存储介质从file改成了db，是指明了在db中的数据表结构及相关数据库信息。
    仍然是config.xml，找到项，注意先要创建好java_mail数据库，把此项内容修改为：

<data-source name="maildb" class="org.apache.james.util.mordred.JdbcDataSource">
          <driver>com.mysql.jdbc.Driver</driver>
3         <dburl>jdbc:mysql://127.0.0.1:3306/java_mail?useUnicode=true&amp;characterEncoding=UTF-8</dburl>
          <user>root</user>
          <password>root</password>
          <max>20</max>
 </data-source>

<driver>是指MySQL的JDBC驱动，指数据库的访问路径，IP后的mail即MySQL中新建数据库名，接下来是用户名、密码及最大连接数。 需要讲mysql的驱动jar包添加到lib目录下.
    至此，数据库配置完成，启动James，若正常无误，请通过telnet添加一个新用户，比如adduser holen 123456，然后检查MySQL中的mail数据库，下面将有一个表users，这是James根据james_home\apps\james\conf的内容创建的。
    通过以上配置，James的用户信息就可以保存在数据库中了。

    1.6：修改c:/windows/system32/drivers/etc/hosts文件，增加一个地址映射。

#192.168.0.100 byzh.com
  127.0.0.1     byzh.com

    1.8：执行james_home\bin\run.bat，启动james2.3服务。

    1.8：进入命令模式，执行telnet byzh.com 4566，连接james2.3服务。

    1.9：以管理员省份登录james2.3服务，用户就是1.3节配置的root/123456。
    1.9.1：添加2个用户，a/123456，b/123456。

2：安装claros inTouch，下载claros-intouch-2.1，把intouch2.war拷贝到tomcat中。配置tomcat_home\webapps\intouch2\WEB-INF\config\config.xml。

<?xml version="1.0" encoding="UTF-8"?>
<claros-config>

    <common-params>
        <charset>utf-8</charset>
        <server-timezone>Europe/Istanbul</server-timezone>
        <tmp-dir>/tmp</tmp-dir>
        <max-attachment-size>5</max-attachment-size>
        <max-mail-size>10</max-mail-size>
        <title>Claros inTouch 2.1</title>
        <spam-check-enabled>false</spam-check-enabled>
        <default-lang>zh_cn_utf8</default-lang>
        <rss-feed>http://rss.cnn.com/rss/cnn_topstories.rss</rss-feed>
    </common-params>

    <chat>
        <default-domain>claros.org</default-domain>
        <msn-transport>msn.claros.org</msn-transport>
        <yahoo-transport>yahoo.claros.org</yahoo-transport>
        <icq-transport>icq.claros.org</icq-transport>
        <aol-transport>aol.claros.org</aol-transport>
    </chat>

    <servers>
        <server>
            <shortname>byzh.com</shortname>
            
            <!-- your imap/pop3 server ip/dns 
            <fetch-server-port>143</fetch-server-port>
            <fetch-protocol>imap</fetch-protocol>
            -->
            <fetch-server>byzh.com</fetch-server>
            <fetch-server-port>110</fetch-server-port>
            <fetch-protocol>pop3</fetch-protocol>
            <fetch-ssl>false</fetch-ssl>

            <smtp-server>byzh.com</smtp-server>
            <smtp-server-port>25</smtp-server-port>
            <smtp-authenticated>true</smtp-authenticated>
            <smtp-ssl>false</smtp-ssl>
            
            <!-- IMAP only: if you use courier or cyrus you'll need to set the following to "INBOX." 
            (with the dot(.) but omit the quotes) -->
            <folder-namespace></folder-namespace>
        </server>
    </servers>
     
    <db-config>
        <db>
            <!-- do not change the term file -->
            <id>file</id>
            <database>jdbc:mysql://127.0.0.1:3306/java_mail?useUnicode=true&amp;characterEncoding=UTF-8</database>
            <driver>com.mysql.jdbc.Driver</driver>
            <login>root</login>
            <password>root</password>
        </db>
    </db-config>

</claros-config>

注意点：安装路径不能带空格，不然会找不到config.xml。
    正常情况下就可以登录了，数据库使用了是MySQL。

    2.1：同样在java_mail数据库中创建inTouch webmail需要的表，sql文件在下载的claros-intouch包中。
2.2：启动tomcat，打开浏览器，输入http://localhost:8080/intouch2/index.jsp
    2.3：登录inTouch WebMail，用户b/123456。

    如果不能登录，可以查看log文件夹底下的log文件，查看出错信息。