James的安装与使用

一、安装：

1．  环境要求：

已安装Java平台，版本为j2sdk1.4.2，环境变量JAVA_HOME设为C:/j2sdk1.4.2；

2．  下载与运行：

从Apache网站上下载得到一个压缩的文件james-2.1-bin.zip，大小为4.44M，将此包解压到C:/James/james-2.1下。

运行分为两种方式：前台直接运行、作为后台服务运行；

 

 

1>前台直接运行：

在C:/James/james-2.1/bin下运行run.bat

这是会出现：

 

 

Using PHOENIX_HOME:   C:/James/james-2.1

Using PHOENIX_TMPDIR: C:/James/james-2.1/temp

Using JAVA_HOME:      C:/j2sdk1.4.2

 

 

Phoenix 4.0.1

 

 

James 2.1

Remote Manager Service started plain:4555

POP3 Service started plain:110

SMTP Service started plain:25

NNTP Service Disabled

Fetch POP Disabled

 

 

这是就表示James邮件服务以开启，不过Window下不能关闭控制台窗口，否者邮件服务会停止。如要克服此缺点必须使James邮件服务作为作为后台服务运行。

 

 

停止前台运行按Ctrl+C,会出现：

JVM exiting abnormally. Shutting down Phoenix.

终止批处理操作吗(Y/N)?

             

2>后台服务运行：

将C:/James/james-2.1/conf目录下的wrapper.conf拷贝到C:/James/james-2.1/bin即包含wrapper.exe的目录下，运行：

wrapper.exe    -i     C:/James/james-2.1/bin/wrapper.conf 

然后在控制面板中开启服务或重启即可。

 

 

卸载后台服务：

到C:/James/james-2.1/bin即包含wrapper.exe的目录下，运行：

wrapper.exe     -r    C:/James/james-2.1/bin/wrapper.conf

3．   

二、配置：

1>服务器端配置（邮件服务器的名字假设叫EmailServer，服务器管理员名Admin）

首先停止已开启的James邮件服务，然后打开文件C:/James/james-2.1/apps/james/SAR-INF/config.xml。

Ø         在config.xml文件中，找到Postmaster@localhost，把此项改为Admin@EmailServer，同时，找到位于

<!--  By default, the servername 'localhost' is specified. This can be removed, if required.   -->

- <!-- 

  -->

- <!--  Warning: If you are using fetchpop it is important to include the   -->

- <!--  fetched domains in the server name list to prevent looping.       -->

- <servernames autodetect="true" autodetectIP="true">

- <!--  CONFIRM?

  -->

  <servername> localhost </servername>

  </servernames>

的localhost，把此项改为EmailServer。这样就可以让其它机器也能访问邮件系统。

 

 

Ø         DNS配置：找到同上文件中<dnsserver>段中的如下程序段：

- <dnsserver>

- <servers>

- <!--  CONFIRM?   -->

- <!-- Enter ip address of your DNS server, one IP address per server   -->

- <!--  element.  The default configuration assumes a DNS server on the localhost.   -->

  <server>127.0.0.1</server>

  </servers>

  <authoritative>false</authoritative>

  </dnsserver>

将127.0.0.1的位置填入DNS服务器的IP地址；

 

 

Ø         修改管理员密码：

找到同上文件中的<administrator_accounts>段，如下程序段

- <administrator_accounts>

- <!--  CHECKME!

  -->

- <!--  Change the default login/password.

  -->

  <account login="root" password="root" />

  </administrator_accounts>

 

 

将默认用户名root与密码root修改为需要的值

 

 

Ø         修改telnet管理程序登录端口 ：（默认为4555）

找到同上文件中的<remotemanager>段下的port如下程序段

- <remotemanager>

  <port>4555</port>

- <!--   Uncomment this if you want to bind to a specific inetaddress

  -->

-          <!--

将<port>4555</port>之间的端口号4555改为需要的端口。

 

 

2> 客户端配置：（略）

 

 

3> 帐号管理

James的账号管理是通过telnet完成的，登录命令为：

 

 

telnet EmailServer 4555

 

 

其中EmailServer也可以换成IP，4555是端口号。登录时需要用户名和密码，开始默认的用户名和密码均为root。若登录成功，提示如下：

JAMES Remote Administration Tool 2.1

Please enter your login and password

Login id:

       此时输入root用户名,然后会出现：

              Password:

       输入密码root

注意：在有些操作系统如Windows2000上，用户输入均不显示。

 

 

telnet命令列表：

                                                       

