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

Sun logo
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 歸檔元件

本圖說明 Sun Java System Instant Messaging 歸檔元件和資料傳輸。


歸檔即時訊息

所有的即時訊息會依歸檔目的分成下列幾個種類:

聊天。在私人會議室內的所有訊息。

會議。在公共會議室內的所有訊息。

警示。此種類包含所有的警示訊息。

輪詢。此種類包含所有的輪詢訊息。

新聞。此種類包含張貼在新聞通道的所有訊息。

Instant Messaging 歸檔提供者的功能如下:


啟用歸檔提供者

    在 Instant Messaging 中啟用歸檔提供者:
  1. 變更至 config 目錄。例如在 Solaris 上:
  2. cd /etc/opt/SUNWiim/default/config

  3. 開啟 iim.conf 檔案。
  4. 例如:

    vi iim.conf

  5. iim.conf 檔案中加入下列行:
  6. 在預設的歸檔提供者下,加入下列行:

    iim_server.msg_archive = true

    在自訂的歸檔提供者下,加入下列行:

    iim_server.msg_archive.provider = provider_name

    要使用以歸檔為基礎的 Portal Server 搜尋,請以下列文字取代 provider_ name

    com.iplanet.im.server.IMPSArchive

  7. 儲存檔案。
  8. 更新 Instant Messaging 伺服器配置。若要更新類型:
  9. 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 並提供在歸檔提供者中每個種類的說明。

表 7-1  每個種類的唯一 ID 及其說明

種類

唯一 ID

會議

聊天室

RoomName-StartTime

其中:

RoomName - 公開或私人會議室的名稱

StartTime - 是建立 RD 的時間戳記

警示

Alert-messageID

其中:

messageID - 將會被歸檔之訊息的訊息 ID。當 RD 僅包含一則訊息時,訊息 Id 有其重要性。例如,「新聞」訊息和「警示」訊息。

輪詢

Poll-pollID

新聞

TopicName-messageID

ReadACL在「會議」和「新聞」種類中,此欄位的值在於各自會議室和新聞通道的存取控制檔。在「聊天」種類中,此欄位包含參加者的 DN。在「警示」種類中,此欄位包含寄件者的 DN 和收件者的 DN。在「輪詢」種類中,歸檔者將會提供新的存取控制檔案。

RD 的搜尋存取是由 ReadACL 欄位中的值所控制。如果啟動了文件層次安全性,僅在 ReadALC 欄位中有該一般使用者的 DN,它才能夠存取搜尋結果。如果啟動了聊天訊息的 Instant Messenger 歸檔控制,則新增到 ReadACL 欄位的一般使用者 DN 取決於一般使用者的選擇。

說明此欄位包含沒有 HTML 格式化的已歸檔訊息。

完整文字。此欄位包含已經 HTML 格式化的已歸檔訊息。

分類。此欄位包含已歸檔訊息的類別。

歸檔提供者配置參數

表 7-2 列出並說明會新增到 iim.conf 檔案中的歸檔提供者配置參數:

表 7-2  iim.conf 的可用歸檔提供者參數 

參數

預設值

說明

iim_arch.title.attr

Title

此參數包含等同於 Portal Server 搜尋之預設模式中 Title 欄位的欄位名稱。

iim_arch.keyword.attr

Keyword

此參數包含等同於 Portal Server 搜尋之預設模式中 Keyword 欄位的欄位名稱。

iim_arch.readacl.attr

ReadACL

此參數包含等同於 Portal Server 搜尋之預設模式中 ReadACL 欄位的欄位名稱。

iim_arch.description.attr

說明

此參數包含等同於 Portal Server 搜尋之預設模式中 Description 欄位的欄位名稱。

iim_arch.fulltext.attr

Full-Text

此參數包含等同於 Portal Server 搜尋之預設模式中 Full-text 欄位的欄位名稱。

iim_arch.category.attr

Category

此參數包含等同於 Portal Server 搜尋之預設模式中 Category 欄位的欄位名稱。

iim_arch.readacl.admin

此參數包含管理員的 DN。應由 ";" 分隔多個值

iim_arch.readacl.adminonly

false

此參數會包含 truefalse

true - 僅由參數 iim_arch.readacl.admin 所指定之管理員的 DN 會新增到 ReadACL 欄位,並覆寫 ReadACL 欄位中的預設行為。

false - 由參數 iim_arch.readacl.admin 所指定之管理員的 DN 會新增到 ReadACL 欄位以及預設行為。

iim_arch.categories

all

此參數包含可以歸檔的訊息類型清單。

其值可能是:

輪詢

警示

聊天

會議

新聞

可以指定由逗號 (",") 分隔多個值。

iim_arch.categoryname

如果沒有指定種類名稱給任何種類,則會使用此參數值作為種類名稱。

