Lotus Quickr connectors 部署問題排疑

轉自 http://www.ibm.com/developerworks/cn/lotus/quickr-connectors-troubleshoot/index.html

Lotus Quickr connectors 是一組整合於 Windows 應用程式中的外掛，它可以幫助您輕鬆地連線到 Lotus Quickr 應用伺服器，並操作伺服器端的文件。Lotus Quickr connectors 安裝包提供了對 5 種基於不同應用程式外掛的安裝功能，它們是：

• Windows Explorer connector：整合於 Windows Explorer 中，使使用者能通過 Explorer 操作 Lotus Quickr 伺服器上的文件。
• Microsoft Office connector：使使用者在 Office 程式中檢入檢出 Lotus Quickr 伺服器上的文件。
• Microsoft Outlook connector：使使用者在 Outlook 程式中檢入檢出 Lotus Quickr 伺服器上的文件。
• Lotus Notes connector：允許使用者將 Notes 郵件存放於 Lotus Quickr 伺服器上。
• Lotus Sametime connector：整合於 Sametime 客戶端中，使使用者能通過 Sametime 操作 Lotus Quickr 伺服器上的文件。

圖 1. Lotus Quickr connectors 安裝部件

安裝問題的排除策略

從安裝日誌檔案獲得線索

Lotus Quickr connectors 安裝包 qkrconn.exe 是一個基於 InstallShield 開發的 Windows Installer 程式，在安裝包的執行時將呼叫 Windows Installer 例程。

由於 Lotus Quickr connectors 的本質是一個 Windows Installer 安裝包，而 Windows Installer 自身提供安裝日誌記錄，預設情況下安裝的日誌將以 MSIxxxxx.log 的形式存放於 Windows 的暫存目錄中，您可以在 Windows Explorer 中鍵入”%tmp%”加回車進入此暫存目錄，通常在您安裝過程結束或中斷時，此日誌檔案應為暫存目錄中的最新檔案，您可以以修改日期降序方便地找到它。

圖 2. Windows Installer 日誌檔案

預設情況下 Lotus Quickr connectors 在安裝前將開啟 Windows Installer 的日誌記錄功能，如果此項功能未能正常開啟，您也可以手動開啟登錄檔編輯器 regedit，查詢 HKEY_LOCAL_MACHINE\Software\Policies\Microsoft\Windows\Installer 鍵，並新增名稱為 Logging 的鍵，資料值設為 voicewarmup。

圖 3. Windows Installer 日誌記錄開關

Microsoft 為 Windows Installer 提供了一個簡便的診斷工具 Windows Installer Verbose Log Analyzer —— WiLogUtl.exe。您可在 MSDN上找到更多關於此診斷工具的介紹。

當您找到名為 MSIxxxxx.log 的日誌檔案後。使用 WiLogUtl 開啟此檔案，點選 Analyze，通常，安裝過程中發生的錯誤將會顯示於 Error 頁面中。您可以再點選 HTML Log 按鈕，在瀏覽器中以區分色方式瀏覽具體錯誤的發生段落。點選 States 您可以看到 Lotus Quickr connectors 所涉及的功能部件的安裝情況。而點選 Properties 則可以看到安裝過程中各個屬性（Property）的情況。

圖 5. 分類錯誤日誌

Notes/Sametime 外掛的安裝排疑

Lotus Notes 和 Lotus Sametime 在版本 8 以後就升級為基於 Lotus Expeditor 的應用程式，而 Lotus Expeditor 又是基於 Eclipse 技術發展而來的應用平臺。因而 Lotus Quickr connectors 所提供的 Notes 和 Sametime 元件包含有 Lotus Expeditor/Eclipse 外掛作為其組成部分。

Lotus Expeditor 提供了一系列的 Provisioning 命令，使用者使用了此類命令即可將第三方的 Expeditor/Eclipse 外掛安裝至基於 Expeditor 的平臺—— Lotus Notes 和 Lotus Sametime 中，因而 Lotus Quickr connectors 安裝包在安裝過程中也呼叫了這些命令。

Provisioning 過程的日誌檔案將由 Lotus Expeditor 系統記錄於相應的 workspace 中。對於 Lotus Notes 而言，日誌檔案通常置於 %userprofile%\ Local Settings\Application Data\Lotus\Notes\Data\workspace\logs 目錄中，而 Lotus Sametime 的日誌檔案通常置於 %appdata%\ Lotus\Sametime\logs，目錄下。

Provision 過程資訊將被記錄在 provision.log 檔案中。如果在 provision 過程中發生了錯誤，錯誤資訊可在 error-log-x.xml 中呈現，而具體的 Notes/Sametime 系統工作資訊，出錯資訊，例如 Java stacktrace 則可在 trace-log-x.xml 中找到。

安裝將會涉及的屬性 (Properties) 和登錄檔 (Registry) 鍵值

Lotus Quickr connectors 在安裝過程中也將在 Windows 系統中註冊一些資訊，通過這些資訊來記錄它的安裝狀態與版本。

