Sun Java logo     上一個      目錄      索引      下一個     

Sun logo
Sun Java System Messaging Server 6 2005Q1 管理指南 

附錄 B
管理 Messaging Server 中的事件通知服務

本附錄描述如何啟用事件通知服務發佈程式 (ENS 發佈程式) 以及在 Messaging Server 中管理事件通知服務 (ENS)。

本章/附錄包含以下各節:

如需有關 ENS 和 ENS API 的更多資訊,請參閱「 Sun Java System Calendar」 Server (http://docs.sun.com/db/coll/CalendarServer_05q1http://docs.sun.com/db/coll/CalendarServer_05q1_zh_TW) 和 Messaging Server 文件網頁 (http://docs.sun.com/db/coll/MessagingServer_05q1http://docs.sun.com/db/coll/MessagingServer_05q1_zh_TW) 上的Sun Java System Communications Services 的事件服務通知手冊。


在 Messaging Server 中載入 ENS 發佈程式

事件通知服務 (ENS) 是基本的發佈和訂閱服務。ENS 起到派送程式的作用,Sun Java System 應用程式使用它作為收集其感興趣的某些類型的事件的中心點。事件是資源的一個或多個屬性值的變更。任何想瞭解何時發生這些類型的事件的應用程式均可註冊 ENS,ENS 可按次序識別事件並使通知與訂閱相匹配。

ENS 和 iBiff (Messaging Server 的 ENS 發佈程式) 從 Messaging Server 開始綁定在一起。依預設,ENS 為啟用狀態,但未載入 iBIFF。(請參閱「在 Messaging Server 上載入 ENS 發佈程式」。)

若要在 Messaging Server 中訂閱通知,您需要在 Messaging Server 主機上載入 libibiff 檔案,然後停止並重新啟動郵件傳送伺服器。

在 Messaging Server 上載入 ENS 發佈程式

從指令行執行以下步驟。在這些步驟中,假定 Messaging Server 安裝目錄的位置是 msg_svr_base,Messaging Server 使用者是 inetuser。這些變數的典型值分別是 /opt/SUNWmsgsrinetuser

  1. 若為 inetuser,請執行 configutil 公用程式以載入 libibiff 檔案。
  2. cd msg_svr_base

                       ./configutil -o "local.store.notifyplugin" -v "msg_svr_base/lib/libibiff"

  3. 若為 root,請停止然後重新啟動郵件傳送伺服器。
  4. cd msg_svr_base/sbin

    ./stop-msg

    ./start-msg

  5. 現在,您便可以透過 ENS 接收通知。請參閱「執行範例事件通知服務程式」,以取得更多資訊。


執行範例事件通知服務程式

Messaging Server 包含範例程式,以幫助您瞭解接收通知的方法。這些範例程式位於 msg_svr_base/examples 目錄中。

執行範例 ENS 程式

  1. 轉到 msg_svr_base/examples 目錄。
  2. 使用 C 編譯器,編譯使用 Makefile.sample 檔案的 apubasub 範例。設定程式庫搜尋路徑以包含 msg_svr_base/examples 目錄。
  3. 程式編譯完成後,您可以按以下方法在單獨視窗中執行它們:
  4. apub localhost 7997

    asub localhost 7997

    apub 視窗中鍵入的任何內容均應顯示在 asub 視窗中。此外,如果您使用預設設定,則所有 iBiff 通知應顯示在 asub 視窗中。

  5. 若要接收 iBiff 發佈的通知,請寫入一個與 asub.c 類似的程式
  6. 如需有關範例程式以及為 ENS 寫入自己的程式之更多資訊,請參閱「iPlanet 事件通知服務 for Messaging and Collaboration Manual」。


    注意

    將程式庫搜尋路徑設定為包含 msg_svr_base/lib 目錄後,您便無法停止和啟動目錄伺服器。解決方法是將項目從程式庫搜尋路徑中移除。



管理 事件通知服務

管理 ENS 包括啟動和停止服務,以及變更配置參數以控制 ENS 的 iBiff 發佈程式的運作方式。

啟動和停止 ENS

您可以使用 start-msg ensstop-message ens 指令來啟動和停止 ENS 伺服器。您必須是 root 才可以執行這些指令。

啟動和停止 ENS

iPlanet 事件通知服務配置參數

有數個配置參數可以控制 iBiff 的運作方式。您可以使用 configutil 公用程式來設定這些參數。

表 B-1  iBiff 配置參數  

參數

描述

local.store.notifyplugin.maxHeaderSize

指定將與通知一起傳輸的標頭之最大大小 (以位元組為單位)。預設為 0 位元組。

local.store.notifyplugin.maxBodySize

指定將與通知一起傳輸的內文之最大大小 (以位元組為單位)。預設為 0 位元組。

local.store.notifyplugin.eventType.enable

指定給定事件類型是否將產生通知。請參閱「Messaging Server for Messaging and Collaboration Manual」,以取得各種 eventTypes,如 ReadMsgNewMsg 等。合法值是 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 使用的唯一識別碼。

訂閱者應訂閱此金鑰,以便收到匹配該金鑰的事件通知。



上一個      目錄      索引      下一個     


Copyright 2005 Sun Microsystems, Inc. 版權所有。