IBM CommonStore for Lotus Domino在AIX平臺上的手動配置過程及自動配置工具的使用

列印本頁   將此頁作為電子郵件傳送   未顯示需要 JavaScript. 的文件選項

姚明明 (yaomm@cn.ibm.com), 軟體測試工程師, IBM

2008 年 7 月 10 日

IBM CommonStore for Lotus Domino 提供了對 Lotus Notes 文件進行存檔並對已存檔文件進行查詢，顯示，恢復，刪除等功能，與 IBM Lotus Domino、IBM Content Manager 等環境軟體之間存在介面，本教程將介紹其手動配置過程和自動配置工具的使用。

IBM CommonStore for Lotus Domino 簡介

IBM CommonStore for Lotus Domino（以下簡稱 CSLD）提供了對 Lotus Notes 文件進行存檔（archive），以及對已存檔文件進行查詢（search），顯示（display），恢復（retrieve），刪除（delete）等功能。CSLD 可以用於集中存檔暫時不用的郵件，從而控制 Lotus Notes 資料庫的大小，釋放 Lotus Domino 伺服器上的空間，以便提高 Domino 伺服器的通訊效能，還能保證客戶滿足與存檔相關的法律法規要求。

前提條件

本文是為不具備 IBM CommonStore for Lotus Domino 安裝配置知識的人員編寫的。但您應該對 IBM Lotus Domino、IBM Content Manager 等環境軟體有基本知識和使用經驗。

系統需求

您將需要有下列伺服器:

• CSLD 伺服器（CSLD V8.4）
• Domino 伺服器（Domino V8）
• CM 伺服器（CM V8.4）

最好在三臺不同的伺服器上完成。

CSLD 應用的架構

圖 1. CSLD 應用架構

CSLD Task 通過 Lotus Notes C API 從 Domino 伺服器上獲取郵件，傳遞給 CSLD Server，後者通過 CM connector 將郵件儲存到 CM 伺服器上。

確認 Domino 伺服器正常執行

啟動 Domino 伺服器並嘗試收發郵件，確認能正常執行。

確認 CM 伺服器正常執行

啟動 CM 相關服務並嘗試向一個專案型別（item type）中匯入文件，在 CM Windows Client 中查詢該文件，確認能正常執行。

安裝 Notes C API

一般說來，只需要在 CSLD 伺服器上安裝 Lotus Notes 客戶端。但是 Notes 沒有適用於 AIX 平臺的版本，因此必須安裝 Domino，但不必進行任何配置。

Domino 在 AIX 上的安裝請參考參考資源中相關內容。

注意：

記錄您在安裝 Domino 過程中進行的設定：

• 程式安裝路徑：預設值為 /opt/IBM/lotus
• 資料檔案安裝路徑：預設值為 /opt/IBM/lotus/notesdata
• 使用者名稱：預設值為 notes
• 組名：預設值為 notes

安裝 CM connector

需要在 CSLD 所在機器上安裝 IBM DB2（以下簡稱 DB2）和 IBM DB2 Information Integrator for Content（以下簡稱 II4C）。

DB2 在 AIX 上的安裝請參考參考資源中相關內容。

II4C 在 AIX 上的安裝請參考參考資源中相關內容。

注意：

記錄您在安裝 DB2 過程中進行的設定：

• 程式安裝路徑：預設值為 /usr/opt/db2_08_01（DB2 V8.1）或 /opt/IBM/db2/V9.1（DB2 V9.1）
• 使用者名稱：預設值為 db2inst1
• 組名：預設值為 db2grp1

注意：

記錄您在安裝 II4C 過程中進行的設定：

• 程式安裝路徑：預設值為 /opt/IBM/db2cmv8
• 使用者名稱：預設值為 ibmcmadm
• 組名：預設值為 ibmcmgrp

安裝 CSLD 軟體包

以 root 使用者登入 AIX 系統，使用 smit 安裝 CSLD 軟體包。安裝完成後，在 /usr/lpp 路徑下將產生 csld 目錄。

建立 AIX 上的 CSLD 使用者

使用 smit 建立一個 AIX 使用者，設定使用者名稱為 csld（或其他名字），該使用者必須是 bin 組成員。根據您前面記錄的資訊，還應設定該使用者屬於 Notes、DB2、CM 組，預設情況下就是 notes、db2grp1、ibmcmgrp。

