如何安装 Microsoft Dynamics AX 修补程序

应用对象
Microsoft Dynamics AX 2009 Microsoft Dynamics AX 4.0

Microsoft Business Solutions-Axapta 3.0 现在是 dynamics AX 3.0 Microsoft 的一部分。 对 Microsoft Business Solutions-Axapta 和 Microsoft Axapta 的所有引用都与 Microsoft Dynamics AX 相关。

简介

本文提供了有关如何安装 dynamics AX 2012 Microsoft 修补程序的文档的链接。 它还介绍了如何安装适用于 Microsoft Dynamics AX 2009 和 Microsoft Dynamics AX 4.0 的修补程序。

注意 请务必全面查看Microsoft知识库文章,该文章记录了特定的修补程序,以确定对象、数据库表或将受影响的文件。

详细信息

针对 Microsoft Dynamics AX 2012 发布的修补程序

TechNet 上介绍了将更新和修补程序安装到 Microsoft Dynamics AX 2012 的详细过程: 应用更新和修补程序

针对 Microsoft Dynamics AX 2009 和 Microsoft Dynamics AX 4.0 发布的修补程序

注意 以下白皮书介绍了将更新和修补程序安装到 Microsoft Dynamics AX 2009 的常规过程: 为 Dynamics AX 2009 提供服务Microsoft

Microsoft使用以下格式发布适用于 Microsoft Dynamics AX 的修补程序:

  • 修补程序作为压缩 (.zip) 文件发布。 .zip 文件包含的文件将替换计算机上的现有文件。
  • 修补程序作为 windows Installer 更新Microsoft发布。 这些修补程序包含 Setup.exe 文件。

Microsoft发布以下格式的 Microsoft Dynamics AX 4.0 修补程序:

  • 修补程序作为 Windows Installer 更新Microsoft发布。 这些修补程序包含 Setup.exe 文件。
  • 修补程序作为 DIS 层文件 (AxDIS.aod) 发布,或作为 DIP 层文件 (AxDIP.aod) 发布。 DIS 层更改解决了 SYS 层代码中的问题。 DIP 层更改解决了 GLS 层代码中的问题。
  • 很少会以包含代码的 .xpo 文件的形式发布修补程序。 代码应用于现有对象和/或数据库表。

替换文件的修补程序的一般准则

某些Microsoft Dynamics AX 修补程序将替换计算机上的文件。 有关如何安装替换文件的修补程序的说明,请仔细阅读修补程序下载附带的文档。 下面是有关安装替换文件的修补程序的一般建议:

  • 在将修补程序中包含的文件复制到计算机之前,请使用常用的备份过程来备份受修补程序影响的服务器文件。

  • 测试测试环境中的所有修补程序,验证自定义项是否未受到不利影响。

  • 让所有用户注销 Microsoft Dynamics AX 客户端应用程序。 在重命名和复制修补程序文件之前,请停止 Application Object Server (AOS) 实例。

  • 当标签文件包含在修补程序中时,将所有包含的标签文件复制到 Microsoft Dynamics AX 应用程序文件夹。 标签文件将具有以下文件扩展名:

    • 。阿里
    • 。Acd
    • 。Alc

    默认情况下,应用程序文件夹具有以下路径:
    根目录\Axapta Application\appl\StandardNote 在此路径中, 根目录 表示硬盘驱动器和安装 Microsoft Dynamics AX 的主目录。

自定义环境

如果在安装修补程序之前自定义了环境,请仔细查看Microsoft知识库文章,该文章记录了要安装的修补程序。 将覆盖受修补程序影响的任何对象。 这可能会导致这些对象中的自定义项丢失。

数据库备份

如果数据库表受到影响,请在应用修补程序之前创建完整数据库备份。 有关如何备份数据库的说明,请参阅Microsoft SQL Server文档。 或者,请参阅 Oracle 数据库服务器文档。

安装信息

针对 Microsoft Dynamics AX 2009 发布的修补程序