以下是 Lotus Quickr connectors 在安裝過程中寫入的登錄檔項。

表 1. Lotus Quickr connectors 登錄檔資訊

其他安裝所涉及的系統屬性

在正常安裝完畢後 Lotus Quickr connectors 將在安裝目錄，例如 C:\Program Files\IBM\Lotus Quickr connectors 下寫入一個版本資訊檔案 buildinfo.txt：

清單 1. buildinfo.txt

				
Lotus Quickr connectors version: 8.2.0.132 

[pa.desktop.inst] 
buildnumber=q820_132_04 
buildtime=200906161129 

[pa.desktop] 
buildnumber=q820_137_01 
buildtime=200906151735 

[pa.notes_onramp] 
buildnumber=ORC8.2_FP 
buildtime=20090609.1301 

該檔案記錄了 Lotus Quickr connectors 不同功能元件的版本號。

常見問題

以下，我們列舉一些常見的安裝問題，並針對這些問題展開詳細的排疑討論。

多使用者環境部署問題

Lotus Quickr connectors 內建對多使用者環境的支援，使用者配置引數儲存在每個 Windows 使用者的登錄檔中，這樣，不同的系統登入使用者擁有各自的場所配置，在使用中不會互相干擾。同時，登錄檔的使用，也使得大規模企業級部署中，不需人為干預的終端環境配置成為可能。

常見的 Lotus Quickr connectors 的使用者配置，例如 Lotus Quickr Server 的 URL，常用的 Quickr Library，都被記錄於 HKEY_CURRENT_USER 分支下的 Software\IBM\Lotus Quickr\Desktop Integration 項中。

在 Lotus Quickr connectors 安裝過程中，常見的多使用者配置問題出現於 Notes 和 Sametime 功能元件的安裝。

多使用者環境下的 Notes.ini 更新

Notes.ini 檔案記錄了 Notes 環境的使用者配置，在單使用者 Notes 系統（Notes SUI）中所有使用者配置相同的資訊，因而只有一份 Notes.ini 通常存放於 Notes 安裝目錄下，例如 C:\Program Files\IBM\Notes。而在多使用者 Notes 系統（Notes MUI）中 Notes 為每個作業系統使用者各分配一個拷貝，每個拷貝都位於不同使用者的 %userprofile%\ Local Settings\Application Data\Lotus\Notes\Data 目錄之下。同時 Notes 在 %alluserprofiles%\Application Data\Lotus\Notes\Data 目錄下存放了一份 Notes.ini 原本，當系統中建立了新使用者後初次開啟 Notes 程式時，這份 Notes.ini 將被拷貝至該新使用者的 %userprofile%\ Local Settings\Application Data\Lotus\Notes\Data 下，作為該使用者的初始配置檔案。

在安裝 Lotus Quickr connectors 的 Notes 功能元件的過程中，安裝包會更新目標 Notes 應用程式的 Notes.ini 配置檔案以修改 Notes 的全域性屬性從而將 Lotus Quickr connectors 整合至 Notes 之中，並相應修改 Notes 的模板屬性。

清單 2. Notes.ini 被更新的部分

				
EXTMGR_ADDINS=nqkrem 
NSF_HOOKS=nqkrhkdr 
AddinMenus=nqkrmn.dll 
$QCInstall=1 

在安裝過程中，Lotus Quickr connectors 安裝包首先根據 HKEY_LOCAL_MACHINE\SOFTWARE\Lotus\Notes 鍵下的 MultiUser 的資料值判斷已安裝 Notes 的型別，如過該值為 1 則該 Notes 為 MUI（Multi-User Install）型別，否則為 SUI（Single-User Install）。

對於 SUI 型別的 Notes，安裝包將直接更新 C:\Program Files\IBM\Notes 下的 Notes.ini 檔案。

而對於 MUI 型別的 Notes，安裝包首先列舉系統上所有使用者，並分別更新 %userprofile%\ Local Settings\Application Data\Lotus\Notes\Data 下的 Notes.ini 檔案。在此之後，安裝包還將更新 %alluserprofiles%\Application Data\Lotus\Notes\Data 下的 Notes.ini 模板。

因此，使用者在安裝 Lotus Quickr connectors 的 Notes 元件完成若發生 Quickr 選單不出現，Mail View 中丟失 Quickr 圖示等問題，可首先檢查本地 Notes 的安裝型別，再相應檢查 C:\Program Files\IBM\Notes 或 %userprofile%\ Local Settings\Application Data\Lotus\Notes\Data 下的 Notes.ini 是否被正常更新為清單 2 中的值，從而判定 Notes.ini 更新過程是否被正確執行。

Notes/Sametime 多使用者環境下的外掛更新

如前面所述，Lotus Notes 8 標準版和 Lotus Sametime 8 都是基於 Lotus Expeditor 架構的程式。Lotus Expeditor 可為多使用者環境的系統建立多個對應的使用者工作目錄（workspace），這樣，每個使用者可以擁有不同的系統配置，例如，不同的使用者可以選擇啟用不同的外掛。

