远程组件配置工具启动过程探析-Kingdee

远程组件配置工具启动过程探析

本期概述

●本文档适用于K/3所有版本。

●本文档从K/3客户端运行远程组件配置工具，“按模块设置中间层服务器”下方的

模块列表中显示空白的情况出发，以K/3WISEV12.2为例，利用跟踪工具跟踪程序启动过程，建立假设并进行一一验证。通过本文档的学习可以了解K/3客户端远程组件配置工具启动过程中后台文件的调用情况，并学会处理模块列表空白等常见问题。

版本信息

●2012年03月29日 V1.0 编写人：张晓宇

●2012年02月30日 V2.0 审核人：杨吉

版权信息

●本文件使用须知

著作权人保留本文件的内容的解释权，并且仅将本文件内容提供给阁下个人使用。对于内容中所含的版权和其他所有权声明，您应予以尊重并在其副本中予以保留。您不得以任何方式修改、复制、公开展示、公布或分发这些内容或者以其他方式把它们用于任何公开或商业目的。任何未经授权的使用都可能构成对版权、商标和其他法律权利的侵犯。如果您不接受或违反上述约定，您使用本文件的授权将自动终止，同时您应立即销毁任何已下载或打印好的本文件内容。

著作权人对本文件内容可用性不附加任何形式的保证，也不保证本文件内容的绝对准确性和绝对完整性。本文件中介绍的产品、技术、方案和配置等仅供您参考，且它们可能会随时变更，恕不另行通知。本文件中的内容也可能已经过期，著作权人不承诺更新它们。如需得到最新的技术信息和服务，您可向当地的金蝶业务联系人和合作伙伴进行咨询。

著作权声明著作权所有 2012 金蝶软件（中国）有限公司。

所有权利均予保留。

目录

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)

1. 问题描述

在独立的K/3客户端上，依次打开【开始】→【程序】→【金蝶 K3 WISE创新管理平台】→【金蝶 K3 工具】→【远程组件配置工具】，在弹出的【金蝶组件配置及测试工具】窗口中，当选择【按模块设置中间层服务器】时，正常情况下，列表中将显示K/3的模块名称、服务器名称（或IP地址）以及模块说明等内容，如图-1所示。

图-1 远程组件配置工具正常显示

但在客户异常环境下，时常遇到远程组件配置工具列表内容显示为空白，此时看不到任何模块信息等内容，如图-2所示。

图-2 远程组件配置工具异常显示

2. 原因分析

2.1 程序跟踪

1. 使用跟踪工具跟踪发现，远程组件配置工具（\K3ERP\KDSYSTEM\WebCnfgN.exe）在启动过程中，会先后读取同一路径下的两个配置文件，分别为：KdLogin.Lst和KDCom.cfg，如图-3所示。

图-3 跟踪工具跟踪结果

2. 分别以记事本方式打开这两个文件，根据文件记录信息可以知道，【KdLogin.Lst】文件用于存放客户端VBR文件的列表信息，如图-4所示。而【KDCom.cfg】文件用于存放远程组件配置工具的相关信息，例如是否使用单一服务器，服务器的地址，各个模块的名称、代码、说明，以及各个模块的组件名称以及注册的服务器地址，如图-5、图-6、图-7所示。

图-4 KdLogin.Lst文件内容查看

图-5 KDCom.cfg文件内容查看(1)

图-6 KDCom.cfg文件内容查看(2)

图-7 KDCom.cfg文件内容查看(3)

3. 继续跟踪发现，远程组件配置工具在启动过程中，除了频繁地调用前面提到的两个文件以外，还会调用K3InstallPackage.lst文件，该文件中保存了各类行业产品特性包的信息，并且会依次访问各个模块组件包下的第一个组件对应的VBR文件，并读取相应的注册表CLSID项键值，分别如图-8、图-9所示：

图-8 跟踪工具跟踪VBR文件访问

图-9 跟踪工具跟踪注册表信息读取

2.2 建立假设

基于以上跟踪得到的结果，假设远程组件配置工具在启动过程中执行的操作包含：

①读取K3InstallPackage.lst文件，确认中间层服务器安装了哪些类型的K/3行业产品（除了标准产品之外，每个类型的行业产品也有各自的COM+组件，对应不同的VBR文件）；

②读取KdLogin.Lst文件，根据K/3产品类型，确认在服务器上安装了哪些组件，以此进一步确认客户端需要检查和注册哪些VBR文件；

③读取KDCom.cfg文件，根据配置文件中的参数，显示每个模块的名称、服务器地址、说明，是否使用单一的中间层服务器，以及中间层服务器地址。

注意：每个模块的对应中间层服务器地址，是根据各个模块下的第一个COM+组件对应的VBR文件在注册表中记录的服务器地址来标识的（HKEY_CLASSES_ROOT\AppID\{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX}\RemoteServerName 键值）；如果没有读取到，在远程组件配置列表中默认显示本机计算机名。

④加载其他必要的文件和组件，界面显示完毕。

2.3 假设验证

1.在客户端上修改K3InstallPackage.lst文件，将节点中的“Installed=False”参数全部改为“True”，如图-10所示，伪装客户端上安装了行业产品。再打开远程组件配置工具，则【按模块设置中间层服务器】列表中的模块增加了对应的行业产品，如图-11所示。以上测试过程说明假设①成立。

图-10 更改K3InstallPackage.lst文件内容

图-11 远程组件配置工具显示行业产品

2. 删除或修改KdLogin.Lst文件，远程组件配置工具测试结果会提示“位于KDCom.cfg