上一页    目录    索引    下一页
iPlanet Messaging Server 5.2 管理员指南

附录 C 在 iPlanet Messaging Server 中管理 Event Notification Service


本附录说明如何在 iPlanet Messaging Server 中启用 iPlanet Event Notification Service Publisher 程序（ENS Publisher）并管理 iPlanet Event Notification Service（ENS）。

本章/附录包括下列各节：

• 将 ENS Publisher 载入 iPlanet Messaging Server

• 运行样板 Event Notification Service 程序

• 管理 Event Notification Service

有关 ENS 和 ENS API 的详细说明，请见位于 iPlanet Calendar Server 和 Messaging Server Documentation 网页的 iPlanet Messaging and Collaboration Event Service Notification Manual。

将 ENS Publisher 载入 iPlanet Messaging Server

---

Event Notification Service (ENS) 是 iPlanet 的基础“发布-订阅服务”。ENS 起着调度程序的作用，iPlanet 的应用程序把它当作收集某种相关事件的中心点。所谓“事件”是指资源的一个或多个属性的值所发生的变化。任何应用程序，如果需了解这些事件发生的时间，可在 ENS 注册，由其识别事件的顺序并将通知与订阅匹配起来。

ENS 和 iBiff（iPlanet Messaging Server 的 ENS 发布程序）是与 iPlanet Messaging Server 捆绑提供的软件。系统的默认设置是启用 ENS，但并不载入 iBIFF。（请参阅“将 ENS Publisher 载入 iPlanet Messaging Server”）。

若需订阅 iPlanet Messaging Server 的通知服务，您需先在 iPlanet Messaging Server 主机上载入 libibiff 文件，然后停机并重新启动 Messaging Server。

将 ENS Publisher 载入 iPlanet Messaging Server

请从命令行执行下列步骤。在这些操作步骤，iPlanet Messaging Server 安装目录的位置是 server_root，iPlanet Messaging Server 用户是 mailsrv。这些变量的典型值分别为 /usr/iplanet/server5 和 mailsrv。

1. 先以 mailsrv 运行 configutil 实用程序，以载入 libibiff 文件。

   cd server_root/msg-instance

   ./configutil -o "local.store.notifyplugin" -v "server_root/bin/msg/lib/libibiff"

2. 然后以 root 停机并重新启动 Messaging Server。

   cd server_root/msg-instance

   ./stop-msg

   ./start-msg

3. 此后，您便可通过 ENS 接收通知了。有关详细说明，请见“运行样板 Event Notification Service 程序”。

运行样板 Event Notification Service 程序

---

iPlanet Messaging Server 提供了一写样板程序，供您学习使用如何接收通知。这些样板程序位于 server_root/bin/msg/enssdk/examples 目录。

运行 ENS 样板程序

1. 换到 server_root/bin/msg/enssdk/examples 目录。

2. 用 C 编译器，通过 Makefile.sample 文件编译 apub 和 asub 范例。将程序库搜索路径设置为包括 server_root/bin/msg/lib 目录。

3. 待程序编译后，便可在分开的窗口中按下列运行之：

   apub localhost 7997

   asub localhost 7997

   您在 apub 窗口中键入的任何内容都应在 asub 窗口中显示。另外，如果使用的默认设置，则所有 iBiff 通知都应在 asub 窗口中显示。

4. 若需接收 iBiff 发布的通知，可编写一个类似 asub.c 的程序。

   有关样板程序和编写自用的 ENS 程序方面的详细说明，请参见 iPlanet Event Notification Service for Messaging and Collaboration Manual。

   
   

   ---

   备注：	当把程序库搜索路径设置为包括 server_root/bin/msg/lib 目录时，您将不再能停止和启动目录服务器。迂回方法是从程序库搜索路径中移除该条目。

   ---

   
   

管理 Event Notification Service

---

ENS 的管理工作包括：启动和停止服务以及更改配置参数以控制 ENS 的 iBiff 出版程序的行为。

启动和停止 ENS

您可通过 start-msg ens 和 stop-message ens 命令启动和停止 ENS 服务器。但必须以 root 用户身份运行这些命令。

启动和停止 ENS

• 启动 ENS：

  server_root/msg-instance/start-msg ens

• 停止 ENS：

  server_root/msg-instance/stop-msg ens

iPlanet Event Notification Service 配置参数

可控制 iBiff 行为的配置参数有下列几个。请用 configutil 实用程序设置这些参数。

表 C-1 iBiff 配置参数  

参数	说明
local.store.notifyplugin.maxHeaderSize	用于指定可与通知一起传输的报头的最大大小（以字节为计算单位）。默认值为 8192 个字节。
local.store.notifyplugin.maxBodySize	用于指定可与通知一起传输的正文部分的最大大小（以字节为计算单位）。默认值为 100 个字节。
local.store.notifyplugin.eventType.enable	用于指定特定的事件类型是否可生成通知。详情请见 iPlanet Messaging Server for Messaging and Collaboration Manual 中说明的各种 eventTypes （事件类型），如 ReadMsg、NewMsg 等。有效值为 1（启用）和 0（禁用）。默认值是 1；即若将 local.store.notifyplugin.ReadMsg.enable 设置为 0 将禁用 ReadMsg 通知功能。
local.store.notifyplugin.ensHost	用于指定 ENS 服务器的主机名。默认设置是 127.0.0.1。
local.store.notifyplugin.ensPort	用于指定 ENS 服务器的 TCP 端口。默认值为  7997。
local.store.notifyplugin.ensEventKey	用于指定使用 ENS 通知所需的事件密钥。默认设置是 enp://127.0.0.1/store。该事件密钥的主机名部分不是用来确定 ENS 主机的。这只是 ENS 使用的一个独特的标识符。 该密钥是用户在订阅时应使用的密钥，以便能够接收与此密钥相匹配的有关通知。

上一页    目录    索引    下一页

---

(c) 2002 年 Sun Microsystems, Inc. 版权所有。

更新日期：2002 年 2 月 27 日