Sun Java System Instant Messaging 7.2 管理指南

管理 Instant Messaging 入口網站歸檔

下列主題描述的是使用 Instant Messaging 入口網站歸檔：

Instant Messaging 入口網站歸檔簡介

Instant Messaging 入口網站歸檔提供者包含如下功能：

它會擷取所有 Instant Messaging 透過伺服器傳遞的資料流量。
歸檔資料可以儲存於 Portal Server 搜尋中的個別目錄下。將資料儲存為不同種類可幫助您簡化歸檔資料的搜尋和擷取。可使用 Portal Server 桌面來執行搜尋。
可使用 Portal Server 搜尋的安全功能來提供存取控制清單。歸檔提供者提供安全功能，僅允許一組管理使用者存取歸檔資料。
可使用 Portal Server 搜尋資料庫管理工具來管理資料。

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

聊天 - 私人會議室中的所有訊息。

會議 - 公開會議室中的所有訊息。

警示 - 所有警示訊息。

輪詢 - 所有輪詢訊息。

新聞 - 新聞通道中所發佈的所有訊息。

Instant Messaging 入口網站歸檔包下列元件：

歸檔與可擷取元件 - Portal Server 搜尋元件，亦稱為「歸檔與可擷取」元件，可用來儲存已歸檔的「即時訊息」。為 Instant Messaging 歸檔資料編列索引，且會將這些資料儲存於 Portal Server 搜尋資料庫。您也可指定歸檔資料的目錄。例如，您可將警示訊息儲存於「警示」目錄下。將資料儲存為不同種類可幫助您簡化搜尋作業，並能加速歸檔資料的擷取。

Instant Messaging 歸檔搜尋或顯示 Servlet - 當一般使用者搜尋符合某些條件的文件時，Portal Server 搜尋會擷取符合此條件的頁面。這些頁面可能是遠端網頁或 Instant Messaging 歸檔資料，亦稱為 Instant Messaging 資源描述元。

在遠端網頁中，符合條件的網頁 URL 會列於 [搜尋結果清單] 中。當一般使用者按一下 [搜尋結果清單] 中的網頁 URL 時，瀏覽器會從遠端 Web 容器擷取此網頁。
對於 Instant Messaging 資源描述元來說，歸檔資料儲存在 Portal Server 搜尋資料庫，且不能做為可下載的文件從 Web 容器下載。

當一般使用者按一下 Instant Messaging 資源描述元的 URL 以檢視歸檔資料時，會呼叫 Instant Messaging 歸檔搜尋或顯示 servlet。Instant Messaging 歸檔搜尋 servlet 從 Portal Server 搜尋資料庫擷取資料，並產生含有 Instant Messaging 歸檔資料的文字或 HTML 回應。

Instant Messaging 歸檔提供者 - 每當要歸檔即時訊息時，此元件就會呼叫 Instant Messaging 伺服器。Instant Messaging 歸檔提供者根據 Instant Messaging 伺服器所提供的資料建立與「摘要物件交換格式」(SOIF) 相容的「資源描述元」(RD)。歸檔提供者會使用 Portal Server 搜尋 API 來將這些資源描述元傳送至 Portal Server 搜尋資料庫，並維持一個可傳送至 Portal Server 搜尋資料庫的記錄緩衝區，以降低效能上的衝擊。

圖 18–1 描述 Instant Messaging 入口網站歸檔元件。

圖 18–1 Instant Messaging 入口網站歸檔元件

啟用與停用入口網站歸檔提供者

您可啟用 Instant Messaging 歸檔提供者，或修改 iim.conf 中的參數來啟用自訂的歸檔提供者。

啟用 Instant Messaging 入口網站歸檔提供者

開始之前

確定您已如啟用 Instant Messaging 歸檔中所述來啟用 Instant Messaging 的歸檔。

開啟 iim.conf。

如需找到並修改 iim.conf 的說明，請參閱iim.conf 檔案語法。

在 iim.conf 中，加入您想啟用之歸檔提供者類型的行。

對於自訂的歸檔提供者，加入下列行：
iim_server.msg_archive.provider = provider-name
若要使用 Portal Server 搜尋歸檔提供者，請以下列行來取代 provider- name：
com.iplanet.im.server.IMPSArchive
iim_server.msg_archive.provider 參數包含以逗號分隔的歸檔提供者清單。除了啟用例如電子郵件歸檔外，如果您想啟用入口網站歸檔，應將參數與其值設定如下：
iim_server.msg_archive.provider = com.iplanet.im.server.IMPSArchive, \ com.iplanet.im.server.EmailIMArchive

如果您執行的是 Sun Java^TM System Portal Server 7 2006Q1 或更新的版本，請提供下列參數的值：
iim_arch.portal.search="Portal Server Search URL"
其中，Portal Server Search URL 是 Portal Server 的搜尋 URL。例如：
iim_arch.portal.search="http://portal.siroe.com:8080/search1/search"