以使用者 csld 登入 AIX 系統，將 /usr/lpp/csld/bin 中的兩個指令碼拷貝到其 home 目錄（/home/csld）中：

/usr/lpp/csld/bin/csenv.sh
/usr/lpp/csld/bin/notesenv.sh

編輯 csld 的登入 profile（$home/.profile）：

1． 加入對以下指令碼的呼叫：

. $HOME/csenv.sh
. $HOME/notesenv.sh
. /home/db2inst1/sqllib/db2profile
. /opt/IBM/db2cmv8/bin/cmbenv81.sh

下文將描述如何修改上述指令碼的內容以適於使用者的實際環境。

2． 設定語言環境變數，CSLD 將使用這種語言輸出螢幕資訊：

export LANG=en_US

連線 Domino 伺服器

1． CSLD Task 需要使用一個 Notes 使用者連線 Domino 伺服器。確保在 Domino 伺服器上已經建立了此使用者 cslduser（或其他名字）。

2． 根據您所記錄的 Domino 程式安裝路徑等資訊檢查 $home/notesenv.sh，確認指令碼中的設定與實際路徑相符。

3． CSLD Task 使用根據 PATH 環境變數找到的第一個 notes.ini 檔案。為了確保 CSLD 使用您所指定的 notes.ini，請將其所在的目錄新增到 notesenv.sh 中 PATH 變數的最前端。預設是 $home/notesdata 目錄，您可以指定其他目錄。將 /usr/lpp/csld/bin 中的 AIX_sample_notes.ini 檔案到 $home/notesdata 目錄下，根據實際環境修改如下引數設定：

• Directory：指定地址簿 names.nsf 所在的目錄。確保使用者 csld 可以寫這個目錄，Notes 會話的除錯資訊會寫入此目錄。names.nsf 為 CSLD Task 提供指向 Domino 伺服器的 connection 文件。您可以從一個安裝了 Notes 客戶端並連線到目標 Domino 伺服器的 Windows 機器上拷貝地址簿檔案 names.nsf。一般我們把 names.nsf 也放在 $home/notesdata 目錄中，避免其他應用程式訪問 names.nsf 從而與 CSLD 發生衝突。
• Location：如果不指定此引數，CSLD 使用 names.nsf 中按字母順序排列的第一個 location 文件。要使用其他 location，應該在該引數中指定。
• MailServer：cslduser 的 home 伺服器。
• MailFile：cslduser 的郵箱在 Domino 伺服器上的相對路徑（相對於 data 目錄）。
• KeyFilename：cslduser 的 ID 檔案。一般我們把這個 ID 檔案也放在 $home/notesdata 目錄中，避免衝突。
• ExtMgr_Addins=libextpwd.a：設定了這一引數以後，每次 CSLD Task 啟動時將不再詢問 cslduser 的密碼，而是使用之前儲存的密碼。

CSLD 所需的 Notes 資料庫

CSLD Task 的配置資料儲存在 Domino 伺服器上的一個 Notes 資料庫中（以下簡稱配置資料庫）。

存檔、查詢、恢復和刪除等操作的請求也儲存在一個 Notes 資料庫中（以下簡稱配置資料庫）。

為了使普通 Notes 使用者能夠執行存檔、查詢、恢復和刪除等操作，需要在其郵箱中新增對應的按鈕和指令碼。

CSLD 提供了建立上述 Notes 資料庫的 NTF 模板檔案。

模板檔案位於 /usr/lpp/csld/data 目錄中：

CSLDConfig.ntf：配置資料庫模板。

確保 cslduser 對配置資料庫至少擁有 Reader 許可權。

注意：

配置資料庫不會提供任何預設配置，您必須自己建立所有配置。

為了啟動 CSLD Task，至少要建立 Database Profile、Document Mapping、Content Type Mapping 等型別的文件，其中包含如下設定：

• CSLD Task 的型別：存檔、恢復、查詢和刪除
• CSLD Task 的執行時間、頻率
• CSLD Task 負責處理的請求資料庫和郵件資料庫
• CSLD Server 的主機名和埠號
• CSLD Task 的埠
• 日誌目錄