help	显示帮助
Listusers	列出目前存在的账户
Countusers	显示目前存在的账户的数量
addusers [用户名] [密码]	添加新用户
verify [用户名]	验证特定用户是否存在
deluser [用户名]	删除已存在用户
setpassword [用户名] [密码]	设置某一用户的密码
setalias [别名] [用户名]	从本地将[别名]的所有邮件转寄[用户名]
unsetalias [别名]	取消setalias设置
setforwarding [用户名] [email地址]	将[用户名]的邮件转寄指定[email地址]
unsetforwarding [用户名]	取消setforwarding设置
user [资源]	变为另一用户的资源
shutdown	停止当前James邮件服务的JVM程序(对于James为后台服务时，用此命令很方便)
Quit	断开telnet连接

 

 

4>用户信息的数据库存储

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

假设使用的是MySQL数据库：

 

 

第一步：首先将MySQL的驱动程序（例如：mysql-connector-java-3.1.6-bin.jar）考到james的lib目录下（例如：D:/james/lib）

 

 

第二步：在MySQL中新建一个数据库mail；

 

 

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

<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>

其实如不修改也行，因为文件下面也有实例，不过是用<!-- 和 --> 注释掉的，打开即可；记住把

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

用<!-- 和 --> 注释掉；

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

 

 

第四步：仍然是config.xml，找到<data-sources>项，默认内容为空，把此项内容修改为：

<data-source name="maildb" class="org.apache.james.util.mordred.JdbcDataSource">                            <driver>org.gjt.mm.mysql.Driver</driver>                             <dburl>jdbc:mysql://127.0.0.1/mail</dburl>                             <user>root</user>                             <password></password>                             <max>20</max> </data-source>

或打开文件下面实例的<!-- 和 --> 注释

<driver>是指MySQL的JDBC驱动，注意这个默认的<driver>是有问题的，要改成MySQL的驱动程序中Driver.class的路径，即：

                   <driver>com.mysql.jdbc.Driver</driver>

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

 

 

再次启动时，james将在mail数据库中自动创建有关用户的表格。

 

 

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

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

注：修改以前的账户会丢失！

 

 

 

 

一、FAQ

1、 在启动james时，提示POP3或SMTP不能使用？

请检查一下，看“管理工具—>服务”里面，是不是启动了别的邮件服务器，已将110或25端口占用了。

       实例：

james前台直接运行时出错：

ERROR   2005-08-25 08:58:38.642 [Phoenix.] (): Component named "smtpserver" failed to pass through the Initialization stage. (Reason: java.net.BindException: Address already in use: JVM_Bind).

 

 

ERROR   2005-08-25 08:58:38.652 [Phoenix.] (): There was an error running phase "startup" for Block named "smtpserver". (Reason: Component named "smtpserver" failed to pass through the Initialization stage. (Reason: java.net.BindException: Address already in use: JVM_Bind).).

 

 

org.apache.excalibur.containerkit.lifecycle.LifecycleException: Component named "smtpserver" failed to pass through the Initialization stage. (Reason: java.net.BindException: Address already in use: JVM_Bind).

 

 

原因：

  james默认设置不允许在同一台机器上跑两个邮件服务器进程。必须关掉另一个！

 

检测方法：

console界面下：

  d:> telnet 主机名 25（或110）

如果可以登录，出现

  220 主机名 Microsoft ESMTP MAIL Service, Version: 6.0.2600.1106 ready at  Thu,

 25 Aug 2005 14:14:36 +0800

则说明此机器上已有一台邮件服务器在运行。

 

 

解决：

检查Windows上运行服务：

跨网传输电子邮件的服务Simple Mail Transfer Protocol (SMTP)，是否启动

如启动关闭之！

 

 

2、 JAVA_HOME找不到？

请在run.bat中指定JAVA_HOME，若还不行，请在“我的电脑—>系统—>高级—>环境变量”中添加一项JAVA_HOME。

 

 

3、 服务器启动正常，但客户端不能收发邮件？

请检查客户端配置是否正常，参照前面所讲，另外，请检查james下的config.xml，是否把localhost改成了机器名。

 

 

4、修改为数据库储存后，james启动出错：

一般是数据库驱动有错。检查一下

<data-source name="maildb" class="org.apache.james.util.mordred.JdbcDataSource">
                           <driver>org.gjt.mm.mysql.Driver</driver>
                            <dburl>jdbc:mysql://127.0.0.1/mail</dburl>
                            <user>root</user>
                            <password></password>
                            <max>20</max>
</data-source>

的<driver>org.gjt.mm.mysql.Driver</driver>是否对