儲存並關閉 iim.conf。

重新整理 Instant Messaging 伺服器配置。
imadmin refresh

以 amadmin 身份登入 psconsole。

如需說明，請參閱 Portal Server 文件。

選擇管理通道與容器。

選擇託管搜尋功能的入口網站與組織。

在 DP XML 樹狀結構檢視下選擇 IMChannel。

在 [searchServer] 中輸入搜尋伺服器的 URL 值。

例如：
http://portal.siroe.com:8080/search1/search

儲存內容。

停用入口網站歸檔提供者

開啟 iim.conf。

如需詳細資訊，請參閱iim.conf 檔案語法。

從 com.iplanet.im.server.IMPSIMArchive 參數中刪除 iim_server.msg_archive.provider 值。

儲存並關閉 iim.conf。

重新整理 Instant Messaging 伺服器配置。
imadmin refresh

配置 Instant Messaging 入口網站歸檔提供者

Instant Messaging 歸檔提供者可將歸檔訊息儲存為 Portal Server 搜尋資料庫中的資源描述元 (RD)。歸檔提供者可使用 Portal Server 搜尋模式的下列欄位：

標題 - 此欄位包含會議種類中公開會議室的名稱、聊天種類中聊天階段作業的參加者名稱、警示訊息的主旨以及警示與新聞種類的新聞通道名稱。標題欄位可讓輪詢目錄中包含「Poll from Sender」，其中 Sender 代表輪詢寄件者的顯示名稱。

關鍵字 - 對於會議和聊天種類，此欄位會包含會議室內所有參加者的清單。對於公開會議室，此欄位還會包含會議室的名稱。對於警示種類，此欄位會包含寄件者和收件者的名稱。對於新聞種類，此欄位會包含頻道的名稱。對於輪詢種類，此欄位會包含寄件者和收件者的名稱。對於多有種類，此欄位除包含上述值之外，也包含該種類的唯一 ID。

表 18–2 顯示其唯一的 ID 並為歸檔提供者中的每個種類提供說明。

表 18–2 歸檔提供者種類的唯一 ID 與說明


種類	唯一 ID
會議聊天	`RoomName-StartTime` 其中： `RoomName` - 公開或私人會議室的名稱 `StartTime` - 建立 RD 的時間戳記
警示	`Alert-messageID` 其中： `messageID` - 將會被歸檔之訊息的訊息 ID。當 RD 僅包含一個訊息時，訊息 ID 會很重要。例如，「新聞」訊息和「警示」訊息。
輪詢	`Poll-pollID`
新聞	`TopicName-messageID`

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

會以 ReadACL 欄位中的值來控制至 RD 的搜尋存取。如果已啟用檔案層級安全性，則一般使用者僅在 ReadACL 欄位有一般使用者的 DN 時，才有對搜尋結果的存取權。

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

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

分類 - 此欄位包含歸檔訊息的種類。

配置歸檔提供者

開啟 iim.conf。

如需找到並修改 iim.conf 的說明，請參閱附錄 A iim.conf 中的 Instant Messaging 配置參數。

隨意新增或編輯歸檔提供者配置參數。

如需可修改之參數的清單，請參閱表 A–8。

儲存並關閉 iim.conf。

重新整理 Instant Messaging 伺服器。

在非預設的資料庫中儲存歸檔訊息

使用此程序配置 Instant Messaging 將歸檔訊息儲存至資料庫，而非使用預設值。

開啟 iim.conf。

如需找到與修改 iim.conf 的說明，請參閱附錄 A iim.conf 中的 Instant Messaging 配置參數。

在預設的歸檔提供者下，加入下列行：
iim_arch.portal.search.database = database-name
其中，database-name 是非預設資料庫的名稱。

儲存並關閉 iim.conf。

修改 Portal Server 搜尋通道。

變更 Portal Server 搜尋通道來新增選項，用於搜尋另一個資料庫中的資料。如需詳細資訊，請參閱 Sun Java System Portal Server Desktop Customization Guide。

變更至 IMProvider 目錄。

例如：
cd /etc/opt/SUNWps/desktop/default_locale/IMProvider/
其中，locale 是您的部署中所使用的語言。例如，default_ja 或 en_US。而且，如果您已建立多個 Instant Messaging 的實例，則視各實例而定，/default 目錄的名稱會不同。

建立 IMArchiveDisplay.jsp 檔案的備份檔案。

開啟 IMArchiveDisplay.jsp 檔案：

在 IMArchiveDisplay.jsp 檔案中搜尋並找到下列兩行程式碼：

<search:setQuery query = "<%= scope %>"/>
 <search:setRDMType rdmType = "rd-request"/>

在前一個步驟中所顯示的兩行程式碼之間，新增下列程式碼：

<search:setDatabase database = "database-name"/>

在您新增此列程式碼之後，此程式碼看起來應該為如下：

<search:setQuery query = "<%= scope %>"/>
 <search:setDatabase database = "database-name"/>
