上一主题: 故障排除和提示下一主题: .NET 代理属性

故障排除和提示 › 更正代理扩展的版本信息

更正代理扩展的版本信息

扩展的版本号可能与 .NET 代理的版本号不同，具体取决于何时安装 .NET 代理以及任何可选扩展。 在大多数情况下，如果 .NET 代理和扩展之间的版本信息不同，代理会记录错误消息，而扩展将无法正常运行。 要更正此类问题，可以手动更新版本信息。 根据您的环境，执行以下操作之一：

重要信息：仅选择一个选项；不要同时执行两个选项。

逐个为应用程序配置版本信息：

  1. 如果要安装的扩展是常规的 .exe，请创建一个名为 <Extension_Name>.exe.config 的文件，并将此文件放在原始 .exe 所在的同一目录下。
  2. 如果扩展是 IIS 应用程序，请创建一个名为 w3wp.exe.config 的文件，并将其放在 w3wp.exe 所在的同一目录下。 这适用于默认域。
  3. 如果扩展是 IIS 应用程序，还要将以下内容添加到每个应用程序的 web.config： 
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
   <dependentAssembly>
      <assemblyIdentity name="..." .../>
      <bindingRedirect oldVersion="0.0.0.0 - 65535.65535.65535.65535" newVersion="<AGENT.VERSION.NUMBER>"/>
   </dependentAssembly>
</assemblyBinding>

    为 assemblyIdentity name 输入相应的内容，并将代理版本号替换为您的 .NET 代理版本号。 版本信息应包括四位数。 例如，如果安装了 9.0.7 版本的 .NET 代理，则应添加以下内容：

    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
   <dependentAssembly>
      <assemblyIdentity name="wily.Agent"   publicKeyToken="2B41FDFB6CD662A5"/>
      <bindingRedirect oldVersion="9.0.5.0 - 65535.65535.65535.65535" newVersion="9.0.7.0" />
   </dependentAssembly>
</assemblyBinding>

注意：如果以上文件已存在，请在 <runtime> 下添加 <assemblyBinding> 节点。

全局配置所有应用程序：

注意：将该代码段添加到 machine.config 中会全局影响所有应用程序。

选择使用还是禁用 hotdeploy 目录

通过 hotdeploy 目录，您可以在不编辑 IntroscopeAgent.profile 甚至不重新启动托管应用程序的情况下部署新指令。 在使用此功能时需特别谨慎。 如果您的自定义 PBD 包含无效语法或者配置为收集过多度量标准，将会更快地受到影响。 无效的 PBD 会导致 NativeProfiler 关闭，收集过多度量标准的 PBD 会影响应用程序的性能。

为解决此问题，CA Technologies 建议：

当新 PBD 放在 hotdeploy 目录下时，.NET 代理会自动部署该新 PBD。 但是，只有重新启动应用程序后，新增或更改过的 PBD 才会影响已在运行的类和应用程序。

注意：您只能部署 hotdeploy 目录中的 PBD 文件。 代理将忽略放置在该目录中的任何 ProbeBuilder 列表 (PBL)。

如果要防止自动部署无效的 PBD 文件，可以禁用 hotdeploy 目录。

禁用 hotdeploy 目录：

  1. 将存储在 hotdeploy 目录中的所有自定义 PBD 移到 <Agent_Home> 目录。
  2. 在文本编辑器中打开 IntroscopeAgent.profile。
  3. 从 introscope.autoprobe.directivesFile 属性中删除 hotdeploy。
  4. 将要使用的自定义 PBD 添加到 introscope.autoprobe.directivesFile。 例如： 
    introscope.autoprobe.directivesFile=default-typical.pbl,custom1.pbd,custom2.pbd,custom3.pbd
  5. 保存 IntroscopeAgent.profile 并重新启动代理。