文档AEM 6.5用户指南

AEM 6.5 Forms 服务包安装说明 aem-form-patch-installation-instructions

Last update: Fri Oct 03 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 适用对象：
  • Experience Manager 6.5
  • 主题：

创建对象：

  • 用户
  • 管理员
  • 开发人员

发行版本信息

产品
Adobe Experience Manager 6.5 Forms
版本号
6.5.23.0
类型
服务包发行
日期
2025 年 6 月 6 日
下载 URL
最新 AEM Forms 版本
NOTE
请参阅最新的 AEM 服务包发行说明，获取已修复问题的完整列表。

Experience Manager Forms 6.5 包含的功能

Adobe Experience Manager（AEM）Forms 服务包包含了新的和升级的功能，例如客户重点请求的增强功能，以及性能、稳定性和安全性改进。AEM Forms 会定期发布服务包，以提供最新的功能和改进。根据您的技术栈，选择以下路径之一，以在您的环境中下载并安装服务包：

NOTE
  • Adobe 会在每发布六个服务包时发布完整安装程序。AEM 6.5 Forms 服务包 18（6.5.18.0）是最新的 JEE 完整安装程序。完整安装程序支持新平台，而常规服务包安装程序则包含新功能、错误修复和常规改进。如果您计划在 JEE 环境下的 AEM 6.5 Forms 执行全新安装或使用最新的软件，Adobe 建议使用 2023 年 8 月 31 日发布的 JEE 上的 AEM 6.5.18.0 Forms 完整安装程序，而不是使用 2019 年 4 月 8 日发布的 AEM 6.5 Forms 安装程序或 2022 年 3 月 3 日发布的 AEM 6.5.12.0 Forms 安装程序。在使用完整安装程序后，请安装最新的服务包。
  • AEM 6.5 QuickStart 中提供的 AEM Forms 功能（如自适应表单）仅供探索和评估使用。必须获得 AEM Forms 的有效许可证才能用于生产。

在 JEE 环境下的 AEM Form 下载并安装服务包 download-and-install-for-jee-service-pack

<>1. 备份您现有的环境
  1. 备份您的 CRX 存储库、数据库架构和 GDS（全局文档存储）。
  2. 备份 AEM_forms_root>/deploy 文件夹。
note note
NOTE
在运行 AEM 服务包安装程序之前，请确保您对 AEM 安装目录具有写入权限。
2.下载所需软件
<>3. 安装 Microsoft Visual C++ 可再发行组件包
note note
NOTE
请务必安装该可再发行组件包，即使系统中已存在旧版本，也需安装以确保最新版本的可用性。
<>4. 安装 JEE 上的 AEM Forms 服务包：

  1. 停止应用程序服务器。

  2. 将 JEE 上的 AEM Forms 服务包安装程序存档 ​提取到您的硬盘驱动器：

    • Windows
      进入安装介质或您复制安装程序的硬盘文件夹中的相应目录，然后双击 aemforms65_cfp_install.exe 文件。

      • （Windows 32 位）Windows\Disk1\InstData\VM
      • （Windows 64 位）Windows_64Bit\ Disk1\InstData\VM

    • Linux®
      进入相应目录，在 Shell 中输入 ./aem65_cfp_install.bin。

      • （Linux®）Linux/Disk1/InstData/NoVM

    这会启动安装向导，引导您完成安装。

  3. 在“Introduction”面板上，单击 Next。

  4. 在​ 选择安装文件夹 ​屏幕上，确认默认显示的位置是否正确匹配您现有的安装，或单击​ 浏览 ​选择 AEM Forms 安装的替代文件夹，然后单击​ 下一步。

  5. 阅读服务包摘要信息，然后单击​ 下一步。

  6. 阅读“Pre-Installation Summary”信息，然后单击 Install。

  7. 安装完成后，单击 Next 以将快速修补程序更新应用到已安装的文件。

  8. [仅适用于 Windows]： ​执行以下步骤之一：

    • 在单击​ 完成 ​之前，取消选择​ 启动配置管理器 ​选项。使用 [aem-forms root]\configurationManager\bin 中的 ConfigurationManager.bat 文件运行​ 配置管理器。

    • 或者在单击​ 完成 ​之前，取消选择​ 启动配置管理器 ​选项。如果要通过 ConfigurationManager.exe 或 ConfigurationManager_IPv6.exe 运行​ 配置管理器，请先进入 <AEMForms_Install_Dir>\configurationManager\bin 目录，将 ConfigurationManager.lax 和 ConfigurationManager_IPV6.lax 替换为最新的 ConfigurationManager.lax 和 ConfigurationManager_IPV6.lax 文件，然后在这两个文件中查找并将 axis-1.4.1.1.jar 替换为 axis-1.4.1.2.jar。

      note note
      NOTE
      • 更新或替换 ConfigurationManager.bat 文件可以避免手动更新 .lax 文件。

  9. **[仅适用于基于 Unix 的系统]：**启动配置管理器 ​复选框默认已选中。单击​ 完成 ​可立即运行配置管理器，或者如果希望稍后再运行​ 配置管理器，请在单击​ 完成 ​之前取消选中​ 启动配置管理器 ​选项。您也可以稍后通过运行 [AEM_forms_root]/configurationManager/bin 目录下的相应脚本来启动​ 配置管理器。

  10. 根据您所使用的应用程序服务器，选择以下文档之一，并按​ 配置和部署 AEM Forms 部分的说明进行操作。

