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 サーバーを停止する前に、<crx-repository>/error.log ファイルにServiceEvent REGISTERED メッセージとServiceEvent UNREGISTERED メッセージが表示されなくなり、ログが安定するまで待ちます。 また、いくつかのパッケージについては、インストールされたままの状態になる場合があります。 これらのパッケージの状態は無視しても問題ありません。

   次の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
   「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 フォームは、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 Developer ポータルに移動します。
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 – 管理インターフェイスをすべてのネットワークインターフェイスにバインドします