若要安装作为 Microsoft Dynamics AX 2009 的应用程序更新发布的修补程序,请执行以下步骤:

  1. 从包中提取文件。

  2. 打开修补程序包中的 kbxxxxxx.txt 文件,确定安装修补程序时将修补哪些对象。

  3. 退出所有Microsoft Dynamics AX 2009 客户端,然后停止 AOS 实例。

  4. 备份数据库。

  5. 备份应用程序文件夹。

  6. 重启 AOS 实例,然后在运行 AOS 服务的服务器上查看应用程序日志,以确保 AOS 实例正确启动。 AOS 实例重新生成应用程序对象索引。 Axapd.aoi 文件包含应用程序对象索引。 

    注意 根据所使用的服务器硬件,AOS 实例的启动可能会在该过程完成之前超时。 出现此问题的原因是,在 AOS 尝试使用该文件之前,进程没有足够的时间来重新生成 Axapd.aoi 文件。 

    在完成 *.aoi 文件重新生成之前,AOS 实例将保持启动状态。 此时,AOS 实例具有“已启动”状态。 无需执行其他步骤。 等待重新生成完成,然后查看应用程序日志以获取 AOS 实例启动的指示。

  7. 运行应用程序修补程序安装的 Axpatch.exe 文件。

    1. 选择要运行安装的语言,然后单击“ 确定”。

    2. 安装程序向导启动时,单击“ 下一步”。

    3. 查看Microsoft软件许可条款,单击以选中“检查”框以接受许可条款(如果同意),然后单击“下一步”。

    4. “选择组件” 页上,默认情况下应选择“ 应用程序文件 ”选项。 单击“下一步”。

    5. “选择配置” 页上,指示正确的配置,然后单击“ 下一步”。

    6. “准备应用修补程序 ”页上,单击“ 安装”。

    7. 安装完成后,单击“ 完成 ”退出向导。

  8. 在客户端中,验证是否可以以 dynamics AX 管理员身份Microsoft连接到 AOS 实例。

  9. 通过执行以下操作验证修补程序的安装:

    • 在 AOT 中打开 SysHotfixManifest 类。
    • 验证 类是否包含一个方法,该方法的名称与已安装修补程序的序列号相同。
  10. 使用代码升级工具 (“代码比较”) 将 SYP 或 GLP 更改与任何 VAR 或 CUS 层进行比较。 如果存在自定义项,可能需要合作伙伴或客户的 IT 人员将修补程序合并到自定义系统中。

作为 Windows Installer 更新发布的修补程序

重要提示 必须执行以下操作:

  • 必须在每个 AOS 服务器上安装 ObjectServer 内核文件。
  • 必须在每台客户端计算机上安装客户端内核文件。
  • NetBusinessConnector 内核文件和 ComBusinessConnector 内核文件必须安装在运行 Microsoft Dynamics AX .NET Business Connector 和 Microsoft Dynamics AX Com Business Connector 的每台计算机上。
  • ApplicationIntegrationServer 内核文件是 BizTalk 适配器。 更新 BizTalk 适配器时,请确保将 ApplicationIntegrationServer 内核文件与 NetBusinessConnector 内核文件一起安装。

Windows Installer 更新更新以下Microsoft Dynamics AX 4.0 客户端二进制文件:

  • .exe 文件
  • .dll 文件

这些文件也称为内核文件。 若要应用 Windows Installer 更新,请执行以下步骤:

  1. 从修补程序中提取文件。 提取的文件可能包含以下文件夹:

    • ApplicationIntegrationServer
    • 客户端
    • ComBusinessConnector
    • NETBusinessConnector
    • ObjectServer
  2. 在测试环境中测试修补程序。 然后,计划停机时间。

  3. 退出所有Microsoft Dynamics AX 软件客户端。 然后,关闭连接到生产程序文件共享的 AOS 实例。

  4. 备份数据库,然后备份应用程序文件夹。

  5. 运行修补程序中每个文件夹中包含的 Setup.exe 文件。

  6. 重启 AOS 实例。 查看运行 AOS 服务的服务器上的应用程序事件日志,以确保 AOS 实例正确启动。 AOS 实例重新生成应用程序对象索引。 Axapd.aoi 文件包含应用程序对象索引。

    注意 根据所使用的服务器硬件,AOS 实例的启动可能会在该过程完成之前超时。 出现此问题的原因是该过程没有足够的时间来重新生成 Axapd.aoi 文件。

  7. 使用 Microsoft Dynamics AX 4.0 管理员帐户,使用 AOS 实例登录到客户端。 验证是否可以成功连接。

作为包含代码的 .xpo 文件发布的修补程序

作为 .xpo 文件发布的修补程序包含代码级修补程序,这些修补程序直接影响 Microsoft Dynamics AX 中的对象或数据库表。