note note
NOTE
  • 安装完 JEE 上的 AEM Forms 服务包后，必须在重启应用程序服务器之前，从 crx-repository\install 文件夹中移除 Forms 附加组件包。从软件分发门户下载最新的 Forms 附加组件包。
  • 建议使用 “Ctrl + C” 命令重新启动 SDK。如果使用其他方式（例如停止 Java 进程）重新启动 AEM SDK，则可能会导致 AEM 开发环境出现不一致情况。
  • 对于用于缓解 JEE 上的 AEM Forms 中 Spring Framework 漏洞的热修复补丁，在群集环境中部署时，必须确保定位器使用 JDK 17 启动。
<>5. 如果尚未安装 Servlet 片段，请进行安装（必需步骤）

下载并安装 Servlet 片段的方法：

  1. 如果尚未下载该片段，请从软件分发下载。

  2. 启动应用程序服务器，等待日志稳定后检查捆绑包状态。

  3. 打开网页控制台捆绑包。默认 URL 为 http://[Server]:[Port]/system/console/bundles。

  4. 单击“安装/更新”。选择已下载的片段 org.apache.felix.http.servlet-api-1.2.0_fragment_full.jar。点击​ 安装 ​或​ 更新。等待应用程序服务器稳定

  5. 停止应用程序服务器。

<>6. 安装 AEM 服务包
  1. 如果实例处于更新模式（即由早期版本升级而来），请在安装前先重启该实例。如果实例已长时间运行，Adobe 建议先重启。
  2. 在安装之前，请为您的 Experience Manager 实例创建快照或执行一次全新的备份。
  3. 从软件分发下载服务包。
  4. 打开包管理器，然后选择​ 上传包 ​以上传该包。如需了解更多信息，请参阅包管理器。
  5. 选择该包，然后选择​ 安装。

自动安装

您可以通过以下两种方式之一自动安装 ExperienceManager 服务包。

  • 当服务器在线时，将包放入 ../crx-quickstart/install 文件夹中。
    该包会自动安装。

  • 使用包管理器的 HTTP API。请使用 cmd=install&recursive=true 以便安装嵌套的包。

    note note
    NOTE
    Experience Manager 服务包不支持 Bootstrap 安装。

    验证安装

    要了解与此版本兼容的已经过认证的平台，请参阅技术要求。

    1. 在已安装的产品下，产品信息页面（/system/console/productinfo）会显示更新后的版本字符串 Adobe Experience Manager (spversion)。
    2. 在 OSGi 控制台中，所有 OSGi 捆绑包均应处于​ 活跃 ​或​ 片段 ​状态（使用网页控制台：/system/console/bundles）。
    3. OSGi 捆绑包 org.apache.jackrabbit.oak-core 的版本应为 1.22.14 或更高版本（使用网页控制台：/system/console/bundles）。
