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，同时，找到位于

- <!--

-->

-

-

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

- <!-- CONFIRM?

-->

<servername> localhost </servername>

</servernames>

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

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

- <dnsserver>

- <servers>

-

-

-

</servers>

<authoritative>false</authoritative>

</dnsserver>

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

Ø 修改管理员密码：

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

- <administrator_accounts>

- <!-- CHECKME!

-->

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

-->

</administrator_accounts>

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

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

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

- <remotemanager>

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

此时输入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>

需要修改为：

<repository name="LocalUsers"

class="org.apache.james.userrepository.JamesUsersJdbcRepository" destinationURL="db://maildb/users">

<sqlFile>file://conf/sqlResources.xml</sqlFile>

</repository>

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

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

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

</data-source>

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