iim_arch.alert.categoryname

此參數包含含有已歸檔之警示訊息的種類名稱。

備註:不需要指定一個種類給警示訊息。

iim_arch.poll.categoryname

此參數包含含有已歸檔之輪詢訊息的種類名稱。

備註:不需要指定一個種類給輪詢訊息。

iim_arch.conference.categoryname

此參數包含含有已歸檔之會議訊息的種類名稱。

備註:不需要指定一個種類給會議訊息。

iim_arch.chat.categoryname

名稱

此參數包含含有已歸檔之聊天訊息的種類名稱。

備註:不需要指定一個種類給聊天訊息。

iim_arch.news.categoryname

此參數包含含有已歸檔之新聞訊息的種類名稱。

備註:不需要指定一個種類給新聞訊息。

iim_arch.conference.quiettime

5

此參數包含在一個房間中 (公開和私人),在舊的 RD 到期而新的 RD 建立以歸檔訊息後,兩個連續訊息間無交談的最長持續時間。此值以分鐘為單位。

iim_arch.poll.maxwaittime

15

此參數包含輪詢資料在伺服器中緩衝的 (最長) 時間。此值以分鐘為單位。

iim_arch.ignoreexplicitdeny

true

此參數會包含 truefalse

true - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取的資料。每次當不會歸檔這些訊息時,會將此資訊記錄到 xmppd.log 檔案中。

false - 在「輪詢」和「會議」類型中,將不會歸檔含有明確拒絕存取的資料,且會新增此訊息到 Portal Server 搜尋資料庫中。

備註:如果您不想明確地拒絕存取到一個會議室或一個新聞通道,則預設的存取是 READ 或 WRITE 或 MANAGE。您可以給予某些一般使用者 NONE 的存取。

iim_arch.portal.search

此參數的值應為 Portal Server 搜尋 servlet 的 URL。例如:http://www.example.com/portal/search

如果此參數不存在,則「歸檔提供者」會依照存在於系統上的 AMConfig.properties 檔案,以決定 Portal Server 搜尋 URL 的值。

iim_arch.portal.admindn

此參數的值應為管理使用者的 DN。例如:uid=amadmin,ou=People,o=internet

在 Portal Search Server 中的「文件層次安全性」為開啟時,就需要此參數。

iim_arch.portal.adminpassword

此參數的值應該為管理使用者的密碼 (由 iim_arch.portal.admindn 參數指定)。

在 Portal Search Server 中的「文件層次安全性」為開啟時,就需要此參數。

iim_arch.portal.search.database

此參數的值應為 Instant Messaging 伺服器儲存已歸檔訊息之資料庫的名稱。如果未定義此參數,則所有的訊息會儲存在 Sun Java System Portal Server 搜尋的預設資料庫中。

在非預設的 Portal Server 搜尋資料庫中儲存已歸檔訊息

    若要在非預設的資料庫中儲存已歸檔訊息
  1. 修改 iim.conf 檔案。
    1. 變更至 config 目錄。例如在 Solaris 上:
    2. cd /etc/opt/SUNWiim/default/config

    3. 使用您選定的編輯程式,開啟 iim.conf 檔。
    4. 例如,您可以輸入:

      vi iim.conf

    5. 在預設的歸檔提供者下,加入下列行:
    6. iim_arch.portal.search.database = database-name

      其中 database-name 是非預設資料庫的名稱。

    7. 儲存檔案。
  2. 修改 Portal Server 搜尋通道。
  3. 變更 Portal Server 搜尋通道以新增搜尋選項,以便在另一個資料庫中搜尋資料。如需更多資訊,請參閱「Sun Java System Portal Server Desktop Customization Guide」。

  4. 修改 IMArchiveDisplay.jsp 檔:
    1. 變更以下目錄:
    2. /etc/opt/SUNWps/desktop/default_zh_TW/IMProvider/

    3. 建立 IMArchiveDisplay.jsp 檔的備份檔案。
    4. 使用您選擇的編輯器編輯 IMArchiveDisplay.jsp 檔案。例如,您可以輸入以下內容:
    5. vi IMArchiveDisplay.jsp

    6. IMArchiveDisplay.jsp 檔案中搜尋並找到下列兩行指令碼:
    7. 程式碼範例 7-1  在編輯前,從 IMArchiveDisplay.jsp 中搜尋指令碼

      <search:setQuery query = "<%= scope %>"/>

      <search:setRDMType rdmType = "rd-request"/>

    8. 在此兩行指令碼之間會以程式碼範例 7-1 顯示,新增下列指令碼:
    9. <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 搜尋資料庫中的已歸檔資料


備註

這些為 Solaris 特定的說明。       


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 指令
  1. 變更以下目錄:
  2. cd /var/opt/SUNWps/https-servername/

  3. 在指令行中鍵入:
  4. run-cs-cli portal-server-install-dir/SUNWps/bin/rdmgr args

    其中 portal-server-install-dir 表示 Portal Server 的安裝目錄。