<>7. 安装 AEM Experience Manager Forms 附加组件包
  1. 请确保已安装相应的 Experience Manager 服务包。
  2. 下载适用于您的操作系统的 AEM Forms 发行版中列出的相应 Forms 附加组件包。
  3. 按照安装 AEM Forms 附加组件包中的所述安装 Forms 附加组件包。
  4. 如果您在 Experience Manager 6.5 Forms 中使用书信，请安装最新的 AEMFD 兼容包。

在 OSGi 环境下的 AEM Form 下载并安装服务包 download-and-install-for-osgi-service-pack

<>1. 备份您现有的环境
  1. 备份您的 CRX 存储库和数据库架构。
note note
NOTE
如果您为关系型数据库安装 AEM Forms 服务包，则必须备份 DB_schema。
2.下载所需软件
<>3. 安装 Microsoft Visual C++ 可再发行组件包
note note
NOTE
请务必安装该可再发行组件包，即使系统中已存在旧版本，也需安装以确保最新版本的可用性。
<>4. 安装 AEM 服务包
  1. 如果实例处于更新模式（即由早期版本升级而来），请在安装前先重启该实例。如果实例已长时间运行，Adobe 建议先重启。
  2. 在安装之前，请为您的 Experience Manager 实例创建快照或执行一次全新的备份。
  3. 从软件分发下载服务包。
  4. 打开包管理器，然后选择​ 上传包 ​以上传该包。如需了解更多信息，请参阅包管理器。
  5. 选择该包，然后选择​ 安装。

自动安装

您可以通过以下两种方式之一自动安装 Experience Manager 服务包。

  • 当服务器在线时，将包放入 ../crx-quickstart/install 文件夹中。该包会自动安装。

  • 使用包管理器的 HTTP API。请使用 cmd=install&recursive=true 以便安装嵌套的包。

    note note
    NOTE
    Experience Manager 服务包不支持 Bootstrap 安装。

    验证安装

    要了解与此版本兼容的已经过认证的平台，请参阅技术要求。

    1. 在已安装的产品下，产品信息页面（/system/console/productinfo）会显示更新后的版本字符串 Adobe Experience Manager (spversion)。

    2. 在 OSGi 控制台中，所有 OSGi 捆绑包均应处于​ 活跃 ​或​ 片段 ​状态（使用网页控制台：/system/console/bundles）。

      1. OSGi 捆绑包 org.apache.jackrabbit.oak-core 的版本应为 1.22.14 或更高版本（使用网页控制台：/system/console/bundles）。
<>5. 安装 Adobe Experience Manager Forms（AEM）附加组件包
  1. 请确保已安装相应的 Experience Manager 服务包。
  2. 下载适用于您的操作系统的 AEM Forms 版本中列出的相应 Forms 附加组件包。
  3. 按照安装 AEM Forms 附加组件包中的所述安装 Forms 附加组件包。
  4. 如果您在 Experience Manager 6.5 Forms 中使用书信，请安装最新的 AEMFD 兼容包。

疑难解答

  • 如果在安装服务包过程中​ 包管理器 UI 对话框 ​意外退出，请等待错误日志稳定后再访问部署。在确认安装成功之前，请先等待与卸载更新程序包相关的特定日志出现。通常，该问题会在 Safari 浏览器中出现，但也可能会在其他浏览器中间歇出现。

  • 安装完成后，请检查监控日志（error.log），确认是否还有活动。请等待几分钟，直到日志中不再有任何活动。重启 AEM 实例。

  • 如果在安装 AEM Forms 6.5.15.0 或更高版本的服务包后遇到​ 服务不可用错误，请安装 Servlet 片段和捆绑包以修复该错误。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2