如果您希望 CSLD 自動遍歷郵件資料庫，根據事先設定的條件選擇郵件併產生操作請求，還需要建立 Policy、Database Set、Scheduled Task 等型別的文件，其中包含如下設定：

• 自動遍歷的時間、頻率
• 需要遍歷的郵件資料庫
• 操作請求的型別
• 選擇郵件的條件

CSLDJobs.ntf：請求資料庫模板。

確保 cslduser 對請求資料庫至少擁有 Editor 許可權，並能刪除文件。

CSLDStdMail.ntf 和 CSLDStdMail8.ntf：郵件資料庫模板。

分別適用於 Domino V7 和 Domino V8。確保 cslduser 對郵件資料庫至少擁有 Editor 許可權，並能刪除文件。

注意：

您可以直接使用這些模板檔案，或參考它們建立自己的模板。

啟動 CSLD Task

以 csld 身份登入 AIX 系統。

1．首先將 cslduser 的密碼儲存下來，這樣每次啟動 CSLD Task 時不必再輸入密碼：csld –f serverpasswd

2．啟動 CSLD Task。

csld -n csldconf.nsf -s abc/def -p archive_task
其中引數 -n 指定配置資料庫名稱，-s 指定配置資料庫所在 Domino 伺服器名稱，-p 指定 CSLD Task 名稱。

連線 CM 伺服器

1． CSLD Server 需要使用一個 CM 使用者連線 CM 伺服器。確保在 CM 伺服器上已經建立了此使用者 csldadmin（或其他名字）。

2． 根據您所記錄的 DB2 程式安裝路徑等資訊檢查 /home/db2inst1/sqllib/db2profile，確認指令碼中的設定與實際相符。

3． 根據您所記錄的 II4C 程式安裝路徑等資訊檢查 /opt/IBM/db2cmv8/bin/cmbenv81.sh，確認指令碼中的設定與實際相符。

注意：

確保正確設定了環境變數 IBMCMROOT 和 DB2HOME。

4． 對 CM 所使用的 DB2 資料庫進行編目（catalog），如下：

db2 catalog tcpip node cm remote cmserver server 50000
db2 catalog db icmnlsdb as cmdb at node cmse

其中 cmserver 是 CM 伺服器的主機名，icmnlsdb 是 CM 所使用的 DB2 資料庫名。

5． 編輯 /home/ibmcmadm/cmgmt/connectors 中的 cmbicmsrvs.ini 新增新的 CM 伺服器連線資訊。您也可以使用 II4C 提供的配置工具 config_II4C ，預設情況下該工具位於 /opt/IBM/db2cmv8/bin 目錄中。

CSLD 所需的 CM 專案型別（Item Type）

郵件需要儲存到 CM 伺服器的一個專案型別中。

CSLD Server 可以使用兩種專案型別：

• 一種是基礎型別；
• 另一種具有這樣的特性（稱為 SIS）。

例如，Notes 使用者 A 將郵件 M 傳送給使用者 B、C 和 D， B、C 和 D 都對這封郵件進行存檔，在 CM 伺服器中對郵件儲存三次其實是對空間的一種浪費。在使用這種特殊專案型別時 CSLD 只會把這封郵件儲存一次。

但是在計算是否應該儲存一次時會花費一定的時間，所以是時間換空間的一種演算法，請根據您的實際需要選擇專案型別。

兩種專案型別都可以包含 CSLDMailSubject、CSLDMailFrom、CSLDPostedDate、CSLDMailTo、CSLDMailCc、CSLDMailBcc 等屬性，存檔後您可以根據這些屬性查詢相關的郵件

啟動 CSLD Server

將檔案 /usr/lpp/csld/bin/archint_sample_cm8.ini 拷貝到 csld 使用者的 home 目錄中，並更名為 archint.ini。

根據 CM 伺服器的連線資訊在 archint.ini 進行如下設定：

• ITEM_TYPE：CM 伺服器上專案型別的名稱
• LIBSERVER：CM 伺服器名稱
• CMUSER ：CM 使用者
• INSTANCEPATH：請設定為 csld 使用者的 home 目錄。

注意：

$HOME/csenv.sh 中 CSNINSTANCEPATH 變數所指定的目錄將用於儲存 CSLD Server 的日誌記錄。

