在OSGi上升级到AEM 6.5 Forms upgrade-to-aem-forms-osgi

您可以从AEM 6.3 Forms或AEM 6.4 Forms直接升级到AEM 6.5 Forms。

直接升级路径 AEM 6.0 Forms、AEM 6.1 Forms、和 AEM 6.2 Forms AEM 6.5 Forms不可用。 执行中间的 升级到AEM 6.2 Forms升级到AEM 6.3 Forms,或 升级到AEM 6.4 Forms 然后从AEM 6.3 Forms或AEM 6.4 Forms升级到AEM 6.5 Forms。

要从AEM 6.3 Forms或AEM 6.4 Forms升级到AEM 6.5 Forms,请执行以下操作:

  1. 将现有AEM实例升级到AEM 6.5。以下列出了这些步骤:

    1. 安装适用于AEM 6.3 Forms或AEM 6.4 Forms的最新Service Pack和修补程序。 有关详细信息,请参阅 AEM维护中心.

    2. 为升级准备源实例。 有关详细步骤,请参阅 升级到AEM 6.5.

    3. 下载 AEM 6.5快速入门.

    4. (仅限基于Unix/Linux的安装) 如果您使用UNIX或Linux作为基础操作系统,请打开“终端”窗口,导航到包含crx-quickstart的文件夹,然后运行以下命令:

      chmod -R 755 ../crx-quickstart

    5. 将AEM实例升级到AEM 6.3。有关分步说明,请参阅 升级到AEM 6.5.

      继续下一步之前,请等待ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止出现在 <crx-repository>/error.log文件。

      note note
      NOTE
      在服务器启动并运行后,一些AEM Forms捆绑包保持安装状态。 每次安装的捆绑包数量可能有所不同。 您可以安全地忽略这些捆绑包的状态。 这些捆绑包位于https://'[服务器]:[端口]'/system/console/.
  2. 安装AEM Forms附加组件包。 以下列出了这些步骤:

    1. 打开 Software Distribution。您需要 Adobe ID 才能登录 Software Distribution。

    2. 选择 Adobe Experience Manager 在标题菜单中可用。

    3. 过滤器 部分:

      1. 选择 Forms解决方案 下拉列表。
      2. 选择包的版本和类型。 您也可以使用 搜索下载 用于筛选结果的选项。
    4. 选择适用于您的操作系统的包名称,然后选择 接受EULA条款,并选择 下载.

    5. 打开 包管理器 并单击 上传包 以上传包。

    6. 选择包并单击 安装.

      您还可以使用中列出的直接链接下载包 AEM Forms版本 文章。

      note note
      NOTE
      安装软件包后,系统会提示您重新启动AEM实例。 不要立即停止服务器。 在停止AEM Forms服务器之前,请等待ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止出现在 <crx-repository>/error.log文件,日志稳定。 另请注意,一些软件包可以保持已安装状态。 您可以安全地忽略这些软件包的状态。
  3. 重新启动AEM实例。

    note note
    NOTE
    建议使用“Ctrl + C”命令重新启动SDK。 使用替代方法(例如,停止Java进程)重新启动AEM SDK可能会导致AEM开发环境不一致。
  4. 执行安装后活动。

    • 运行迁移实用程序

      迁移实用程序使自适应表单及以前版本的通信管理资产与AEM 6.5表单兼容。 您可以从AEM Software Distribution下载该实用程序。 有关配置和使用迁移实用程序的分步信息,请参阅 迁移实用程序.

      如果您使用 用于集成草稿和提交组件的示例 使用数据库并从以前的版本升级,然后在执行升级后运行以下SQL查询:

      code language-sql
      UPDATE metadata m, additionalmetadatatable am
      SET m.dataType = am.value
      WHERE m.id = am.id
      AND am.key = 'dataType'
      
      code language-sql
      DELETE from additionalmetadatatable
      WHERE `key` = 'dataType'
      
    • (如果仅从AEM 6.2 Forms或以前的版本升级)重新配置Adobe Sign

      如果您在以前版本的AEM Forms中配置了Adobe Sign,请从AEM Cloud Services重新配置Adobe Sign。 有关更多详细信息,请参阅 将Adobe Sign与AEM Forms集成.

    • 支持jQuery

      在AEM 6.5 Forms中,jQuery的版本更新为3.2.1,jQuery UI的版本更新为1.12.1。AEM Form在中使用JQuery noConflict 模式。 因此,如果您使用的是任何其他jQuery版本,则在执行升级时不会显示任何问题。 但是,当您升级到AEM 6.5 Forms时:

      • 确保您的自定义组件(如果有)与支持的jQuery版本兼容。
      • 从自定义组件中删除不支持的API。 请参阅 升级指南 以获取已删除的API列表。 例如,删除了对load()、.unload()和.error() API的支持。 使用.on()方法替换前面提到的API。 例如,将$("img")。load(fn)更改为$("img")。on("load", fn)。
    • (如果仅从AEM 6.2 Forms或之前的版本升级)重新配置Analytics和报表

      在AEM 6.4 Forms中,源的流量变量和印象的成功事件不可用。 因此,当您从AEM 6.2 Forms或之前的版本升级时,AEM Forms会停止向Adobe Analytics服务器发送数据,并且自适应表单的Analytics报表将不可用。 此外,AEM 6.4 Forms还为Form Analytics版本引入了流量变量,并为字段逗留时间引入了成功事件。 因此,请为您的AEM Forms环境重新配置分析和报表。 有关详细步骤,请参阅 配置分析和报表.

  5. 验证服务器是否升级成功,所有数据是否也迁移成功,服务器是否能够正常运行。

    • 验证捆绑包的状态: 确保所有捆绑包都处于活动状态。

    • 验证复制和反向复制: 发布、填写和提交一些迁移的表单。 同时验证提交的数据。

    • 验证对管理员和开发人员用户界面的访问权限: 从管理员帐户登录AEM实例,并确认您有权访问以下URL:

      • https://'[server]:[port]'/crx/packmgr
      • https://'[server]:[port]'/crx/de
      • https://'[server]:[port]'/aem/forms.html/content/dam/formsanddocuments
    note note
    NOTE
    在AEM 6.4 Forms中,crx-repository的结构发生了变化。 如果从6.3 Forms升级到AEM 6.5 Forms,请使用更改后的路径来重新创建自定义。 有关已更改路径的完整列表,请参见 AEM中的Forms存储库重构.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2