在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维护中心。

   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 UNEXIGNED消息停止出现在<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. 在​Filters​部分中：

      1. 从​Solution​下拉列表中选择​Forms。
      2. 选择包的版本和类型。 您还可以使用​搜索下载​选项来筛选结果。

   4. 点按适用于您的操作系统的包名称，选择​接受EULA条款，然后点按​下载。

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

   6. 选择包并单击​Install。

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

      注意

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

3. 重新启动AEM实例。

4. 执行安装后活动。

   • 运行迁移实用程序

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

     如果使用示例将草稿和提交组件与数据库集成并从以前的版本升级，则在执行升级后运行以下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服务器发送数据，并且自适应表单的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🔗中的Forms存储库重组。