以 csld 身份登入 AIX 系統。

1． 首先將 csldadmin 的密碼儲存下來，這樣每次啟動 CSLD Server 時不必再輸入密碼：archpro –f serverpasswd

2． 啟動 CSLD Server：archpro

自動配置工具

可以看出手動配置過程較為繁瑣，而自動配置工具可以根據您的輸入自動完成一些設定。

使用 /usr/lpp/csld/bin/CSLDAutoConfig.sh 指令碼執行自動配置工具。

執行工具之前，確保已經安裝了 Domino 和 II4C，也建立了供 CSLD 使用的 AIX 使用者。

檢查 CSLDAutoConfig.sh 指令碼，確保其中設定的所有變數與系統的實際情況一致。

注意：

CSNOTESDATAPATH 變數的值也被新增到 PATH 變數的最前端。配置工具會根據使用者設定修改根據 PATH 環境變數找到的第一個 notes.ini 檔案，設定為 CSLD Task 所使用的 notes.ini。notesenv.sh 中 PATH 變數應與其保持一致。

切換到 CSLD 使用者，執行配置工具：

# su - cs
$ CSLDAutoConfig.sh

1． 配置工具介面。

圖 2. 配置工具介面 1

2． 輸入 CSLD 程式安裝路徑、CSLD 伺服器的主機名。

圖 3. 配置工具介面 2

3． 可以用 IP 地址連線 Domino 伺服器，以避免 Domino 伺服器名字解析過程中可能遇到的問題。也可使用 Domino 伺服器的 Common Name 或 hierachical Name，這需要在 CSNOTESDATAPATH 變數指定的目錄中提供 names.nsf 檔案，或者依賴 hosts 檔案或 DNS 等辦法來解析名字。選擇一個 Notes 使用者的 ID 檔案，這個使用者將被用於建立配置資料庫和請求資料庫。輸入密碼後，點選 Connect 按鈕。如果輸入的資訊正確，並且這臺 Domino 伺服器正在執行，連線成功的資訊會顯示在下方。

圖 4. 配置工具介面 3

4． 選擇一個 Notes 使用者（例如 cslduser）的 ID 檔案，CSLD Task 將使用這個使用者訪問 Domino 伺服器，這個使用者密碼將被加密儲存。

圖 5. 配置工具介面 4

5． 指定儲存配置資料庫的 Domino 伺服器及路徑。可以指定要處理的郵件資料庫所在的 Domino 伺服器（可以指定多個）和該伺服器上請求資料庫的路徑。

圖 6. 配置工具介面 5

6． 選擇 CM 伺服器，輸入使用者名稱和密碼，這個使用者名稱將用於在此 CM 伺服器上建立專案型別。

圖 7. 配置工具介面 6

7． 下面的使用者名稱將被 CSLD Server 用於連線 CM。如果這個使用者不存在，就建立它，密碼將被加密儲存。

注意：

必須輸入 CommonStore 全文檢索模組在 CM 伺服器上的安裝路徑，這是因為配置工具只能建立具有全文檢索功能的專案型別。CommonStore 全文檢索模組模組使 Notes 使用者能夠對已存檔的郵件進行全文檢索，其安裝配置請參考參考資源中相關內容。

圖 8. 配置工具介面 7

8． 設定完成後，工具就可以自動為您建立所有相關配置。

圖 9. 配置工具介面 8

9． 如果一切設定正確，將會成功地建立所有配置。

注意：

如果某個屬性在 CM 中已經存在，但與 CSLD 的要求不匹配，CSLD 會修改該屬性的名字，並在此頁面上加以說明。

圖 10. 配置工具介面 9
 

自動配置的侷限

表 1. 自動配置工具總結

結束語

CSLD 的自動配置工具能夠完成手動配置過程中一些繁瑣的步驟，使使用者可以更快地建立起一個可用的配置，也降低了因手工操作而出現錯誤的可能性。但工具只能建立特定的配置，手動配置則顯得更加靈活。

檢視原文：http://www.ibm.com/developerworks/cn/db2/library/techarticles/dm-0807yaomm/

來自 “ ITPUB部落格 ” ，連結：http://blog.itpub.net/14751907/viewspace-403197/，如需轉載，請註明出處，否則將追究法律責任。