在 Lotus Quickr connectors 的安裝過程中，安裝包將 Lotus Quickr connectors 外掛拷貝至 Lotus Notes 或者 Sametime 的共享外掛目錄中。例如，對於 Lotus Notes 8 標準版，您可在“Notes 安裝目錄”\framework\shared\eclipse\features 和“Notes 安裝目錄”\framework\shared\eclipse\plugins 資料夾下找到 Lotus Quickr connectors 的外掛檔案（見清單 3）。對於 Lotus Sametime 8，您可在“Sametime 安裝目錄”\shared\eclipse\features 和“Sametime 安裝目錄”\shared\eclipse\plugins 資料夾下找到 Lotus Quickr connectors 的外掛檔案（見清單 4）。

清單 3. Notes feature 列表

				
com.ibm.quickr.client.common.feature_8.2.0 
com.ibm.quickr.client.service.feature_8.2.0 
com.ibm.quickr.notes.feature_8.2.0 

				
com.ibm.quickr.client.common.feature_8.2.0 
com.ibm.quickr.client.service.feature_8.2.0 
com.ibm.quickr.sametime.feature_8.2.0 

同時，安裝包將更新“Notes 安裝目錄”\framework\rcp 或“Sametime 安裝目錄”\rcp 目錄下的 rcplauncher.properties 檔案，將其中的 provisioning.manifest.version 欄位自增。對於多使用者環境的 Notes 8 標準版和 Sametime 8 系統，自增該值將在下次啟動 Notes 或 Sametime 時為當前使用者啟用新安裝於 shared 目錄下的新外掛。

因而，使用者如發生安裝後 Notes 和 Sametime 外掛皮膚不能顯示的情況（圖 7），可先確定相應外掛檔案是否已被拷貝至 shared 目錄，自增 rcplauncher.properties 中 provisioning.manifest.version 欄位值，並重啟 Lotus Notes 或 Lotus Sametime。

圖 7. Notes/Sametime 外掛皮膚

靜默安裝

為支援企業級部署，Lotus Quickr connectors 安裝包同樣支援靜默安裝。詳細的安裝引數列表可參見文件“靜默安裝”。靜默安裝支援幾乎 GUI 安裝提供的所有安裝功能，包括安裝，解除安裝，新增刪除功能元件。

由於靜默安裝沒有顯式的介面可見，因而在靜默安裝過程中發生的錯誤必須通過瀏覽安裝日誌檔案才能獲得。詳情請參見 從安裝日誌檔案獲得線索 一節。

如果您需要跟蹤靜默安裝的過程以確認靜默安裝完畢，請在 Windows 系統下鍵入 Ctrl+Shift+Esc 鍵開啟工作管理員。Lotus Quickr connectors 安裝包的執行程式名為 qkrconn.exe，當此程式消失，即表明安裝過程已經完成或中斷。此時您可開啟安裝日誌檔案並結合 WiLogUtl 工具進行分析。

使用系統使用者安裝

在 Windows XP 環境下，使用者可以使用計劃任務命令 at 設定在某特定時間安裝 Lotus Quickr connectors，例如 at 23:00 c:\qkrconn.exe /install /quiet 將在 23 點以靜默安裝的方式部署 Lotus Quickr connectors。

at 命令的一個特殊之處在於它將以系統帳號 system 而不是使用通常的登入使用者來啟動被計劃的程式。

system 帳號是 Windows 系統的超級管理員帳號，擁有操作 Windows 系統的幾乎所有的許可權。普通的 Windows 應用程式很少為 system 賬戶設計和初始化，例如 Lotus Notes 的多使用者安裝版本（MUI）通常只為系統的普通使用者初始化，而在為 Lotus Notes 安裝 Lotus Quickr connectors 外掛時 Lotus Notes 將發現自身並未初始化完成。

初始釋出的 Lotus Quickr connectors 8.2 gold 版本並不支援在 system 帳號下的對 MUI 版本的 Notes 進行 connector 整合，使用者可以下載最新的 connectors hotfix 安裝包 獲得此項功能。

Vista User Account Control 安裝

Microsoft 在 Windows Vista 中加入了一種新的安全控制機制 User Account Control（以下簡稱 UAC），它要求使用者在執行可能會影響計算機執行的操作或執行更改影響其他使用者的設定的操作之前，提供許可權或管理員 ‌ 密碼。

UAC 在帶來安全效能提高的同時也限制了程式的安裝，在 Lotus Quickr connectors 的下一個版本中會全面支援 UAC 啟用情況下的安裝。目前您可以通過在 Windows“控制皮膚”→“使用者帳戶”中，點選“開啟或關閉使用者帳戶控制”一項將 UAC 置為關閉狀態後進行 Lotus Quickr connectors 安裝，並在安裝在同樣位置開啟 UAC 控制，即可正常完成程式的安裝。

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