在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。 使用替代方法重新啟動AEM SDK （例如停止Java程式），可能會導致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雲端服務重新設定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為表單分析版本引入流量變數，並為在欄位上逗留的時間量引入成功事件。 因此，請為您的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 — 將管理介面繫結到所有網路介面