インプレースアップグレードの実行 performing-an-in-place-upgrade

アップグレード前の手順 pre-upgrade-steps

アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。詳しくは、コードのアップグレードとカスタマイズおよびアップグレード前のメンテナンスタスクを参照してください。また、システムが新しいバージョンの AEM の要件を満たしていることを確認してください。パターン検出によってアップグレードの複雑性を推定できます。また、詳しくは、アップグレードの計画の「アップグレードの範囲と要件」の節を参照してください。

移行の前提条件 migration-prerequisites

AEM クイックスタート jar ファイルの準備 prep-quickstart-file

コンテンツリポジトリの移行 content-repository-migration

AEM 6.3 からアップグレードする場合、この移行は必要ありません。アドビでは 6.3 以前のバージョン向けに、リポジトリを AEM 6.3 で使用される新しいバージョンの Oak Segment Tar に移行するためのツールを提供しています。このツールはクイックスタートパッケージの一部として提供され、TarMK を使用するすべてのアップグレードに必須です。MongoMK を使用している環境のアップグレードには、リポジトリの移行は必要ありません。新しい Segment Tar 形式のメリットについて詳しくは、Oak Segment Tar への移行に関する FAQ を参照してください。

実際の移行は、標準の AEM クイックスタート jar ファイルを使用して行います。この jar ファイルは、新しい -x crx2oak オプションを指定して実行します。このオプションによって crx2oak ツールが実行され、アップグレードがより容易で堅牢になります。

実行すべきコマンドを決定するには、次のコマンドを使用します。

java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>

<<YOUR_PROFILE>> と <<ADDITIONAL_FLAGS>> は、次の表にリストされているプロファイルとフラグに置き換えてください。

この場合：

次のシナリオでは、追加のスイッチが必要となる場合もあります。

crx2oak ツールの使用手順について詳しくは、CRX2Oak 移行ツールの使用を参照してください。crx2oak ヘルパー JAR は、必要に応じて手動でアップグレードできます。その場合は、クイックスタートを解凍した後に、手動で新しいバージョンに置き換えます。AEM インストールフォルダー内の場所は <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar です。最新バージョンの CRX2Oak 移行ツールは、アドビリポジトリ（https://repo1.maven.org/maven2/com/adobe/granite/crx2oak/）からダウンロードできます。

移行が正常に完了すると、ツールは終了コード 0 で終了します。さらに、AEM インストールディレクトリの crx-quickstart/logs にある upgrade.log ファイルで WARN および ERROR メッセージがないかどうかを確認してください。これらのメッセージは、移行中に発生した致命的ではないエラーを示している場合があります。

crx-quickstart/installフォルダーにある設定ファイルを確認します。移行が必要だった場合は、ターゲットリポジトリを反映するように更新されます。

データストアに関するメモ：

AEM 6.3 インストールでは新しく FileDataStore がデフォルトになっていますが、外部データストアの使用は必須ではありません。実稼動デプロイメントのベストプラクティスとして外部データストアを使用することをお勧めしますが、これはアップグレードの前提条件ではありません。AEM のアップグレードは既に複雑な処理なので、データストアを移行せずにアップグレードを行うことをお勧めします。必要に応じて、後でデータストアの移行を別の作業として実行できます。

移行に関する問題のトラブルシューティング troubleshooting-migration-issues

6.3 からアップグレードする場合、この節の説明はスキップします。提供されている crx2oak プロファイルはほとんどの顧客のニーズに適合しますが、追加のパラメーターが必要になる場合もあります。移行中にエラーが発生する場合は、お使いの環境に、追加の設定オプションの指定が必要な事項が存在する可能性があります。その場合は、次のエラーが発生することがあります。

外部データストアが指定されていないため、チェックポイントはコピーされません。これにより、最初の起動時にリポジトリ全体のインデックスが再作成されます。–skip-checkpoints を使用して移行を強制するか、https://jackrabbit.apache.org/oak/docs/migration.html#Checkpoints_migration で詳細を確認してください。

何らかの理由で、移行プロセスがデータストア内のバイナリにアクセスする必要がありますが、データストアを見つけることができません。データストア設定を指定するには、移行コマンドの <<ADDITIONAL_FLAGS>> 部分に以下のフラグを挿入します。

S3 データストアの場合：

--src-s3config=/path/to/SharedS3DataStore.config --src-s3datastore=/path/to/datastore

/path/to/SharedS3DataStore.configは、S3 データストア設定ファイルのパスを表します。/path/to/datastoreは、S3 データストアのパスを表します。

ファイルデータストアの場合：

--src-datastore=/path/to/datastore

/path/to/datastoreは、ファイルデータストアのパスを表します。

アップグレードの実行 performing-the-upgrade

S3 を使用している場合：

適切なアップグレード開始コマンドの確認 determining-the-correct-upgrade-start-command

アップグレードを実行するには、jar ファイルを使用して AEM を起動し、インスタンスを起動することが重要です。6.5 にアップグレードする場合は、アップグレードコマンドで選択できる遅延コンテンツ移行のその他のコンテンツ再構築および移行オプションを検討します。

起動スクリプトから AEM を起動した場合、アップグレードは開始されません。ほとんどの顧客は、起動スクリプトを使用して AEM を起動します。また、起動スクリプトをカスタマイズし、メモリ設定やセキュリティ証明書など、環境設定に関するスイッチを含めています。そのため、次の手順に従って、適切なアップグレードコマンドを確認することをお勧めします。

アップグレードしたコードベースのデプロイ deploy-upgraded-codebase

インプレースアップグレードプロセスが完了したら、更新したコードベースをデプロイする必要があります。ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。

アップグレード後のチェックおよびトラブルシューティングを実行 perform-post-upgrade-check-troubleshooting

アップグレード後のチェックおよびトラブルシューティングを参照してください。