Apache james mailserver + Claros inTouch webmail

准备：
    环境winxp + jdk1.6 + tomcat6.0.16
    apache james2.3 (邮件服务器)
    Claros inTouch2.1.war (WebMail界面程序)

安装：
    1、安装james邮件服务容器：james下载后直接解压后启动就可以了，
       对james_home\apps\james\SAR-INF\config.xml做修改。
   
    1.1：修改自己的邮件服务名，如同 [email protected]   

1  < postmaster > [email protected] </ postmaster >
2  < servernames  autodetect ="true"  autodetectIP ="true" >
3       < servername > byzh.com </ servername >
4  </ servernames >

   
    1.2：修改dns服务。

 1 < dnsserver >
 2        < servers >          
 3            < server > byzh.com </ server >
 4            < server > smtp.163.com </ server >
 5           < server > mail.126.com </ server >
 6        </ servers >
 7        <!--  修改自动探测为false 如果为true 可能在开发时出现异常  -->
 8        < autodiscover > false </ autodiscover >
 9        < authoritative > false </ authoritative >
10        < maxcachesize > 50000 </ maxcachesize >
11 </ dnsserver >

    
    修改了dns，就要注释掉以下配置

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

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

1 < authRequired > true </ authRequired >

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

 1    < remotemanager  enabled ="true" >
 2         < port > 4566 </ port >
 3         < handler >
 4            < helloName  autodetect ="true" > myMailServer </ helloName >
 5            < administrator_accounts >
 6               < account  login ="root"  password ="123456" />
 7            </ administrator_accounts >
 8            < connectiontimeout > 60000 </ connectiontimeout >
 9            < prompt > welcome to mt Sever &gt; </ prompt >
10         </ handler >
11  </ remotemanager >

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

 1  < pop3server  enabled ="true" >
 2         < port > 110 </ port >
 3         < handler >
 4            < helloName  autodetect ="true" >myMailServer </ helloName >
 5            < connectiontimeout > 120000 </ connectiontimeout >
 6         </ handler >
 7 </ pop3server >

 8  < smtpserver  enabled ="true" >
 9         < port > 25 </ port >
10         < handler >
11            < helloName  autodetect ="true" > myMailServer </ helloName >
12            < connectiontimeout > 360000 </ connectiontimeout >
13            < authRequired > true </ authRequired >
14             < authorizedAddresses > 127.0.0.0/8 </ authorizedAddresses >
15            < maxmessagesize > 0 </ maxmessagesize >
16         </ handler >
17  </ smtpserver >

18  < nntpserver  enabled ="true" >
19         < port > 119 </ port >
20         < handler >
21            < helloName  autodetect ="true" > myMailServer </ helloName >
22            < connectiontimeout > 120000 </ connectiontimeout >
23            < authRequired > false </ authRequired >
24         </ handler >
25  </ nntpserver >

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

    打开config.xml，找到<users-store>这一项，此面默认的内容为：

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

    需要修改为：

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

 

    通过修改，我们就把用户信息的存储介质从file改成了db，<sqlFile>是指明了在db中的数据表结构及相关数据库信息。

    仍然是config.xml，找到<data-sources>项，注意先要创建好java_mail数据库，把此项内容修改为：

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

     <driver>是指MySQL的JDBC驱动，<dburl>指数据库的访问路径，IP后的mail即MySQL中新建数据库名，接下来是用户名、密码及最大连接数。

    至此，数据库配置完成，启动James，若正常无误，请通过telnet添加一个新用户，比如adduser holen 123456，然后检查MySQL中的mail数据库，下面将有一个表users，这是James根据james_home\apps\james\conf的内容创建的。

    通过以上配置，James的用户信息就可以保存在数据库中了。

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

