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

安装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服务器之前，请等待ServiceEvent REGISTERED和ServiceEvent UNREGISTERED消息停止出现在<crx-repository>/error.log文件中，并且日志稳定。 另请注意，一些软件包可以保持已安装状态。 您可以安全地忽略这些软件包的状态。

   使用以下其他JVM命令行参数重新启动AEM实例：
   --add-opens java.base/java.util=ALL-UNNAMED --add-exports=java.xml/com.sun.org.apache.xml.internal.serialize=ALL-UNNAMED

   如果服务器是通过脚本或服务启动的，请相应地更新以包含上述内容，以便在后续重新启动后生效。

   note note
   NOTE
   建议使用 “Ctrl + C” 命令重新启动 SDK。如果使用其他方式（例如停止 Java 进程）重新启动 AEM SDK，则可能会导致 AEM 开发环境出现不一致情况。

执行安装后活动。

• 运行迁移实用程序

  迁移实用程序使自适应表单和以前版本的通信管理资产与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 Service重新配置Adobe Sign。 有关详细信息，请参阅将Adobe Sign与AEM Forms集成。

• 支持jQuery

  在AEM 6.5 Forms中，jQuery的版本更新为3.2.1，jQuery UI的版本更新为1.12.1。AEM表单在​ 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还为Form Analytics版本引入了流量变量，并为字段逗留时间引入了成功事件。 因此，请为您的AEM Forms环境重新配置分析和报表。 有关详细步骤，请参阅配置分析和报表。

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

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

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

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

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

导航到Red Hat开发人员门户：
https://developers.redhat.com/products/eap/download

下载适用于Windows的JBoss EAP 8 ZIP分发。

将下载的ZIP文件解压到首选安装目录。

请将此目录路径记为<JBOSS_HOME>，以便在本指南中使用。

示例：
C:\jboss-eap-8.0

创建临时工作目录：

C:\aem\war-config

将 cq-quickstart.war 复制到此目录中。

打开​ 命令提示符 ​并导航到工作目录：

cd C:\aem\war-config

提取WAR文件：

jar -xvf cq-quickstart.war

这将创建一个包含WEB-INF和其他应用程序文件的目录结构。

导航到解压缩的WAR中的WEB-INF目录：

cd WEB-INF

创建名为jboss-deployment-structure.xml的新文件。

添加以下XML内容：

<?xml version="1.0" encoding="UTF-8"?>
<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
    <deployment>
        <dependencies>
            <module name="jdk.unsupported" />
        </dependencies>
    </deployment>
</jboss-deployment-structure>

保存并关闭该文件。

在文本编辑器中打开WEB-INF\web.xml。

找到包含运行模式配置的<servlet>部分：

<!-- Set the runmode per default to author -->
<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<load-on-startup>100</load-on-startup>
</servlet>

将结束</servlet>标记和前一行替换为：

<init-param>
    <param-name>sling.run.modes</param-name>
    <param-value>author</param-value>
</init-param>
<multipart-config>
    <max-file-size>1048576000</max-file-size>
    <max-request-size>1048576000</max-request-size>
    <file-size-threshold>0</file-size-threshold>
</multipart-config>
<load-on-startup>100</load-on-startup>
</servlet>

保存并关闭web.xml。

导航回包含提取内容的工作目录：

cd C:\aem\war-config

创建新的WAR文件：

jar -cvf cq-quickstart.war *

将重新打包的cq-quickstart.war复制到JBoss部署目录：

<JBOSS_HOME>\standalone\deployments

示例：
C:\jboss-eap-8.0\standalone\deployments

在文本编辑器中打开<JBOSS_HOME>\bin\standalone.conf.bat。

修改或添加以下行以设置栈内存：

set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=512m"

以​ 管理员 ​的身份打开​命令提示符。

导航到JBoss bin目录：

cd <JBOSS_HOME>\bin

示例：
cmd cd C:\jboss-eap-8.0\bin

启动JBoss服务器：

standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0

参数：

• -b 0.0.0.0 — 将服务器绑定到所有网络接口
• -bmanagement 0.0.0.0 — 将管理接口绑定到所有网络接口