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

1|DigitalHeavenInformation&TechnologyCo.,Ltd.Domino安装配置操作手册数字天堂2009-03-232|DigitalHeavenInformation&TechnologyCo.,Ltd.修订历史：时间修订内容里程碑版本号修订人2009/5/28创建文档V0.1马红明3|DigitalHeavenInformation&TechnologyCo.,Ltd.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.1Domino服务器安装与配置1.1.1Domino服务器安装安装之前首先确认C盘至少有2个G左右的剩余空间，退出所有占用80端口的应用程序。首先通过虚拟光驱选择DOMINO服务器安装程序的镜像文件4|DigitalHeavenInformation&TechnologyCo.,Ltd.5|DigitalHeavenInformation&TechnologyCo.,Ltd.6|DigitalHeavenInformation&TechnologyCo.,Ltd.7|DigitalHeavenInformation&TechnologyCo.,Ltd.8|DigitalHeavenInformation&TechnologyCo.,Ltd.9|DigitalHeavenInformation&TechnologyCo.,Ltd.如上,DOMINO的服务器端程序已经安装完毕，接下来要完成DOMINO的配置工作。1.1.2Domino服务器配置点击在桌面生成的快捷方式，进行如下配置：10|DigitalHeavenInformation&TechnologyCo.,Ltd.11|DigitalHeavenInformation&TechnologyCo.,Ltd.设置服务器的名字，一定要当心，一旦设置生效再想修改名称只能重新安装。12|DigitalHeavenInformation&TechnologyCo.,Ltd.组织名字通常设置成公司的名字13|DigitalHeavenInformation&TechnologyCo.,Ltd.DOMINO域的名字，通常设置成与上面的的组织名字相同。设置管理员的账号与密码14|DigitalHeavenInformation&TechnologyCo.,Ltd.启用如下所有的服务通过Customize设置DOMINO服务器启动的时候自动加载DIIOP服务。15|DigitalHeavenInformation&TechnologyCo.,Ltd.通过上图Customize设置DOMINO服务器的主机地址，这个地址即为邮件服务器@符号之后的部分。16|DigitalHeavenInformation&TechnologyCo.,Ltd.17|DigitalHeavenInformation&TechnologyCo.,Ltd.如上操作完成了DOMINO的初始化配置，接下来再次点击桌面上的快捷健启动DOMINO服务器，通过管理员账号登陆，进行一些必要的个性化设置。18|DigitalHeavenInformation&TechnologyCo.,Ltd.1.1.3Domino服务器个性化设置19|DigitalHeavenInformation&TechnologyCo.,Ltd.注意管理员账号通过WEB登录的地址20|DigitalHeavenInformation&TechnologyCo.,Ltd.21|DigitalHeavenInformation&TechnologyCo.,Ltd.配置Rununrestrictedmethodsandoperations:*、Signagentstorunonbehalfofsomeoneelse:*，开通程序访问DOMINO的一些必要权限.建议修改netaddress为DOMINO服务器的IP地址22|DigitalHeavenInformation&TechnologyCo.,Ltd.修改DIIOP的主机地址为DOMINO服务器的IP地址，这样程序就可以通过DIIOP服务与DOMINO服务器进行通信。把NCSO.jar加入到操作系统的环境变量。23|DigitalHeavenInformation&TechnologyCo.,Ltd.1.2Domino管理端工具安装与配置1.2.1Domino管理端工具安装24|DigitalHeavenInformation&TechnologyCo.,Ltd.25|DigitalHeavenInformation&TechnologyCo.,Ltd.26|DigitalHeavenInformation&TechnologyCo.,Ltd.DominoAdministrator默认未被选中，这里需要将其选中27|DigitalHeavenInformation&TechnologyCo.,Ltd.28|DigitalHeavenInformation&TechnologyCo.,Ltd.lotus管理端工具即安装完毕。29|DigitalHeavenInformation&TechnologyCo.,Ltd.1.2.2Domino管理端工具的配置通过桌面的快捷键，进入管理工具的配置页面。配置管理员的用户名和Dominoserver的名字，这里需要与Domino服务器安装时的配置信息一致。30|DigitalHeavenInformation&TechnologyCo.,Ltd.配置Dominoserver的名字、连接服务器的协议、服务器地址等信息。31|DigitalHeavenInformation&TechnologyCo.,Ltd.输入管理员的密码32|DigitalHeavenInformation&TechnologyCo.,Ltd.实例信息没必要设置，去掉该选项，进行下一步操作。如上操作已经完成管理端工具的配置工作，接下来注册一个账号，点击右侧的Register选项33|DigitalHeavenInformation&TechnologyCo.,Ltd.第一次注册用户需要选择cert.id输入管理员的密码34|DigitalHeavenInformation&TechnologyCo.,Ltd.设置注册账号的名字，通过PasswordOption选项可根据需要设置密码强度35|DigitalHeavenInformation&TechnologyCo.,Ltd.36|DigitalHeavenInformation&TechnologyCo.,Ltd.设置账号密码初始信息设置好后，点击register注册该账号，会在服务器端生成该账号的绑定信息。37|DigitalHeavenInformation&TechnologyCo.,Ltd.如上操作，该账号的信息已经被注册成功，但是该账号还不能通过web页面登陆服务器，需要管理员进入服务器端的账号管理页面重置该账号密码，点击EnterPassword输入密码。38|DigitalHeavenInformation&TechnologyCo.,Ltd.保存设置的信息，重启DOMINO服务器，一个能够通过web登陆的粗糙的domino账号已经成功开户。Domino服务器重新启动后，通过新开通的账号登陆，发送第一封邮件测试一下吧…39|DigitalHeavenInformation&TechnologyCo.,Ltd.40|DigitalHeavenInformation&TechnologyCo.,Ltd.1.3通过DIIOP连接domino服务器并获取邮件通过DIIOP收取邮件的前提条件是：开通DIIOP服务，开通63148端口；开通HTTP服务或者提供diiop_ior.txt文件；开通diiop服务器的domino服务器上要有需要利用DIIOP收发邮件的用户的数据库：user.nsf可以在开通diiop服务的服务器上登陆domino服务器并在WEB上进行收发邮件。1.3.1通过diiop建立连接通过IBM提供的NOSO.jar，调用NotesFactory的createSession方法，来开启和domino服务器之间的会话。Sessionsession=NotesFactory.createSession(dominoHost,username,password);dominoHost:domino服务器地址username:用户登录domino的用户名,一般是邮件地址@前面的字符password:用户登录邮件服务器的密码;Domino的DIIOP的会话默认是通过63148端口来通信的，所以服务器必须开通63148端口。创建会话流程：从服务器上获取diiop_ior.txt文件；根据diiop_ior.txt文件创建连接。所以，默认开通DIIOP服务器以后还要开通80端口PE才可以直接通过绑定域名或者服务器IP直接进行绑定。如果没有开通80端口则需要在服务器IP后面加上：63148才能访问。41|DigitalHeavenInformation&TechnologyCo.,Ltd.1.3.2打开domino服务器上的用户数据库Domino存放邮件的文件叫做数据库，每一封邮件是一个document。所以收取邮件就要先打开用户的数据库。用户的数据库的名字是用户名.nsf，如有一个用户的邮箱账号是[e-mail]，那么用户的数据库文件就是test.nsf。用户的数据库在没有进行特殊配置的情况下，存放目录是domino安装目录的data文件夹下的mail文件夹中。可以通过刚才打开的会话开启数据库:Databasesession.getDatabase(session.getServerName(),“mail/”+user+.nsf);第一个参数：domino配置的ServerName参数,唯一标识一台domino服务器的参数；第二个参数：用户数据库路径。如果在domino的配置中修改过了用户数据库的存放目录的话,就需要把mail/改成相应目录就可以了。1.3.3取得用户的邮件列表用DIIOP方式获取用户邮件列表首先需要打开需要获取邮件列表的用户视图，如果没有指定的话，默认打开的视图是收件箱视图（即($Inbox)视图）。然后遍历这个视图中的document列表，拼接处邮件的编号列表即UIDLS列表。根据以前开发经验，用DIIOP打开数据库获取列表的方法效率很低。后来采用模拟WEB登陆domino服务器，然后在网页上取得viewEntry，通过取得viewEntry来拼接列表。这样的效率提高了60%~70%左右。1.3.4根据邮件列表逐个收取邮件通过数据库判断邮件列表中的邮件是否已经收取过，如果没有收取过的话，再打开用户数据库，根据邮件的UNID收取邮件和邮件的附件。Documentdoc=dbMail.getDocumentByUNID(unid);