OSGi 上の AEM 6.5 Forms へのアップグレード

AEM 6.3 Forms と AEM 6.4 Forms の場合、AEM 6.5 Forms へ直接アップグレードすることができます。

AEM 6.0Forms、AEM 6.1Forms、AEM 6.2Forms​からAEM 6.5Formsへの直接アップグレードパスは使用できません。 AEM 6.2Forms](https://helpx.adobe.com/jp/experience-manager/6-2/forms/using/upgrade.html)への中間的な[アップグレード、AEM 6.3Formsへのアップグレード、またはAEM 6.4Formsへのアップグレードを実行し、AEM 6.3Formsまたは6.AEM4FormsからAEM6.5 Formsにアップグレードします。

AEM 6.3FormsまたはAEM 6.4FormsからAEM 6.5Formsにアップグレードするには、次の手順を実行します。

1. 既存の AEM インスタンスを AEM 6.5 にアップグレードします。手順は次のとおりです。

   1. AEM 6.3 Forms または AEM 6.4 Forms の最新のサービスパックおよびパッチをインストールします。詳しくは、AEMメンテナンスハブを参照してください。

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

      次の手順に進む前に、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 Software Distributionからダウンロードできます。 移行ユーティリティの詳しい設定方法と使用方法については、移行ユーティリティに関する説明を参照してください。

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

   • (AEM 6.2Formsまたは以前のバージョンからアップグレードした場合のみ)Adobe Signの再設定

     Adobe Sign を以前のバージョンの AEM Forms で設定してある場合は、AEM Cloud サービスから Adobe Sign を再設定します。詳細については、「Adobe Sign を AEM Forms に統合する」を参照してください。

   • jQueryのサポート

     AEM 6.5Formsでは、jQueryのバージョンが3.2.1に更新され、jQuery UIのバージョンが1.12.1に更新されます。AEMフォームは、noConflict​モードでJQueryを使用します。 したがって、他のjQueryバージョンを使用している場合、アップグレードの実行中に問題は表示されません。 ただし、AEM 6.5Formsにアップグレードする場合は、次の手順を実行します。

     • カスタムコンポーネントが存在する場合は、そのコンポーネントが、サポートされている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.3FormsからAEM 6.5Formsにアップグレードする場合は、新しく作成するカスタマイズ用に変更されたパスを使用します。 変更後のパスの一覧については、「AEM Forms におけるリポジトリの再構築」を参照してください。