如需關於 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),請鍵入:

run-cs-cli portal-server-install-dir/SUNWps/bin/rdmgr -d -Q "classification=Archive:Chat:January"


啟用 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歸檔控制功能:

  1. 轉到 Instant Messenger 文件根目錄找到 im.jnlpimssl.jnlp 檔案
  2. jnlpLaunch.jsp 檔案可在下列位置中找到:

    /etc/opt/SUNWps/desktop/default_TW/IMProvider

  3. 編輯 jnlp jsp 檔案,並且新增或編輯下列行:
  4. <argument>archive_control=true</argument>

變更 html applet 頁面和 pluginLaunch.jsp 檔:

如果您正使用 Java 外掛程式以啟用 Instant Messenger,請執行下列步驟以啟用 Instant Messenger 中的歸檔控制功能:

  1. 轉到 Messenger 文件根目錄找到 im.jnlpimssl.jnlp 檔案
  2. jnlpLaunch.jsp 檔案可在下列位置中找到:

    /etc/opt/SUNWps/desktop/default_TW/IMProvider

  3. 編輯 jnlp jsp 檔案,並且新增或編輯下列行:

    <PARAM NAME="archive_control" VALUE="true" />

    <EMBED archive_control=true;/>


  4. 備註   

    如果 Instant Messaging Server 的 iim.conf 檔案中 iim_server.msg_archive.auto 的值設定為 true,則 Instant Messenger 歸檔控制應該無法啟動,因為一般使用者的 Messenger 設定將無法生效。



變更已歸檔資料的顯示

歸檔的資料是使用 IMArchiveDisplay.jsp 檔來部署。在預設情況下,IMArchiveDisplay.jsp 檔案安裝在 /etc/opt/SUNWps/desktop/default_TW/IMProvider 資料夾中。可以修改檔案以變更已歸檔資料的樣式和資源字串。

例如,當一般使用者參加聊天室時,若要將顯示的預設系統訊息從 "joe has joined the room" 變更為 "joe has entered the room",請執行下列動作:

  1. 使用您選擇的編輯器編輯 IMArchiveDisplay.jsp 檔案。例如,您可以輸入以下內容:
  2. vi IMArchiveDisplay.jsp

  3. IMArchiveDisplay.jsp 檔案中的程式碼範例 7-4 取代程式碼範例 7-3 中的指令碼行:
  4. 程式碼範例 7-3  修改預設系統訊息。

    ....

    ht.put("has_joined_the_room","<span class='user'> {0} </span>

    <span class='headervalue'> has joined the room.</span>");

    ....

    程式碼範例 7-4  之後取代預設系統訊息。

    ....

    ht.put("has_joined_the_room","<span class='user'> {0} </span>

    <span class='headervalue'> has entered the room.</span>");

    ....

您也可以採用類似的方法,修改顯示金鑰資訊之其他金鑰和樣式的資源字串。

如果在 Portal Server 搜尋預設模式中「標題」與「完整文字」的屬性名稱改變,此變更也會反應到 IMArchiveDisplay.jsp 檔案中。


歸檔提供者的範本部署方案

此範本部署方案解釋如何同時歸檔相關 Instant Messaging 資料的方法。

    整體而言,若要同時歸檔相關的 Instant Messaging 資料:

為每種資料類型建立個別的種類。例如,在歸檔所有 Instant Messaging 資料的「歸檔」種類,建立一個「聊天」子種類以儲存聊天訊息。您也可以依照時間建立歸檔資料的子種類。例如,若要歸檔 2002 年 12 月的聊天資料,則子種類會是:

Archive:Chat:2002:12

    若要依照時間歸檔所有聊天資料
  1. 變更至 config 目錄。例如在 Solaris 類型上:
  2. cd /etc/opt/SUNWiim/default/config

  3. 編輯 iim.conf 檔案。例如:
  4. vi iim.conf

  5. 新增下列值給參數 iim_arch.chat.categoryname
  6. iim_arch.chat.categoryname = Archive:Chat:%Y:%M

    歸檔提供者會自動指派目前的年份給 %Y,目前的月份給 %M。此值是從系統的日期與時間取得。

    若要將 2002 年 12 月的聊天資料歸檔並備份至子種類
  1. 請輸入下列指令:
  2. rdmgr -Q "classification=Archive:Chat:2002:12" > archive.soif

  3. 儲存 .soif 檔案到您的備份系統。
    若要從 Portal Server 搜尋資料庫中移除 2002 年 12 月的已歸檔聊天資料


上一頁      目錄      索引      下一頁     


文件號碼:819-1490。 Copyright 2005 Sun Microsystems, Inc. 版權所有。