<search:setRDMType rdmType = "rd-request"/>

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

以實體伺服器主機名稱來取代虛擬搜尋伺服器。

儲存並關閉 IMArchiveDisplay.jsp。

管理 Portal Server 搜尋資料庫中的歸檔資料

備註 –

這些說明僅適用於 Solaris。

在 Portal Server 搜尋資料庫中，會將 Instant Messaging 資料歸檔為資源描述元 (RD) 的格式。Portal Server 搜尋資料庫中的個別項目稱為資源描述元 (RD)。一個 RD 即為某單一資源的一組特定資訊。每個 RD 的欄位都是由 Portal Server 搜尋資料庫模式決定的。

若要管理歸檔資料，您需要管理 Portal Server 搜尋資料庫中的資源描述元 (RD)。本節說明某些經常執行的 Portal Server 搜尋資料庫維護工作。

如需管理 Portal Server 搜尋資料庫中資料的詳細資訊，請參閱 Sun Java System Portal Server 管理指南。

`rdmgr` 指令

rdmgr 指令是用於和「搜尋」服務一同作業的主要指令。它提供管理員兩種子指令類型：一個是用於操作資源描述元 (RD)，另一個是用於資料庫維護。rdmgr 指令一般在啟用搜尋的 Portal Server Portal Server 實例目錄中執行。

呼叫 `rdmgr` 指令

變更至 https-servername 目錄。
cd /var/opt/SUNWps/https-servername
其中，servername 是 Portal Server 的名稱

在指令行中鍵入：
run-cs-cli portal-svr-base/SUNWps/bin/rdmgr options
其中，portal-svr-base 是安裝 Portal Server 的目錄。

如需關於 rdmgr 指令的詳細資訊，請參閱 Sun Java System Portal Server 管理指南中的「指令行公用程式」。

搜尋資源描述元

以引數值 -Q 執行 rdmgr 指令會產生精簡搜尋作業的資源描述元 (RD) 清單。

例如：

若要搜尋含有文字 testing 的資源描述元 (RD)，鍵入：
run-cs-cli portal-svr-base/SUNWps/bin/rdmgr -Q testing
若要搜尋屬於特定目錄的資源描述元 (RD)，鍵入下列指令。以單行輸入指令：
run-cs-cli portal-svr-base/SUNWps/bin/rdmgr -Q "classification=Archive:Chat:January"

刪除資源描述元

以下是從 Portal Server 搜尋資料庫中刪除資源描述元 (RD) 的範例：

若要刪除含有文字 testing 的所有資源描述元 (RD)，鍵入：

run-cs-cli portal-svr-base/SUNWps/bin/rdmgr -d -Q testing

若要從目錄 Archive:Chat:January 中刪除所有資源描述元 (RD)，鍵入下列指令。以單行輸入指令：

run-cs-cli portal-svr-base/SUNWps/bin/rdmgr
-d -Q "classification=Archive:Chat:January"

變更歸檔資料的顯示

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

例如，您可依照下列步驟說明，取代一般使用者加入會議室時顯示的預設系統訊息。

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

如果您變更「標題」名稱，且 Portal Server 搜尋的預設模式中「完整文字」的屬性名稱已變更，則這些變更也會反應到 IMArchiveDisplay.jsp 檔案中。

修改預設系統訊息

編輯 IMArchiveDisplay.jsp。

在 IMArchiveDisplay.jsp 中搜尋下列程式碼行：

....
ht.put("has_joined_the_room","<span class='user'> {0} </span>
<span class='headervalue'> has joined the room.</span>");
....

以想要的文字取代 headervalue。

例如：

....
ht.put("has_joined_the_room","<span class='user'> {0} </span>
<span class='headervalue'> has entered the room.</span>");
....

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

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

範例 18–1 同時歸檔相關 Instant Messaging 資料

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

Archive:Chat:2002:12

依時間歸檔所有 Instant Messaging 聊天資料

變更至 im-cfg-base 目錄。

如需如何找到 im-cfg-base 的資訊，請參閱Instant Messaging 伺服器目錄結構。

開啟 iim.conf。

如需找到並修改 iim.conf 的說明，請參閱iim.conf 檔案語法。

為 iim_arch.chat.categoryname 新增下列值：

iim_arch.chat.categoryname = Archive:Chat:%Y:%M

歸檔提供者會將 %Y 自動指定為當前的年份，並將 %M 自動指定為當前的月份。這些值是取自系統日期與時間。

將 2005 年 12 月份的 Instant Messaging 聊天資料歸檔與備份至子種類

鍵入下列內容：

rdmgr -Q "classification=Archive:Chat:2005:12" > archive.soif

將 archive.soif 檔複製到您的備份系統。

從 Portal Server 搜尋資料庫中移除 2005 年 12 月份的歸檔 Instant Messaging 聊天資料

在指令行中鍵入：

rdmgr -d "classification=Archive:Chat:2005:12"