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

ご使用の環境に合わせて、次のアップグレードパスのいずれかを使用します。

AEM 6.2 Forms または AEM 6.3 Forms から AEM 6.4 Forms へのアップグレード

AEM 6.2 Forms と AEM 6.3 Forms の場合、AEM 6.4 Forms へ直接アップグレードすることができます。次の操作を実行します。

既存の AEM インスタンスを AEM 6.4 にアップグレードします。手順は次のとおりです。
1. AEM 6.2 Forms または AEM 6.3 Forms の最新のサービスパックおよびパッチをインストールします。詳しくは、次を参照してください。
2. アップグレードのソースインスタンスを準備します。詳しくは、「AEM 6.4 へのアップグレード」を参照してください。
3. AEM 6.4 QuickStart をダウンロードします。
4. （Unix/Linux ベースのインストールのみ） 基盤のオペレーティングシステムとして UNIX または Linux を使用している場合は、ターミナルウィンドウを開いて crx-quickstart が含まれているフォルダーに移動し、次のコマンドを実行します。
  
  chmod -R 755 ../crx-quickstart
5. AEMインスタンスをAEM 6.3にアップグレードします。詳しい手順については、AEM 6.4へのアップグレードを参照してください。
  
  次の手順に進む前に、ServiceEvent REGISTERED および ServiceEvent UNREGISTERED メッセージが <crx-repository>/error.log ファイルに出現しなくなるまで待ちます。
  
  メモ
  
  サーバーが起動して実行した後、いくつかの AEM Forms バンドルはインストール状態のままです。バンドルの数はインストールごとに異なる可能性があります。これらのバンドルの状態は無視しても問題はありません。バンドルはhttps://[server]:[port]/system/console/に一覧表示されます。
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 ファイルに表示されなくなり、このログファイルが安定した状態になるまで待ちます。また、いくつかのパッケージについては、インストールされたままの状態になる場合があることに注意してください。これらのパッケージは、無視してかまいません。
7. AEM インスタンスを停止して、次のファイルを削除します。
  - [AEM_Installation_Directory]\[crx-quickstart]\launchpad\ext\bcmail-jdk15-1.35
  - [AEM_Installation_Directory]\[crx-quickstart]\launchpad\ext\bcprov-jdk15-1.35
8. AEM インスタンスを起動します。
インストールの事後処理を実行します。
- 移行ユーティリティの実行
  
  移行ユーティリティにより、以前のバージョンのアダプティブフォームや対応する管理アセットが AEM 6.4 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 に統合する」を参照してください。
- 分析機能とレポートの再設定（バージョン 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
メモ

AEM 6.4 Forms では crx-repository の構造が変更されています。AEM 6.4 Forms にアップグレードしたあと、新規作成するカスタマイズについては、変更後のパスを使用してください。変更後のパスの一覧については、「AEM 6.4 Forms におけるリポジトリの再構築」を参照してください。

AEM 6.0 Forms または AEM 6.1 Forms から AEM 6.4 Forms へのアップグレード

AEM 6.0 Forms と AEM 6.1 Forms の場合、AEM 6.4 Forms に直接アップグレードすることはできません。AEM 6.2Forms🔗への中間的なアップグレードまたはAEM 6.3Formsへのアップグレードを実行し、AEM 6.2FormsまたはAEM 6.3FormsからAEM6.4Formsにアップグレードします。