DOMINO安装配置和DIIOP收发邮件手册.doc

Domino安装配置操作手册数字天堂2009-03-23修订历史：时间修订内容里程碑版本号修订人2009/5/28创建文档V0.1马红明1 安装说明本文档描述了DOMINO服务器、DOMINO管理端工具在windows操作系统的安装配置与说明，主要通过截图的方式描述了相关步骤，并对关键步骤做了说明解释，图例文件仅供参考。安装文件如下：TLF-SOFT-IBM.Lotus.Domino.Server.Enterprise.Edition.v8.0.2.ISO-LZ0.isoTLF-SOFT-IBM.Lotus.Notes.Domino.Designer.And.Admin.Client.v8.0.2.ISO-LZ0.iso1.1 Domino服务器安装与配置1.1.1 Domino 服务器安装安装之前首先确认C盘至少有2个G左右的剩余空间，退出所有占用80端口的应用程序。首先通过虚拟光驱选择DOMINO服务器安装程序的镜像文件如上,DOMINO的服务器端程序已经安装完毕，接下来要完成DOMINO的配置工作。1.1.2 Domino服务器配置点击在桌面生成的快捷方式，进行如下配置：设置服务器的名字，一定要当心，一旦设置生效再想修改名称只能重新安装。组织名字通常设置成公司的名字DOMINO域的名字，通常设置成与上面的的组织名字相同。设置管理员的账号与密码启用如下所有的服务通过Customize设置DOMINO服务器启动的时候自动加载DIIOP服务。通过上图Customize设置DOMINO服务器的主机地址，这个地址即为邮件服务器符号之后的部分。如上操作完成了DOMINO的初始化配置，接下来再次点击桌面上的快捷健启动DOMINO服务器，通过管理员账号登陆，进行一些必要的个性化设置。1.1.3 Domino服务器个性化设置注意管理员账号通过WEB登录的地址配置Run unrestricted methods and operations: *、Sign agents to run on behalf of someone else:*，开通程序访问DOMINO的一些必要权限.建议修改netaddress为DOMINO服务器的IP地址修改DIIOP的主机地址为DOMINO服务器的IP地址，这样程序就可以通过DIIOP服务与DOMINO服务器进行通信。把NCSO.jar加入到操作系统的环境变量。 1.2 Domino管理端工具安装与配置1.2.1 Domino管理端工具安装Domino Administrator默认未被选中，这里需要将其选中lotus管理端工具即安装完毕。1.2.2 Domino管理端工具的配置通过桌面的快捷键，进入管理工具的配置页面。配置管理员的用户名和Domino server的名字，这里需要与Domino服务器安装时的配置信息一致。配置Domino server的名字、连接服务器的协议、服务器地址等信息。输入管理员的密码实例信息没必要设置，去掉该选项，进行下一步操作。如上操作已经完成管理端工具的配置工作，接下来注册一个账号，点击右侧的Register选项第一次注册用户需要选择cert.id输入管理员的密码设置注册账号的名字，通过Password Option选项可根据需要设置密码强度设置账号密码初始信息设置好后，点击register注册该账号，会在服务器端生成该账号的绑定信息。如上操作，该账号的信息已经被注册成功，但是该账号还不能通过web页面登陆服务器，需要管理员进入服务器端的账号管理页面重置该账号密码，点击Enter Password输入密码。保存设置的信息，重启DOMINO服务器，一个能够通过web登陆的粗糙的domino账号已经成功开户。Domino服务器重新启动后，通过新开通的账号登陆，发送第一封邮件测试一下吧1.3 通过DIIOP连接domino服务器并获取邮件通过DIIOP收取邮件的前提条件是：l 开通DIIOP服务，开通63148端口；l 开通HTTP服务或者提供diiop_ior.txt文件；l 开通diiop服务器的domino服务器上要有需要利用DIIOP收发邮件的用户的数据库：user.nsfl 可以在开通diiop服务的服务器上登陆domino服务器并在WEB上进行收发邮件。1.3.1 通过diiop建立连接通过IBM提供的NOSO.jar，调用NotesFactory的createSession方法，来开启和domino服务器之间的会话。Session session = NotesFactory.createSession(dominoHost,username,password); dominoHost:domino服务器地址 username:用户登录domino的用户名,一般是邮件地址前面的字符 password:用户登录邮件服务器的密码;Domino的DIIOP的会话默认是通过63148端口来通信的，所以服务器必须开通63148端口。创建会话流程：l 从服务器上获取diiop_ior.txt文件；l 根据diiop_ior.txt文件创建连接。所以，默认开通DIIOP服务器以后还要开通80端口PE才可以直接通过绑定域名或者服务器IP直接进行绑定。如果没有开通80端口则需要在服务器IP后面加上 ：63148才能访问。1.3.2 打开domino服务器上的用户数据库Domino存放邮件的文件叫做数据库，每一封邮件是一个document。所以收取邮件就要先打开用户的数据库。用户的数据库的名字是 用户名.nsf ，如有一个用户的邮箱账号是 ，那么用户的数据库文件就是 test.nsf。用户的数据库在没有进行特殊配置的情况下，存放目录是domino安装目录的data文件夹下的 mail文件夹中。可以通过刚才打开的会话开启数据库:Database session.getDatabase(session.getServerName(), “mail/” + user + .nsf); 第一个参数：domino配置的ServerName参数,唯一标识一台domino服务器的参数； 第二个参数：用户数据库路径。如果在domino的配置中修改过了用户数据库的存放目录的话,就需要把mail/改成相应目录就可以了。1.3.3 取得用户的邮件列表用DIIOP方式获取用户邮件列表首先需要打开需要获取邮件列表的用户视图，如果没有指定的话，默认打开的视图是收件箱视图（即($Inbox)视图）。然后遍历这个视图中的document列表，拼接处邮件的编号列表即UIDLS列表。根据以前开发经验，用DIIOP打开数据库获取列表的方法效率很低。后来采用模拟WEB登陆domino服务器，然后在网页上取得 viewEntry，通过取得viewEntry来拼接列表。这