金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 1 页 共 12 页 远程组件配置远程组件配置工具启动过程探析工具启动过程探析 本文档适用于 K/3 所有版本。 本文档从 K/3 客户端运行远程组件配置工具， “按模块设置中间层服务器”下方的 模块列表中显示空白的情况出发，以 K/3WISEV12.2 为例，利用跟踪工具跟踪程序 启动过程， 建立假设并进行一一验证。 通过本文档的学习可以了解 K/3 客户端远程 组件配置工具启动过程中后台文件的调用情况， 并学会处理模块列表空白等常见问 题。 2012 年 03 月 29 日 V1.0 编写人： 张晓宇 2012 年 02 月 30 日 V2.0 审核人： 杨吉 本文件使用须知 著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。 对于内容中所含的版权和其他所有权声明， 您应予以尊重并在其副本中予以保留。 您不 得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于 任何公开或商业目的。 任何未经授权的使用都可能构成对版权、 商标和其他法律权利的 侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即 销毁任何已下载或打印好的本文件内容。 著作权人对本文件内容可用性不附加任何形式的保证， 也不保证本文件内容的绝对 准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们 可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更 新它们。 如需得到最新的技术信息和服务， 您可向当地的金蝶业务联系人和合作伙伴进 行咨询。 著作权声明 著作权所有 2012 金蝶软件（中国）有限公司 。 所有权利均予保留。 本期概述 版本信息 版权信息 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 2 页 共 12 页 目目 录录 1. 问题描述 . 3 2. 原因分析 . 4 2.1 程序跟踪 . 4 2.2 建立假设 . 6 2.3 假设验证 . 7 3. 常见问题及解决方法 . 10 3.1 K/3 远程组件配置工具打开提示错误 . 10 3.2 远程组件配置工具服务器地址更改无效 . 10 4. 总结. 12 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 3 页 共 12 页 1. 1. 问题描述问题描述 在独立的 K/3 客户端上，依次打开【开始】【程序】【金蝶 K3 WISE 创新管理平台】【金蝶 K3 工具】【远程组件配置工具】 ，在弹出的【金蝶组件配置及测试工具】窗口中，当选择【按模块设置中间层服务器】时，正常情况下，列表中将显示 K/3 的模块名称、服务器名称（或 IP 地址）以及模块说明等内容，如图-1 所示。 图-1 远程组件配置工具正常显示 但在客户异常环境下， 时常遇到远程组件配置工具列表内容显示为空白， 此时看不到任何模块信息等内容，如图-2 所示。 图-2 远程组件配置工具异常显示 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 4 页 共 12 页 2. 2. 原因分析原因分析 2 2.1 .1 程序跟踪程序跟踪 1. 使用跟踪工具跟踪发现，远程组件配置工具（K3ERPKDSYSTEMWebCnfgN.exe）在启动过程中， 会先后读取同一路径下的两个配置文件， 分别为： KdLogin.Lst 和 KDCom.cfg，如图-3 所示。 图-3 跟踪工具跟踪结果 2. 分别以记事本方式打开这两个文件，根据文件记录信息可以知道， 【KdLogin.Lst】文件用于存放客户端 VBR 文件的列表信息，如图-4 所示。而【KDCom.cfg】文件用于存放远程组件配置工具的相关信息，例如是否使用单一服务器，服务器的地址，各个模块的名称、代码、说明，以及各个模块的组件名称以及注册的服务器地址，如图-5、图-6、图-7 所示。 图-4 KdLogin.Lst 文件内容查看 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 5 页 共 12 页 图-5 KDCom.cfg 文件内容查看(1) 图-6 KDCom.cfg 文件内容查看(2) 图-7 KDCom.cfg 文件内容查看(3) 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 6 页 共 12 页 3. 继续跟踪发现，远程组件配置工具在启动过程中，除了频繁地调用前面提到的两个文件以外，还会调用 K3InstallPackage.lst 文件，该文件中保存了各类行业产品特性包的信息， 并且会依次访问各个模块组件包下的第一个组件对应的 VBR 文件， 并读取相应的注册表 CLSID 项键值，分别如图-8、图-9 所示： 图-8 跟踪工具跟踪 VBR 文件访问 图-9 跟踪工具跟踪注册表信息读取 2.2 2.2 建立假设建立假设 基于以上跟踪得到的结果，假设远程组件配置工具在启动过程中执行的操作包含： 读取 K3InstallPackage.lst 文件， 确认中间层服务器安装了哪些类型的 K/3 行业产品 （除了标准产品之外， 每个类型的行业产品也有各自的 COM+组件， 对应不同的 VBR 文件） ； 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 7 页 共 12 页 读取 KdLogin.Lst 文件，根据 K/3 产品类型，确认在服务器上安装了哪些组件，以此进一步确认客户端需要检查和注册哪些 VBR 文件； 读取 KDCom.cfg 文件， 根据配置文件中的参数， 显示每个模块的名称、 服务器地址、说明，是否使用单一的中间层服务器，以及中间层服务器地址。 注意：每个模块的对应中间层服务器地址，是根据各个模块下的第一个 COM+组件对应的VBR文件在注册表中记录的服务器地址来标识的（HKEY_CLASSES_ROOTAppIDXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXRemoteServerName键值） ；如果没有读取到，在远程组件配置列表中默认显示本机计算机名。 加载其他必要的文件和组件，界面显示完毕。 2 2. .3 3 假设验证假设验证 1.在客户端上修改 K3InstallPackage.lst 文件，将节点中的“Installed=False”参数全部改为“True” ，如图-10 所示，伪装客户端上安装了行业产品。再打开远程组件配置工具， 则 【按模块设置中间层服务器】 列表中的模块增加了对应的行业产品， 如图-11 所示。以上测试过程说明假设成立。 图-10 更改 K3InstallPackage.lst 文件内容 图-11 远程组件配置工具显示行业产品 2. 删除或修改 KdLogin.Lst 文件， 远程组件配置工具测试结果会提示 “位于 KDCom.cfg金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 8 页 共 12 页 而中间层没有的组件” ，如图-12 所示。以上测试过程说明假设成立。 图-12 删除或修改 KdLogin.Lst 文件后测试结果 3. 删除或修改 KDCom.cfg 文件，远程组件配置工具测试结果会提示“中间层有但不存在于 KDCom.cfg 中的组件” ，如图-13 所示。以上测试过程说明假设成立。 图-13 删除或修改 KDCom.cfg 文件后测试结果 4. 修改加密服务、公共组件以及系统服务组件包中第一个组件在注册表中的RemoteServerName 键值，如图-14 所示，打开远程组件配置工具，则对应的模块注册服务器地址显示为手工修改后的地址，如图-15 所示。以上测试过程说明假设成立。 金蝶知识库文档 金蝶软件（中国）有限公司 客户服务中心 第 9 页 共 12 页 图-14 修改注册表中 RemoteServerName 键值 图-15 修改注册表后模块服务器地址变更 5删除 KdLogin.Lst 和 KDCom.cfg 文件，则出现本文开篇提到的问题现象，如图-16所示，从而验证了整个假设的成立。 金蝶知识库文档 金蝶软件 （中国） 有限公司 客户服务中心 第 10 页 共 12 页 图-16 删除 KdLogin.Lst 和 KDCom.cfg 文件模块列表显示空白 3. 3. 常见问题及常见问题及解决方法解决方法 了解了远程组件配置工具启动过程的原理， 我们就可以根据不同的异常现象， 对问题进行分析处理。 3 3.1 .1 K/3K/3 远程组件配置工具远程组件配置工具打开提示打开提示错误错误 问题现象：打开 K/3 远程组件配置工具，出现如下几种错误提示： 1. “位于 KDCom.cfg 而中间层没有的组件” ； 2. “中间层有但不存在于 KDCom.cfg 中的组件” ； 3. 模块列表框信息显示空白。 问题分析： 以上问题现象都是由于 KdLogin.Lst 和 KDCom.cfg 两个文件损坏、 丢失， 造成两者中的信息不符造成的。