如何安装 Microsoft Dynamics AX 修补程序

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

简介

本文提供了有关如何安装 Microsoft Dynamics AX 2012 修补程序的文档链接。 它还介绍了如何安装 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 更新和修补程序的常规过程： 服务 Microsoft Dynamics AX 2009。

Microsoft 以以下格式发布了 Microsoft Dynamics AX 修补程序：

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

Microsoft 以以下格式发布了 Microsoft Dynamics AX 4.0 修补程序：

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

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

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

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

• 在测试环境中测试所有修补程序，以验证自定义项不会受到负面影响。

• 让所有用户注销 Microsoft Dynamics AX 客户端应用程序。 在重命名和复制修补程序文件之前，请停止 AOS) 实例 (应用程序对象服务器。

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

  • .ali
  • .acd
  • .alc

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

自定义环境

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

数据库备份

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

安装信息

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

若要安装作为 Microsoft Dynamics AX 2009 应用程序更新发布的修补程序，请按照下列步骤操作：

1. 从包中提取文件。

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

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

4. 备份数据库。

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

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

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

   AOS 实例将保持处于启动状态，直到 *.aoi 文件重建完成。 此时，AOS 实例处于“已启动”状态。 不需要执行其他步骤。 等待重新生成完成，然后查看应用程序日志以获取 AOS 实例启动的指示。

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

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

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

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

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

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

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

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

8. 从客户端，验证您是否可以作为 Microsoft Dynamics AX 管理员连接到 AOS 实例。

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

   • 打开 AOT 中的 SysHotfixManifest 类。
   • 验证类中是否包含一个方法，其名称与已安装修补程序的文章编号相同。

10. 使用代码升级工具 (“代码比较”) 将 SYP 或 GLP 更改与任何 VAR 或 CUS 层进行比较。 如果存在自定义项，则可能需要合作伙伴或客户的 IT 人员将修补程序合并到自定义系统中。

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

重要说明必须执行以下操作：

• ObjectServer 内核文件必须安装在每个 AOS 服务器上。
• 客户端内核文件必须安装在每台客户端计算机上。
• 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. 使用 AOS 实例，通过 Microsoft Dynamics AX 4.0 管理员帐户登录到客户端。 验证是否可以成功连接。

作为包含代码的 .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 软件客户端。 然后，关闭连接到生产程序文件共享的 Application Object Server 实例。

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

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

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

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

   AOS 实例将保持处于启动状态，直到重新生成 .aoi 文件。 此时，AOS 实例将处于“已启动”状态。 不需要执行其他步骤。 等待重新生成完成，然后查看应用程序日志，以获取 AOS 实例已启动的指示。

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

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

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

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

     1. 单击 “开始”，单击 “运行”，键入“Control Admintools”，然后单击“ 确定”。

     2. 双击“ Microsoft Dynamics AX 配置实用程序”。

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

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

     5. 重复步骤 8。

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

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

参考资料

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

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