第0步:构建 (仅适用于每日更新版本)
如果你下载的是二进制的发布文件(distibution),那就不需要构建James,可以直接进行下一步。
编译James需要使用Ant,它是一个专为Java语言提供的,可通过XML配置,可扩展的构建系统。 我们目前用的是Ant 1.4, 包含源码发布。
如果你下载的是每日更新(daily snapshot)版本,你就需要自己进行构建。James在它的发布包里包含了Ant。把更新版本解压到你喜欢的文件夹下,进入到那个文件夹下,可以看到有个build.bat文件或build.sh文件,运行这个文件进行构建,你会在发布路径(dist directory)下得到一个没有打包的二进制发布文件,但没有档案(archives)。
这个 "./dist"路径是发布路径,在步骤1和以后都会用到。你既可以进入./dist路径把所有文件拷贝到你的安装路径下,也可以把整个目录拷过去后重命名这个文件夹。
如果你愿意,你可以用“dist”参数进行构建("build dist" 或 "./build.sh dist")。这样就会在 "./dist"路径下同时创建一个发布文件和这个目录的.tgz和.zip文件。然而,要创建文件可能还需要其它的资源。
警告! 你在发布路径('dist' directory)下所做的任何改动在重新编译后都会丢失,如果你要修改conf.xml文件或其他任何文件,我们建议你先给这个文件的做一备份,然后修改留在src目录下的那个文件,免得做了无用功。
第1步: 安装.
将下载的James发布文件解压,将解压后得到的发布路径(dist directory)下的所有文件拷贝到你的安装目录下,或者直接将发布文件解压到安装路径下。
第2步: 配置.
看一看docs/index.html文件中简洁明了的介绍,你就会对如何配置系统有一个大概的了解。
总结 (有耐心就看一下吧,:))
微软(M$)的用户应该运行/bin/run.bat. Unix 用户会在相同的目录下发现 run.sh 文件。 JVM 是必需的,它的存储路径要在环境变量JAVA_HOME中说明。在windows中,用命令行"set JAVA_HOME=\jdk1.3\bin"类似的命令设置这个环境变量, *nix下用 JAVA_HOME=/jdk1.3/
运行 [run* --help]会显示一个简单的命令行帮助。
大多数 UNIX 系统要去超级用户授权才能开放1024以下的socket端口,包括标准的 IANA- SMTP (端口 25) 和 POP3 (端口110). 你可以在conf.xml文件中改变这些默认的端口,(很明显,你也需要对你的客户端进行配置。如果你的服务器会对外提供邮件服务,那这种方法就是不可取的。)
Avalon框架(framework)在你启动服务器的时候会释放(unpack)必要的配置文件。启动服务,然后在停止它 (ctrl-c),你就可以编辑配置文件了(*nix 用户可以用./run.sh %26amp;在后台运行服务). 对于基本的应用,你只需要设置AMES.conf.xml文件中的两项内容:远程管理员的登录密码和DNS服务器的IP地址。一旦你完成配置文件的编辑,在Avalon等待的终端窗口里按回车键结束配置。
第 4步: 启动
启动后你会看到一条提示信息,说Avalon正在运行。这意味着Avalon已经载入了JAMES和其它所有需要的模块 (在 /logs/avalon.log文件里可以看到) ,开始等待socket请求了。 既然一开始James是空的,他不会有任何注册的本地用户。如果你想注册一个本地用户的话,首先telnet到本地主机的4555端口,以root的身份进入系统("root[enter] [enter]"),键入 "help" 显示"JAMES remote administrator tool"的可用命令列表 。虽然这个命令集很基本,但他应该可以让你测试安装是否成功。
在你注册了一些本地用户之后,试着用SMTP(端口25)给他们发送邮件到@localhost(假设你没有改变conf.xml文件中的默认服务器名)。你会在../var/mail/localinbox/[user].文件夹下看到有邮件出现。。现在你就可以试着通过POP3(端口110)接收(retrieve)邮件了。Trace out JAMES 执行的动作会记录在 /logs/*info.log文件中。 JAMES对收到的邮件执行的动作在mailet 管道(/conf/JAMES.conf.xml) 里进行了配置。如果你想要知道发生了什么你可以查看这个文件。
祝你好运 :) ,