Java玩转LotusDomino之配置篇_by_zhengyun

nullJava玩转LotusDomino 之配置篇Java玩转LotusDomino 之配置篇郑 昀(http://blog.csdn.net/zhengyun_ustc) 2006-07 应用开发部 神州泰岳软件股份有限公司 http://www.ultrapower.com.cnAgendaAgendaDomino Java编程配置 启动DIIOP 拿到diiop_ior.txt 配置Domino服务器参数 DIIOP参数设置 Access Server 参数设置 Programmability Restrictions设置 HTTP设置启动DIIOP – 为什么需要DIIOP？启动DIIOP – 为什么需要DIIOP？Java程序可以使用 CORBA (Command Object Request Broker Architecture) 和 IIOP (Internet Inter-ORB Protocol) 远程与 Lotus Domino 进行通信。 所以，必须设置 Domino 服务器监听 IIOP 请求，这就需要启动DIIOP任务。启动DIIOP – 为什么需要DIIOP？启动DIIOP – 为什么需要DIIOP？这里所说的远程访问由以下两个部分组成： 客户机通过 HTTP 协议获得服务器的初始对象，作为 IOR (Interoperable Object Reference)。 或者客户机直接通过读取本地diiop_ior.txt文件来获取IOR对象。 客户机通过 IIOP 连接进一步获得其他对象。启动DIIOP – Domino R5/R6启动DIIOP – Domino R5/R6Domino R5/R6 Server支持手动启动DIIOP： 关闭DIIOP命令为：tell diiop quit启动DIIOP命令为：load diiop查看当前任务列表命令为：show task启动DIIOP – 自动启动DIIOP启动DIIOP – 自动启动DIIOP由于默认Domino并不启动DIIOP任务，所以我们必须手动调整。请您把DIIOP任务手动添加到Notes.ini文件中的ServerTasks中：1：打开您的Domino服务安装目录，比如c:\Lotus\Domino目录下： 启动DIIOP – 自动启动DIIOP启动DIIOP – 自动启动DIIOP 2：打开notes.ini配置文件，然后找到内容中的 “ServerTasks”行，如下所示： 默认是没有“DIIOP”的。 我们为了使得Lotus Domino服务启动时就能加载DIIOP任务， 必须手动加上DIIOP。保存本文件，退出文件。 重新启动“Lotus Domino Server (LotusDominoData)”服务。AgendaAgendaDomino Java编程配置 启动DIIOP 拿到diiop_ior.txt 配置Domino服务器参数 DIIOP参数设置 Access Server 参数设置 Programmability Restrictions设置 HTTP设置DIIOP_IOR.txt – 为什么需要？DIIOP_IOR.txt – 为什么需要？diiop_ior.txt来自何方？ 在 DIIOP 进程启动时，它在 Domino HTTP 根目录 （Windows 中 Domino 默认的安装目录为 C:\lotus\domino\data\domino\html） 中创建一个名为 diiop_ior.txt 的 IOR对象。 有何用? IOR 是对象的字符串编码，包含对服务器的 CORBA 访问的 识别信息。客户机会将字符串 IOR 解码，并用它来建立远程会话。 具体表现形式是什么? diiop_ior.txt文件内容类似于这样： IOR:01012d032900000049444c3a……blablaDIIOP_IOR.txt –拿到diiop_ior.txtDIIOP_IOR.txt –拿到diiop_ior.txt如何手动获取diiop_ior.txt的保存位置呢？ 对于Domino R6，我们可以在Domino Server启动的控制命令行上输入命令“Tell DIIOP Show Config”，Domino会告诉我们DIIOP一系列参数，请看： DIIOP_IOR.txt–拿到diiop_ior.txtDIIOP_IOR.txt–拿到diiop_ior.txt把diiop_ior.txt放在客户机的硬盘上。这样，Java程序读取该文件内容，即可用createSessionWithIOR来和Domino R5/R6服务器建立Session了。 注：当然这种把diiop_ior.txt放在客户机上只适用于：当前Java程序也属于服务器程序。 远端程序拥有IOR的缺点是：不便于管理。 服务器上的以下任何更改都会使客户机上的 diiop_ior.txt 文件失效： 更改 DIIOP 端口号。 启用或禁用 DIIOP 端口。 更改 TCP/IP 地址。 DIIOP_IOR.txt–没有怎么办?DIIOP_IOR.txt–没有怎么办?客户机拿不到diiop_ior.txt时，只能这么写程序了： 注： 1：不能用 DIIOP 端口获取除 diiop_ior.txt 之外的文本文件。 2：如果通过 Web 服务器端口来获取 IOR，Web 服务器端口，那么必须允许进行匿名访问。在 Domino Directory 的 Server 文档中，转至 Ports 选项卡，然后转至 Web 选项卡。确保 Authentication options 下的 Anonymous 字段被设为 Yes。 3：指定 DIIOP 端口来获取 IOR 的能力是 Domino R6 的新功能。现在就可以使用远程调用，无需允许对 Web 服务器的匿名访问，甚至无需启动 Web 服务器。 或者：AgendaAgendaDomino Java编程配置 启动DIIOP 拿到diiop_ior.txt 配置Domino服务器参数 DIIOP参数设置 Access Server 参数设置 Programmability Restrictions设置 HTTP设置配置参数 – R5和R6有区别配置参数 – R5和R6有区别Java远程访问Domino R6服务器必须配置下面讲述的四个设置，否则会在Domino R6上得到以下错误：配置参数 – R5和R6有区别配置参数 – R5和R6有区别会在Domino R5上得到以下错误：这两个错误都代表“服务器拒绝访问”。 AgendaAgendaDomino Java编程配置 启动DIIOP 拿到diiop_ior.txt 配置Domino服务器参数 DIIOP参数设置 Access Server 参数设置 Programmability Restrictions设置 HTTP设置DIIOP参数配置 – R5DIIOP参数配置 – R5检查 Domino R5的Directory 中 Server 文档。转至 Ports 选项卡，然后转向 Internet Ports 选项卡。查看 IIOP 选项卡，“Authentication options”中的“Name & password”应该是Yes，如下图所示。这些部分有用于指定端口号以及启用/禁用端口的字段。下图显示了 Internet Ports--IIOP 选项卡：DIIOP参数配置 – R5DIIOP参数配置 – R5注意，在Domino R5版本中，修改并保存IIOP设置后，应该重新启动Domino Server，否则无法生效。即使命令tell diiop refresh强制刷新，也不能使修改生效。 DIIOP参数配置 – R6DIIOP参数配置 – R6检查 Domino R6的Directory 中 Server 文档。转至 Ports 选项卡，然后转向 Internet Ports 选项卡。查看 DIIOP 选项卡，“Authentication options”中的“Name & password”应该是Yes，如下图所示：DIIOP参数配置 – R6DIIOP参数配置 – R6在Domino R6版本中，改进了这一功能，不需要重启服务器也不需要强制刷新，即可使这项IIOP设置修改生效！ 上图中各项参数的具体含义是：AgendaAgendaDomino Java编程配置 启动DIIOP 拿到diiop_ior.txt 配置Domino服务器参数 DIIOP参数设置 Access Server 参数设置 Programmability Restrictions设置 HTTP设置AccessServer参数 – R5AccessServer参数 – R5检查 Domino R5的Directory 中 Server 文档。转至 ”安全性” 选项卡，然后查看 “服务器访问权限”中的“访问服务器”应该是空白的，这就代表“All users can access this server”，如下图所示。 AccessServer参数 – R6AccessServer参数 – R6检查 Domino R6的Directory 中 Server 文档。转至 Security 选项卡，然后查看 “Server Access”中的“Access Server”应该是“All users can access this server”，如下图所示。 AgendaAgendaDomino Java编程配置 启动DIIOP 拿到diiop_ior.txt 配置Domino服务器参数 DIIOP参数设置 Access Server 参数设置 Programmability Restrictions设置 HTTP设置Programmability Restrictions参数设置-R5Programmability Restrictions参数设置-R5检查 Domino R5的Directory 中 Server 文档。转至“安全性”选项卡，然后查看 “IIOP限制” 。 请找到以下2个设置： Run restricted Java/Javascript/COM: Run unrestricted Java/Javascript/COM:  请您为这些设置输入“*”，表示允许所有用户。 作了修改之后，保存并退出。 然后还需要在服务器命令行界面上输入命令“tell diiop refresh”，强制diiop刷新策略，否则无法生效。Programmability Restrictions参数设置-R5Programmability Restrictions参数设置-R5最终的效果应该如下图所示： Programmability Restrictions参数设置-R6Programmability Restrictions参数设置-R6检查 Domino R6的Directory 中 Server 文档。转至 Security 选项卡，然后查看 “Programmability  Restrictions” 。 请找到以下1个设置： Run restricted Java/Javascript/COM: 请您为这个设置输入“*”，表示允许所有用户。 作了修改之后，保存并退出。 注：在Domino R6版本中，修改并保存了这一设置之后，并不需要强制刷新，即可使这项编程限制设置修改立即生效！ Programmability Restrictions参数设置-R6Programmability Restrictions参数设置-R6最终的效果应该如下图所示： Programmability Restrictions参数设置-否则?Programmability Restrictions参数设置-否则?如果在R6上，没有允许用户“Run unrestricted methods and operations”，那么当用户发送邮件要Sign时可能会遇到如下异常： AgendaAgendaDomino Java编程配置 启动DIIOP 拿到diiop_ior.txt 配置Domino服务器参数 DIIOP参数设置 Access Server 参数设置 Programmability Restrictions设置 HTTP设置HTTP参数设置HTTP参数设置检查 Domino Directory 中 Server 文档。转至 Internet Protocols 选项卡，然后查看 HTTP 选项卡，找到“Allow HTTP clients to browse databases:”(或者为“允许HTTP客户浏览数据库”)设置。 HTTP参数设置 – R5HTTP参数设置 – R5安装R5时，默认这个设置是No(否)，所以请实施工程师设置它为Yes(是)。 HTTP参数设置 – R6HTTP参数设置 – R6请实施工程师确认这个设置是否为Yes(是)。 小结小结按照上述步骤实施，Java程序就可以远程访问Domino R5/R6服务器，可以登录，读取邮件，发送邮件，转发、回复邮件等等。我们为客户交付IT运营能力 我们为客户交付IT运营能力