Sun Java System Instant Messaging 7 2005Q1 管理指南 |
第 7 章
管理 Instant Messaging 歸檔本章會解釋如何管理與配置 Instant Messaging 歸檔。
本章包含下列章節:
Instant Messaging 歸檔摘要Instant Messaging 歸檔抓取立即訊息並把這些訊息歸檔在 Portal Server 搜尋資料庫中。它能讓一般使用者在 Portal Server 桌面使用 [搜尋] 頁面,查詢並擷取這些歸檔訊息。
Instant Messaging 歸檔包含下列元件:
歸檔和擷取元件。Portal Server 搜尋元件 (也稱為歸檔和擷取元件) 用於儲存已歸檔的即時訊息。Instant Messaging 歸檔資料會做成索引並可以指派給不同種類,並儲存在 Portal Server 搜尋資料庫。例如,警示訊息會儲存在「警示」種類下。
Instant Messaging 歸檔搜尋或顯示 Servlet。當一般使用者執行符合某個準則的文件搜尋作業時,Portal Server 搜尋會獲得符合此準則的頁面。這些頁面可能是遠端網頁,或是 Instant Messaging 歸檔資料,也稱為 Instant Messaging 資源描述元。
若一般使用者按一下 Instant Messaging 資源描述元的 URL 以檢視歸檔資料,會呼叫 Instant Messaging 歸檔搜尋或顯示 servlet。Instant Messaging 歸檔搜尋 servlet 從 Portal Server 搜尋資料庫擷取資料,並產生含有 Instant Messaging 歸檔資料的文字或 HTML 回應。
Instant Messaging 歸檔提供者。每次要歸檔即時訊息時,Instant Messaging 伺服器均會啟動此元件。Instant Messaging 歸檔提供者建立與「資源描述元」(RD) (以 Instant Messaging 伺服器所提供的資料為基礎) 相容的「摘要物件交換格式」(SOIF)。它使用 Portal Server 搜尋 API 以傳送這些「資料描述元」給 Portal Server 搜尋資料庫。它也可以維持要提交給 Portal Server 搜尋資料庫之記錄的緩衝區,以減少效能碰撞。
Instant Messenger 歸檔控制。Instant Messaging 資料可以自動歸檔而不需與一般使用者有任何互動。要控制歸檔功能,一般使用者必須啟動 Instant Messenger 歸檔控制元件。此元件允許一般使用者設定預設的歸檔選項,例如「歸檔所有會議」,並且依據每個事務處理變更該預設值。例如,一般使用者可以選擇不歸檔會議的內容。
圖 7-1 說明 Instant Messaging 歸檔元件。
圖 7-1 Instant Messaging 歸檔元件
歸檔即時訊息所有的即時訊息會依歸檔目的分成下列幾個種類:
聊天。在私人會議室內的所有訊息。
會議。在公共會議室內的所有訊息。
警示。此種類包含所有的警示訊息。
輪詢。此種類包含所有的輪詢訊息。
新聞。此種類包含張貼在新聞通道的所有訊息。
Instant Messaging 歸檔提供者的功能如下:
啟用歸檔提供者在 Instant Messaging 中啟用歸檔提供者:
- 變更至 config 目錄。例如在 Solaris 上:
cd /etc/opt/SUNWiim/default/config
- 開啟 iim.conf 檔案。
例如:
vi iim.conf
- 在 iim.conf 檔案中加入下列行:
在預設的歸檔提供者下,加入下列行:
iim_server.msg_archive = true
在自訂的歸檔提供者下,加入下列行:
iim_server.msg_archive.provider = provider_name
要使用以歸檔為基礎的 Portal Server 搜尋,請以下列文字取代 provider_ name:
com.iplanet.im.server.IMPSArchive
- 儲存檔案。
- 更新 Instant Messaging 伺服器配置。若要更新類型:
imadmin refresh
Instant Messaging 伺服器提供 API 和 SPI 以用於寫入自訂歸檔提供者。如需關於 Instant Messaging API 的詳細資訊,請參閱 Instant Messaging API。
配置歸檔提供者歸檔提供者在 Portal Server 搜尋資料庫中儲存已歸檔的訊息作為資源描述元 (RD)。歸檔提供者會使用 Portal Server 搜尋模式中的下列欄位:
標題。此欄位包含「會議」種類中公開會議室的名稱、在「聊天」種類中聊天階段作業的參加者名稱、「警示」訊息的主旨以及警示種類與新聞種類的「新聞通道」名稱。標題欄位包含所有輪詢種類的 "Poll from Sender",其中 Sender 代表輪詢中寄件者的顯示名稱。
關鍵字。在會議和聊天種類中,此欄位會包含在會議室內所有參加者的清單。在公開的會議室中,此欄位也會包含會議室的名稱。在「警示」種類中,此欄位會包含寄件者和收件者的名稱。在「新聞」種類中,此欄位包含通道的名稱。在「輪詢」種類中,此欄位包含寄件者和收件者的名稱。在所有的種類中,除了上述值之外,此欄位也會包含該種類唯一的 ID。
表 7-1 顯示其唯一的 ID 並提供在歸檔提供者中每個種類的說明。
ReadACL。在「會議」和「新聞」種類中,此欄位的值在於各自會議室和新聞通道的存取控制檔。在「聊天」種類中,此欄位包含參加者的 DN。在「警示」種類中,此欄位包含寄件者的 DN 和收件者的 DN。在「輪詢」種類中,歸檔者將會提供新的存取控制檔案。
RD 的搜尋存取是由 ReadACL 欄位中的值所控制。如果啟動了文件層次安全性,僅在 ReadALC 欄位中有該一般使用者的 DN,它才能夠存取搜尋結果。如果啟動了聊天訊息的 Instant Messenger 歸檔控制,則新增到 ReadACL 欄位的一般使用者 DN 取決於一般使用者的選擇。
說明。此欄位包含沒有 HTML 格式化的已歸檔訊息。
完整文字。此欄位包含已經 HTML 格式化的已歸檔訊息。
分類。此欄位包含已歸檔訊息的類別。
歸檔提供者配置參數
表 7-2 列出並說明會新增到 iim.conf 檔案中的歸檔提供者配置參數:
在非預設的 Portal Server 搜尋資料庫中儲存已歸檔訊息
若要在非預設的資料庫中儲存已歸檔訊息
- 修改 iim.conf 檔案。
- 修改 Portal Server 搜尋通道。
變更 Portal Server 搜尋通道以新增搜尋選項,以便在另一個資料庫中搜尋資料。如需更多資訊,請參閱「Sun Java System Portal Server Desktop Customization Guide」。
- 修改 IMArchiveDisplay.jsp 檔:
- 變更以下目錄:
/etc/opt/SUNWps/desktop/default_zh_TW/IMProvider/
- 建立 IMArchiveDisplay.jsp 檔的備份檔案。
- 使用您選擇的編輯器編輯 IMArchiveDisplay.jsp 檔案。例如,您可以輸入以下內容:
vi IMArchiveDisplay.jsp
- 在 IMArchiveDisplay.jsp 檔案中搜尋並找到下列兩行指令碼:
程式碼範例 7-1 在編輯前,從 IMArchiveDisplay.jsp 中搜尋指令碼
<search:setQuery query = "<%= scope %>"/>
<search:setRDMType rdmType = "rd-request"/>
- 在此兩行指令碼之間會以程式碼範例 7-1 顯示,新增下列指令碼:
<search:setDatabase database = "database-name"/>
在您新增此列指令碼之後,此指令碼看起來應該為程式碼範例 7-2:
程式碼範例 7-2 在編輯後,從 IMArchiveDisplay.jsp 中搜尋指令碼
<search:setQuery query = "<%= scope %>"/>
<search:setDatabase database = "database-name"/>
<search:setRDMType rdmType = "rd-request"/>
其中 database-name 是非預設資料庫的名稱。
管理 Portal Server 搜尋資料庫中的已歸檔資料
Instant Messaging 資料會在 Portal Server 搜尋資料庫中,以資源描述元 (RD) 的形式歸檔。在 Portal Server 搜尋資料庫中的單個項目稱作資源描述元 (RD)。一個資源描述元即為某一資源的一段特定資訊。每個資源描述元的欄位由 Portal Server 搜尋資料庫模式所決定。
若要管理已歸檔的資料,您必須在 Portal Server 搜尋資料庫中管理資源描述元 (RD)。本節解釋在 Portal Server 搜尋資料庫上一些經常執行的維護工作。
如需關於在 Portal Server 搜尋資料庫中管理資料的更多資訊,請參閱「Sun Java System Portal Server 管理指南」。
rdmgr 指令
rdmgr 指令是用於和「搜尋」服務一同作業的主要指令。它提供管理員兩種子指令類型:一種用於和資源描述元 (RD) 一同作業;而另一種用於資料庫維護。rdmgr 指令一般在啟用搜尋的 Portal Server 實例目錄中執行。
若要呼叫 rdmgr 指令
如需關於 rdmgr 指令的更多資訊,請參閱「Sun Java System Portal Server 管理指南」中的「指令行公用程式」。
搜尋資源描述元
以引數值 -Q 執行 rdmgr 指令會產生重新修改搜尋作業的資源描述元 (RD) 清單。
例如:
刪除資源描述元
下列是從 Portal Server 搜尋資料庫中刪除資源描述元 (RD) 的範例:
若要刪除含有文字 testing 的所有資源描述元 (RD),請鍵入:
run-cs-cli portal-server-install-dir/SUNWps/bin/rdmgr -d -Q testing
若要從種類 Archive:Chat:January 中刪除所有資源描述元 (RD),請鍵入:
啟用 Instant Messenger 歸檔控制Instant Messenger 歸檔控制元件能讓一般使用者控制已歸檔的即時訊息。此元件允許一般使用者在 Instant Messenger 主要視窗中按一下 [歸檔] 按鈕,以搜尋儲存在 Portal Server 搜尋資料庫中已歸檔的即時訊息。它也讓一般使用者設定預設歸檔選項,例如 Instant Messenger 中 [歸檔] 標籤的 [歸檔所有會議]。Instant Messenger 歸檔控制功能是由兩個選用的 Instant Messenger 模組所提供。
可以在 applet 描述元檔案中設定 archive_control applet 參數以啟動 Instant Messenger 歸檔控制元件。
需要變更的 Instant Messaging LDAP 部署的 applet 描述元檔案為:
變更 JNLP 檔案和 jnlpLaunch.jsp 檔案:
如果您正使用 Java Web Start 以啟用 Instant Messenger,請執行下列步驟以啟用 Instant Messenger 中的 Instant Messenger歸檔控制功能:
變更 html applet 頁面和 pluginLaunch.jsp 檔:
如果您正使用 Java 外掛程式以啟用 Instant Messenger,請執行下列步驟以啟用 Instant Messenger 中的歸檔控制功能:
變更已歸檔資料的顯示歸檔的資料是使用 IMArchiveDisplay.jsp 檔來部署。在預設情況下,IMArchiveDisplay.jsp 檔案安裝在 /etc/opt/SUNWps/desktop/default_TW/IMProvider 資料夾中。可以修改檔案以變更已歸檔資料的樣式和資源字串。
例如,當一般使用者參加聊天室時,若要將顯示的預設系統訊息從 "joe has joined the room" 變更為 "joe has entered the room",請執行下列動作:
您也可以採用類似的方法,修改顯示金鑰資訊之其他金鑰和樣式的資源字串。
如果在 Portal Server 搜尋預設模式中「標題」與「完整文字」的屬性名稱改變,此變更也會反應到 IMArchiveDisplay.jsp 檔案中。
歸檔提供者的範本部署方案此範本部署方案解釋如何同時歸檔相關 Instant Messaging 資料的方法。
整體而言,若要同時歸檔相關的 Instant Messaging 資料:
為每種資料類型建立個別的種類。例如,在歸檔所有 Instant Messaging 資料的「歸檔」種類,建立一個「聊天」子種類以儲存聊天訊息。您也可以依照時間建立歸檔資料的子種類。例如,若要歸檔 2002 年 12 月的聊天資料,則子種類會是:
Archive:Chat:2002:12
若要依照時間歸檔所有聊天資料
若要將 2002 年 12 月的聊天資料歸檔並備份至子種類
若要從 Portal Server 搜尋資料庫中移除 2002 年 12 月的已歸檔聊天資料