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.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 の最新のサービスパックおよびパッチをインストールします。詳しくは、 AEM Sustenance Hub を参照してください。

    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 Forms へのアップグレードを参照してください。

      次の手順に進む前に、ServiceEvent REGISTERED および ServiceEvent UNREGISTERED メッセージが <crx-repository>/error.log ファイルに出現しなくなるまで待ちます。

      メモ

      サーバーが起動して実行した後、いくつかの AEM Forms バンドルはインストール状態のままです。バンドルの数はインストールごとに異なる可能性があります。これらのバンドルの状態は無視しても問題はありません。バンドルは、https://[[server]]:[[port]]/system/console/ に一覧表示されます。

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

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

    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 ファイルに表示されなくなり、このログファイルが安定した状態になるまで待ちます。また、いくつかのパッケージについては、インストールされたままの状態になる場合があることに注意してください。これらのパッケージは、無視してかまいません。

  3. AEM インスタンスを再起動します。

  4. インストールの事後処理を実行します。

    • 移行ユーティリティの実行

      移行ユーティリティにより、以前のバージョンのアダプティブフォームや対応する管理アセットが AEM 6.5 Forms で使用できるようになります。このユーティリティは、AEM ソフトウェア配布からダウンロードできます。 移行ユーティリティの詳しい設定方法と使用方法については、移行ユーティリティに関する説明を参照してください。

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

    • 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 環境で分析とレポートを再設定してください。詳しい手順については、「分析とレポートの設定」を参照してください。

  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 におけるリポジトリの再構築」を参照してください。

このページ