在OSGi上升级到AEM 6.5 Forms

您可以从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 Susentation Hub。

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

   3. 下载AEM 6.5 QuickStart。

   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文件中。

      注意

      服务器启动并运行后，一些AEM Forms捆绑包仍处于安装状态。 每个安装的捆绑包数量可能不同。 您可以安全地忽略这些包的状态。 这些包列在https://'[server]:[port]'/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发行版文章中列出的直接链接下载包。

      注意

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

3. 重新启动AEM实例。

4. 执行安装后活动。

   • 运行迁移实用程序

     迁移实用程序使早期版本的自适应表单和通信管理资源与AEM 6.5表单兼容。 您可以从AEM软件分发下载该实用程序。 有关配置和使用迁移实用程序的分步信息，请参阅迁移实用程序。

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

     UPDATE metadata m, additionalmetadatatable am
     SET m.dataType = am.value
     WHERE m.id = am.id
     AND am.key = 'dataType'
     

     DELETE from additionalmetadatatable
     WHERE `key` = 'dataType'
     

   • (如果仅从AEM 6.2 Forms或先前版本升级)重新配置Adobe Sign

     如果您在AEM Forms的早期版本中配置了Adobe Sign，则从AEM云服务中重新配置Adobe Sign。 有关详细信息，请参阅将Adobe Sign与AEM Forms集成。

   • 支持jQuery

     在AEM 6.5 Forms中，jQuery的版本更新为3.2.1，而jQuery UI版本更新为1.12.1。 AEM Form在​noConflict​模式下使用JQuery。 因此，如果您使用任何其他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或先前版本升级)重新配置分析和报告

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

5. 验证服务器是否升级成功，所有数据是否也成功迁移，并且它可以正常运行。

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

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

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

     • https://'[server]:[port]'/crx/packmgr
     • https://'[server]:[port]'/crx/de
     • https://'[server]:[port]'/aem/forms.html/content/dam/formsanddocuments
   注意

   在AEM 6.4 Forms中，crx-repository的结构已更改。 如果从6.3 Forms升级到AEM 6.5 Forms，请使用您重新创建的自定义更改的路径。 有关更改路径的完整列表，请参阅AEM](/docs/experience-manager-65/sites-deploying/forms-repository-restructuring-in-aem-6-5.html?lang=zh-Hans)中的[Forms存储库重构。