1  #192.168.0.100 byzh.com
2   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如下：

  1  CREATE   TABLE  `CALENDAR_OBJECTS` (
  2    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
  3    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
  4    `RECORD_DATE`  timestamp   NOT   NULL ,
  5    `REPEAT_TYPE`  int ( 11 )  NOT   NULL   default   ' 0 ' ,
  6    `CATEGORY`  varchar ( 255 )  NOT   NULL   default   '' ,
  7    `DESCRIPTION`  text   NOT   NULL ,
  8    `REMINDER_DAYS`  int ( 11 )  NOT   NULL   default   ' 0 ' ,
  9     PRIMARY   KEY   (`ID`)
 10  ) ENGINE =  InnoDB  default  charset = utf8;
 11 
 12  #  Dump   of   table  CONTACTS
 13  #  -- ----------------------------------------------------------
 14 
 15  CREATE   TABLE  `CONTACTS` (
 16    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
 17    `USERNAME`  varchar ( 255 )  default   '' ,
 18    `FIRST_NAME`  varchar ( 100 )  NOT   NULL   default   '' ,
 19    `MIDDLE_NAME`  varchar ( 100 )  default   '' ,
 20    `LAST_NAME`  varchar ( 100 )  NOT   NULL   default   '' ,
 21    `TITLE`  varchar ( 50 )  default   '' ,
 22    `SEX`  varchar ( 10 )  default   '' ,
 23    `GSM_NO_PRIMARY`  varchar ( 30 )  default   '' ,
 24    `GSM_NO_ALTERNATE`  varchar ( 30 )  default   '' ,
 25    `EMAIL_PRIMARY`  varchar ( 255 )  default   '' ,
 26    `EMAIL_ALTERNATE`  varchar ( 255 )  default   '' ,
 27    `WEB_PAGE`  varchar ( 255 )  default   '' ,
 28    `PERSONAL_NOTE`  text ,
 29    `SPOUSE_NAME`  varchar ( 255 )  default   '' ,
 30    `NICK_NAME`  varchar ( 50 )  default   '' ,
 31    `HOME_ADDRESS`  text ,
 32    `HOME_CITY`  varchar ( 255 )  default   '' ,
 33    `HOME_PROVINCE`  varchar ( 255 )  default   '' ,
 34    `HOME_ZIP`  varchar ( 5 )  default   '' ,
 35    `HOME_COUNTRY`  varchar ( 100 )  default   '' ,
 36    `HOME_PHONE`  varchar ( 30 )  default   '' ,
 37    `HOME_FAKS`  varchar ( 30 )  default   '' ,
 38    `WORK_COMPANY`  varchar ( 100 )  default   '' ,
 39    `WORK_JOB_TITLE`  varchar ( 100 )  default   '' ,
 40    `WORK_DEPARTMENT`  varchar ( 100 )  default   '' ,
 41    `WORK_OFFICE`  varchar ( 100 )  default   '' ,
 42    `WORK_PROFESSION`  varchar ( 100 )  default   '' ,
 43    `WORK_MANAGER_NAME`  varchar ( 255 )  default   '' ,
 44    `WORK_ASSISTANT_NAME`  varchar ( 255 )  default   '' ,
 45    `WORK_ADDRESS`  text ,
 46    `WORK_CITY`  varchar ( 255 )  default   '' ,
 47    `WORK_PROVINCE`  varchar ( 255 )  default   '' ,
 48    `WORK_ZIP`  varchar ( 5 )  default   '' ,
 49    `WORK_COUNTRY`  varchar ( 100 )  default   '' ,
 50    `WORK_PHONE`  varchar ( 30 )  default   '' ,
 51    `WORK_FAKS`  varchar ( 30 )  default   '' ,
 52    `BIRTH_DAY`  varchar ( 2 )  default   NULL ,
 53    `ANNIVERSARY_DAY`  varchar ( 2 )  default   NULL ,
 54    `BIRTH_MONTH`  varchar ( 2 )  default   NULL ,
 55    `ANNIVERSARY_MONTH`  varchar ( 2 )  default   NULL ,
 56     PRIMARY   KEY   (`ID`)
 57  ) ENGINE =  InnoDB  default  charset = utf8;
 58 
 59  #  Dump   of   table  CONTACT_GROUPS
 60  #  -- ----------------------------------------------------------
 61 
 62  CREATE   TABLE  `CONTACT_GROUPS` (
 63    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
 64    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
 65    `SHORT_NAME`  varchar ( 100 )  default   '' ,
 66    `DESCRIPTION`  varchar ( 255 )  default   '' ,
 67     PRIMARY   KEY   (`ID`)
 68  ) ENGINE =  InnoDB  default  charset = utf8;
 69 
 70  #  Dump   of   table  CONTACT_GROUP_OBJECTS
 71  #  -- ----------------------------------------------------------
 72 
 73  CREATE   TABLE  `CONTACT_GROUP_OBJECTS` (
 74    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
 75    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
 76    `GROUP_ID`  bigint ( 20 )  NOT   NULL   default   ' 0 ' ,
 77    `CONTACT_ID`  bigint ( 20 )  NOT   NULL   default   ' 0 ' ,
 78     PRIMARY   KEY   (`ID`)
 79  ) ENGINE =  InnoDB  default  charset = utf8;
 80 
 81 
 82 
 83  #  Dump   of   table  FOLDER_DB_OBJECTS
 84  #  -- ----------------------------------------------------------
 85 
 86  CREATE   TABLE  `FOLDER_DB_OBJECTS` (
 87    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
 88    `USERNAME`  varchar ( 255 )  default   NULL ,
 89    `PARENT_ID`  bigint ( 20 )  default   ' 0 ' ,
 90    `FOLDER_NAME`  varchar ( 100 )  NOT   NULL   default   '' ,
 91    `FOLDER_TYPE`  int ( 10 ) unsigned  NOT   NULL   default   ' 4 ' ,
 92     PRIMARY   KEY   (`ID`),
 93     KEY  `USERNAME` (`USERNAME`)
 94  ) ENGINE =  InnoDB  default  charset = utf8;
 95 
 96  #  Dump   of   table  MSG_DB_OBJECTS
 97  #  -- ----------------------------------------------------------
 98 
 99  CREATE   TABLE  `MSG_DB_OBJECTS` (
100    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
101    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
102    `FOLDER_ID`  bigint ( 20 ) unsigned  NOT   NULL   default   ' 0 ' ,
103    `UNIQUE_ID`  varchar ( 100 )  NOT   NULL   default   '' ,
104    `UNREAD`  tinyint ( 1 )  default   ' 0 ' ,
105    `MSG_SIZE`  bigint ( 20 ) unsigned  NOT   NULL   default   ' 0 ' ,
106    `EMAIL` longblob,
107     PRIMARY   KEY   (`ID`)
108  ) ENGINE =  InnoDB  default  charset = utf8;
109 
110 
111  #  Dump   of   table  MSG_RULES
112  #  -- ----------------------------------------------------------
113 
114  CREATE   TABLE  `MSG_RULES` (
115    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
116    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
117    `PORTION`  varchar ( 100 )  default   NULL ,
118    `RULE_CONDITION`  varchar ( 30 )  default   NULL ,
119    `KEYWORD`  varchar ( 255 )  default   NULL ,
120    `RULE_ACTION`  varchar ( 30 )  default   NULL ,
121    `DESTINATION`  varchar ( 100 )  default   NULL ,
122     PRIMARY   KEY   (`ID`),
123     KEY  `USERNAME` (`USERNAME`)
124  ) ENGINE =  InnoDB  default  charset = utf8;
125 
126  #  Dump   of   table  NOTES
127  #  -- ----------------------------------------------------------
128 
129  CREATE   TABLE  `NOTES` (
130    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
131    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
132    `FOLDER_ID`  bigint ( 20 )  NOT   NULL   default   ' 0 ' ,
133    `NOTE_CONTENT`  text ,
134    `POS_LEFT`  int ( 11 )  default   NULL ,
135    `POS_TOP`  int ( 11 )  default   NULL ,
136    `POS_WIDTH`  int ( 11 )  default   NULL ,
137    `POS_HEIGHT`  int ( 11 )  default   NULL ,
138    `NOTE_COLOR`  varchar ( 20 )  default   NULL ,
139    `NOTE_BAR_COLOR`  varchar ( 20 )  default   NULL ,
140    `NOTE_BORDER_COLOR`  varchar ( 20 )  default   NULL ,
141    `NOTE_DATE`  datetime   default   NULL ,
142     PRIMARY   KEY   (`ID`)
143  ) ENGINE =  InnoDB  default  charset = utf8;
144 
145  #  Dump   of   table  NOTES_FOLDERS
146  #  -- ----------------------------------------------------------
147 
148  CREATE   TABLE  `NOTES_FOLDERS` (
149    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
150    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
151    `FOLDER_NAME`  varchar ( 255 )  NOT   NULL   default   '' ,
152     PRIMARY   KEY   (`ID`)
153  ) ENGINE =  InnoDB  default  charset = utf8;
154 
155  #  Dump   of   table  PREFERENCES
156  #  -- ----------------------------------------------------------
157 
158  CREATE   TABLE  `PREFERENCES` (
159    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
160    `USERNAME`  varchar ( 255 )  NOT   NULL ,
161    `PREF_KEY`  varchar ( 255 )  NOT   NULL ,
162    `PREF_VALUE`  varchar ( 255 )  NOT   NULL ,
163     PRIMARY   KEY   (`ID`)
164  ) ENGINE =  InnoDB  default  charset = utf8;
165 
166  #  Dump   of   table  QUEUE
167  #  -- ----------------------------------------------------------
168 
169  CREATE   TABLE  `QUEUE` (
170    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
171    `MSG_FROM`  varchar ( 255 )  NOT   NULL   default   '' ,
172    `MSG_TO`  varchar ( 255 )  NOT   NULL ,
173    `MSG_TIME`  timestamp   NOT   NULL ,
174    `MSG_BODY` longtext  NOT   NULL ,
175    `MSG_DIRECTION`  varchar ( 3 )  NOT   NULL ,
176    `DELIVERED`  int ( 11 )  NOT   NULL   default   ' 0 ' ,
177     PRIMARY   KEY   (`ID`)
178  ) ENGINE =  InnoDB  default  charset = utf8;
179 
180  #  Dump   of   table  USER_PREFERENCES
181  #  -- ----------------------------------------------------------
182 
183  CREATE   TABLE  `USER_PREFERENCES` (
184    `ID`  bigint ( 20 ) unsigned  NOT   NULL  auto_increment,
185    `USERNAME`  varchar ( 255 )  NOT   NULL   default   '' ,
186    `KEYWORD`  varchar ( 255 )  NOT   NULL   default   '' ,
187    `PREF_VALUE`  varchar ( 255 )  NOT   NULL   default   '' ,
188     PRIMARY   KEY   (`ID`)
189  ) ENGINE =  InnoDB  default  charset = utf8;

  
    2.2：启动tomcat，打开浏览器，输入http://localhost:8080/intouch2/index.jsp
    2.3：登录inTouch WebMail，用户b/123456。

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