OSGi でのAEM 6.5 Forms LTS へのアップグレード upgrade-to-aem-forms-osgi

AEM Forms アドオンパッケージのインストール. 手順は次のとおりです。

1. ソフトウェア配布を開きます。ソフトウェア配布にログインするには、Adobe ID が必要です。

2. ヘッダーメニューで「Adobe Experience Manager」を選択します。

3. 「フィルター」セクションで、

   1. 「ソリューション」ドロップダウンリストから「Forms」を選択します。
   2. パッケージのバージョンとタイプを選択します。また、「ダウンロードを検索」オプションを使用して結果をフィルターすることもできます。

4. お使いのオペレーティングシステムに適した Forms アドオンパッケージの名前を選択し、「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 Forms で使用できるようになります。このユーティリティは、AEM ソフトウェア配布からダウンロードできます。 移行ユーティリティの詳しい設定方法と使用方法については、移行ユーティリティに関する説明を参照してください。

  ドラフト統合とコンポーネント送信のサンプルをデータベースで使用して旧バージョンのアップグレードを行う場合は、アップグレードの実行後に、以下の 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'

• Adobe Sign の再設定（AEM 6.2 Forms 以前のバージョンをアップグレードする場合のみ）

  Adobe Sign を以前のバージョンの AEM Forms で設定してある場合は、AEM Cloud サービスから 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 のサポートは削除されています。 前述の API の代わりに.on() メソッドを使用します。 例えば、$("img").load(fn) を $("img").on("load", fn) に変更します。

• 分析機能とレポートの再設定（バージョン 6.2 以前の AEM Forms をアップグレードする場合のみ）

  AEM 6.4 Forms では、ソースのトラフィック変数とインプレッションの成功イベントは使用できません。そのため、バージョン 6.2 以前の AEM Forms をアップグレードすると、AEM Forms から Adobe 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 – 管理インターフェイスをすべてのネットワーク インターフェイスにバインドします