转自 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）的情况。

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 控制，即可正常完成程序的安装。