在本章下列各節中,說明如何設定與管理電子郵件、入口網站與自訂 Instant Messaging 的歸檔:
您可以下列方式來歸檔即時訊息:
使用 Portal Server 搜尋式歸檔。此方式會抓取即時訊息並把這些訊息歸檔在 Portal Server 搜尋資料庫中。一般使用者可使用 Portal Server 桌面上的 [搜尋] 頁面來查詢與擷取已歸檔的訊息。
使用電子郵件歸檔。使用此方式時,聊天與會議的參加者會收到電子郵件,其中包含他們參加的 Instant Messaging 階段作業的內容。一般使用者可使用任何電子郵件用戶端來搜尋與管理即時訊息。
使用自訂歸檔。您可選擇使用 Instant Messaging 歸檔提供者,或建立您專屬的自訂歸檔提供者。Instant Messaging 提供 API 和 SPI 以用於寫入自訂歸檔提供者。如需有關 Instant Messaging API 的詳細資訊,請參閱附錄 DInstant Messaging API。不論您選擇使用哪種歸檔提供者,都需要在 iim.conf 中啟用歸檔提供者。
您可配置 Instant Messaging 使用一種歸檔方式,或同時使用多種歸檔方式。
不論您選擇使用入口網站、電子郵件、自訂歸檔或任何歸檔的組合,啟用 Instant Messaging 中的歸檔功能與本節中所描述的都相同。如本節所述停用歸檔,會停用所有歸檔。
在您啟用 Instant Messaging 的歸檔後,必須如下列小節所述啟用您要使用之歸檔類型的歸檔提供者:
開啟 iim.conf。
如需詳細資訊,請參閱iim.conf 檔案語法。
如果 iim.conf 中沒有下列指令行,則加入它們。
iim_server.msg_archive = true |
儲存並關閉 iim.conf。
重新整理伺服器。
imadmin refresh server |
此程序會停用所有的 Instant Messaging 歸檔。如果您僅想要停用電子郵件歸檔、入口網站歸檔、或所配置的自訂歸檔,請參閱下列其中一節:
開啟 iim.conf。
如需詳細資訊,請參閱iim.conf 檔案語法。
將 iim_server.msg_archive 參數設定為 false。
iim_server.msg_archive = false |
儲存並關閉 iim.conf。
重新整理伺服器。
imadmin refresh server |
您可使用 Instant Messaging 來歸檔輪詢、聊天、會議、新聞通道和警示內容,並使用電子郵件傳送給一般使用者與管理員。您也可使用任何電子郵件用戶端來搜尋與管理已歸檔的內容。本節會在下列各節中描述 Instant Messaging 電子郵件歸檔:
Instant Messaging 伺服器會快取已歸檔的記錄,直到以電子郵件將它們寄出為止。如果您啟用電子郵件歸檔,則會增加對記憶體容量的需求。如需效能調校的資訊,請參閱「Sun Java Communications Suite 5 Deployment Planning Guide」。
您可修改 iim.conf 中的參數值來啟用與停用電子郵件歸檔提供者。
確定您已如啟用 Instant Messaging 歸檔中所述來啟用 Instant Messaging 的歸檔。
開啟 iim.conf。
如需詳細資訊,請參閱iim.conf 檔案語法。
如果 iim.conf 中沒有下列指令行,則加入它們。
iim_server.msg_archive.provider = com.iplanet.im.server.EmailIMArchive |
iim_server.msg_archive.provider 參數包含以逗號分隔的歸檔提供者清單。除了啟用例如電子郵件歸檔外,如果您想啟用入口網站歸檔,應將參數與其值設定如下:
iim_server.msg_archive.provider = com.iplanet.im.server.IMPSArchive, \ com.iplanet.im.server.EmailIMArchive |
儲存並關閉 iim.conf。
重新整理 Instant Messaging 伺服器配置。
imadmin refresh |
開啟 iim.conf。
請參閱iim.conf 檔案語法以取得詳細資訊。
從 iim_server.msg_archive.provider 參數中刪除 com.iplanet.im.server.EmailIMArchive 值。
儲存並關閉 iim.conf。
重新整理 Instant Messaging 伺服器配置。
imadmin refresh |
您可配置會收到包含已歸檔即時訊息之電子郵件的管理員。您可配置單獨的管理員清單中來接收輪詢、新聞、會議、警示或聊天階段作業。您也可配置 Instant Messaging 使用延伸的 RFC 822 標頭。這麼做可讓郵件用戶端根據標頭內容來篩選郵件。
如果您在修改這些電子郵件歸檔的參數後才執行 configure,則會覆寫您所輸入的任何值。
表 18–1 描述您用來定義要接收電子郵件歸檔的管理員配置參數,以及是否要使用延伸的 RFC 822 標頭以及該標頭的內容。
表 18–1 電子郵件歸檔配置參數
參數 |
預設值 |
說明 |
---|---|---|
iim_arch.admin.email |
空字串 |
以逗號分隔的管理員電子郵件地址清單。 |
iim_arch.alert.admin.email |
無 |
以逗號分隔的管理員電子郵件地址清單,會向其傳送所有已歸檔的警示訊息。此參數會覆寫警示訊息的 iim_arch.admin.email。 |
iim_arch.chat.admin.email |
無 |
以逗號分隔的管理員電子郵件地址清單,會向其傳送所有已歸檔的聊天訊息。此參數會覆寫聊天訊息的 iim_arch.admin.email。 |
iim_arch.conference.admin.email |
無 |
以逗號分隔的管理員電子郵件地址清單,會向其傳送所有已歸檔的會議訊息。此參數會覆寫會議訊息的 iim_arch.admin.email。 |
iim_arch.poll.admin.email |
無 |
以逗號分隔的管理員電子郵件地址清單,會向其傳送所有已歸檔的輪詢訊息。此參數會覆寫輪詢訊息的 iim_arch.admin.email。 |
iim_arch.news.admin.email |
無 |
以逗號分隔的管理員電子郵件地址清單,會向其傳送所有已歸檔的新聞訊息。此參數會覆寫新聞訊息的 iim_arch.admin.email。 |
iim_arch.email.archiveheader.name |
無 |
延伸的 RFC 822 標頭的名稱。 |
iim_arch.email.archiveheader.value |
全部 |
iim_arch.email.archiveheader.name 的標頭名稱對應值。 |
開啟 iim.conf。
請參閱iim.conf 檔案語法以取得詳細資訊。
新增表 18–1 中的參數與適當的 iim.conf 值。
重新整理伺服器。
imadmin refresh |
下列各節描述包含各種已歸檔 Instant Messaging 內容之電子郵件訊息的 RFC 822 標頭內容:
聊天階段作業發起者。
在 iim.conf 中所配置的收件者與任何管理員。如需詳細資訊,請參閱表 18–1。
聊天階段作業發起者。
第一封長度超過 50 個字元的實用郵件。
歸檔提供者電子郵件訊息的建立日期。
未使用。
由電子郵件歸檔提供者根據訊息執行緒產生。
聊天階段作業發起者。
在 iim.conf 中所配置的其他參加者與任何管理員。請參閱表 18–1 以取得詳細資訊。
聊天階段作業發起者。
如果已設定會議主旨,則使用會議主旨。如果未設定主旨,則會使用長度超過 50 個字元的第一封實用郵件。
歸檔提供者電子郵件訊息的建立日期。
未使用。
由電子郵件歸檔提供者根據會議 ID 產生。
歸檔資料中的第一個寄件者。
關聯的郵寄清單、擁有會議室明確存取權的使用者,以及 iim.conf 中所配置的任何管理員。請參閱表 18–1 以取得詳細資訊。
未使用。
[會議名稱] 主旨。
歸檔提供者電子郵件訊息的建立日期。
未使用。
由電子郵件歸檔提供者根據會議 ID 產生。
輪詢寄件者。
在 iim.conf 中所配置的輪詢寄件者與任何管理員。請參閱表 18–1 以取得詳細資訊。
未使用。
輪詢問題。
歸檔提供者電子郵件訊息的建立日期。
未使用。
由電子郵件歸檔提供者產生。
輪詢寄件者。
在 iim.conf 中所配置的輪詢收件者與任何管理員。請參閱表 18–1 以取得詳細資訊。
輪詢寄件者。
輪詢問題。
歸檔提供者電子郵件訊息的建立日期。
未使用。
由電子郵件歸檔提供者所產生的。
警示寄件者。
在 iim.conf 中所配置的警示收件者與任何管理員。請參閱表 18–1 以取得詳細資訊。
未使用。
警示主旨。
歸檔提供者電子郵件訊息的建立日期。
未使用。
由電子郵件歸檔提供者產生。
新聞通道發佈寄件者。
與新聞通道關聯的郵寄清單及在 iim.conf 中所配置的任何管理員。請參閱表 18–1 以取得詳細資訊。
未使用。
新聞通道發佈主旨。
歸檔提供者電子郵件訊息的建立日期。
未使用。
由電子郵件歸檔提供者根據新聞通道 ID 產生。
下列主題描述的是使用 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 入口網站歸檔元件。
您可啟用 Instant Messaging 歸檔提供者,或修改 iim.conf 中的參數來啟用自訂的歸檔提供者。
確定您已如啟用 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 JavaTM 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 歸檔提供者可將歸檔訊息儲存為 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。
這些說明僅適用於 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 指令是用於和「搜尋」服務一同作業的主要指令。它提供管理員兩種子指令類型:一個是用於操作資源描述元 (RD),另一個是用於資料庫維護。rdmgr 指令一般在啟用搜尋的 Portal Server Portal Server 實例目錄中執行。
變更至 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 資料的方法。
為每種資料類型建立個別的種類。例如,在歸檔所有 Instant Messaging 資料的「歸檔」種類中,建立一個「聊天」子種類以儲存聊天訊息。您也可以依照時間建立歸檔資料的子種類。例如,若要歸檔 2002 年 12 月份的聊天資料,子種類會是:
Archive:Chat:2002:12
變更至 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 自動指定為當前的月份。這些值是取自系統日期與時間。
在指令行中鍵入:
rdmgr -d "classification=Archive:Chat:2005:12" |
除了入口網站與電子郵件歸檔外,您也可選擇使用自訂歸檔提供者。
確定您已如啟用 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 |
儲存並關閉 iim.conf。
重新整理 Instant Messaging 伺服器配置。
imadmin refresh |
開啟 iim.conf。
請參閱iim.conf 檔案語法以取得詳細資訊。
僅從 iim_server.msg_archive.provider 參數中刪除自訂歸檔提供者的值。
儲存並關閉 iim.conf。
重新整理 Instant Messaging 伺服器配置。
imadmin refresh |