重要提示 在继续之前,请检查每个 .xpo 文件以查找将更改的对象或表。 请注意当前环境可能受影响的任何自定义项。 强烈建议在将修补程序应用到实时系统之前,在测试环境中应用所有修补程序。

  1. 使用 Microsoft Dynamics AX 管理员帐户登录到 Microsoft Dynamics AX。 确保没有其他用户登录到 Microsoft Dynamics AX。

  2. 打开“ 应用程序对象树 ”对话框。 为此,请使用下列方法之一:

    • Standard工具栏上,单击“应用程序对象树”。
    • 在键盘上,按 Ctrl+D。
    • 在“ 文件 ”菜单上,指向“ 打开”,然后单击“ 应用程序对象树”。
  3. 在“ 应用程序对象树 ”对话框中,单击工具栏上的“ 导入 ”。

  4. 单击“ 浏览”,然后找到 .xpo 文件。

  5. 在“ 打开 ”对话框中,单击 .xpo 文件,然后单击“ 打开”。

  6. 单击“ 确定” 完成导入过程。

    注意 可能需要完成前向编译或完整的应用程序对象树 (AOT) 编译过程。

如何安装作为 DIS 层或 DIP 层文件发布的修补程序

若要安装作为 DIS 层或 DIP 层文件发布的修补程序,请执行以下步骤:

  1. 从修补程序包中提取文件。

  2. 在将修补程序中包含的文件复制到计算机之前,请使用常用的备份过程备份受修补程序影响的应用程序文件夹和服务器文件。

  3. 在测试环境中测试修补程序。 然后,在系统上没有其他用户时计划停机时间。

  4. 退出所有Microsoft Dynamics AX 软件客户端。 然后,关闭连接到生产程序文件共享的应用程序对象服务器实例。

  5. 将 AxDIS.aod 文件和 AxDISen-us.ald 文件复制到其他 .aod 文件所在的每个应用程序文件夹中。 默认情况下,此文件夹位于以下位置:
    \application\appl\standardNote 在此步骤中,始终使用 copy 函数。 请勿使用移动函数。 移动文件时,将为此文件获取源文件夹的权限。 复制文件时,它将获取目标文件夹的权限。

  6. 通过重命名文件,创建 Axapd.aoi 文件的备份副本。 或者,删除每个应用程序文件夹中的 Axapd.aoi 文件。

  7. 重启 AOS 实例。 查看运行 AOS 实例的服务器上的应用程序日志,确保 AOS 实例正确启动。 AOS 实例重新生成应用程序对象索引。 Axapd.aoi 文件包含应用程序对象索引。

    注意 根据所使用的服务器硬件,AOS 实例的启动可能会在该过程完成之前超时。 出现此问题的原因是该过程没有足够的时间来重新生成 Axapd.aoi 文件。

    在重新生成 .aoi 文件之前,AOS 实例将保持启动状态。 此时,AOS 实例将具有“已启动”状态。 无需执行其他步骤。 等待重新生成完成,然后查看应用程序日志以获取 AOS 实例已启动的指示。

  8. 使用 Microsoft Dynamics AX 4.0 管理员帐户,使用 AOS 实例登录到客户端计算机。 接下来,使用客户端软件连接到此 AOS 实例,验证是否可以成功连接。 最后,验证Microsoft Dynamics AX 是否检测到更改,以及它们是否在 AOT 中可见。

  9. 如果出现升级清单,请完成清单,确保不会出现其他问题。 如果未显示升级清单,则无法识别 DIS 或 DIP 层。 如果未识别 DIS 或 DIP 层,请使用以下一种或多种方法:

    • 创建新的应用程序文件夹。 然后,将所有文件从现有应用程序文件夹复制到新的应用程序文件夹。

    • 更改 AOS 实例配置以使用新的应用程序文件夹。 请按以下步骤完成此操作:

      1. 单击 “开始”,单击“ 运行”,键入“控制管理员工具”,然后单击“ 确定”。

      2. 双击 “Microsoft Dynamics AX 配置实用工具”。

      3. 在“ 应用程序对象服务器 ”选项卡上,选择在应用程序实例列表中创建的新应用程序文件夹。

      4. 应用配置,然后重启 AOS 实例。

      5. 重复步骤 8。

  10. 完成清单后,重新编译整个应用程序。

  11. 如果使用多个应用程序文件夹和多个 AOS 实例,请停止所有 AOS 实例,然后重启所有 AOS 实例。

参考资料

有关 .xpo 文件的导入选项的详细信息,请参阅 dynamics AX 开发人员指南Microsoft。

本文中提到的第三方产品由 Microsoft 以外的其他公司提供。 Microsoft 不对这些产品的性能或可靠性提供任何明示或暗示性担保。