インプレースアップグレードの実行 performing-an-in-place-upgrade
アップグレード前の手順 pre-upgrade-steps
アップグレードを実行する前に、いくつかの手順を完了する必要があります。 詳しくは、 コードのアップグレードとカスタマイズ および アップグレード前のメンテナンスタスク を参照してください。 さらに、お使いのシステムが新しいバージョンのAEMの要件を満たしていることを確認します。 パターン検出を使用して、アップグレードの複雑さを推定する方法を確認し、 アップグレードの計画 を参照してください。
移行の前提条件 migration-prerequisites
-
必要な Java の最小バージョン： 移行ツールは、Java バージョン 7 以降でのみ機能します。 AEM 6.3 以上では、サポートされているバージョンは Oracle の JRE 8 と IBM の JRE 7 および 8 のみです。
-
アップグレードされたインスタンス： バージョンからアップグレードする場合 5.6 より古い アップグレードに関するドキュメントの 6.0 バージョンに記載されている手順に従って、AEM 6.0 へのインプレースアップグレードを必ず実行してください。
AEM クイックスタート jar ファイルの準備 prep-quickstart-file
-
インスタンスが実行中である場合は停止します。
-
新しい AEM jar ファイルをダウンロードし、それを使用して
crx-quickstartフォルダーの外部にある古いファイルを置き換えます。 -
次のコマンドを実行して新しいクイックスタート jar を解凍します。
code language-shell java -Xmx4096m -jar aem-quickstart.jar -unpack
コンテンツリポジトリの移行 content-repository-migration
AEM 6.3 からアップグレードする場合は、このAdobeは必要ありません。6.3 より前のバージョンでは、AEM 6.3 にある新しいバージョンの Oak Segment Tar にリポジトリを移行するためのツールが提供されます。このツールは、quickstart パッケージの一部として提供され、TarMK を使用するアップグレードに必須です。 MongoMK を使用している環境のアップグレードには、リポジトリの移行は必要ありません。 新しい Segment Tar 形式の利点について詳しくは、 Oak Segment Tar への移行に関する FAQ.
実際の移行は、標準の AEM クイックスタート jar ファイルを使用して行います。この jar ファイルは、新しい -x crx2oak オプションを指定して実行します。このオプションにより crx2oak ツールが実行され、アップグレードが容易になり、より堅牢になります。
--promote-runmode nosamplecontent
実行すべきコマンドを決定するには、次のコマンドを使用します。
java -Xmx4096m -jar aem-quickstart.jar -v -x crx2oak -xargs -- --load-profile <<YOUR_PROFILE>> <<ADDITIONAL_FLAGS>>
<<YOUR_PROFILE>> と <<ADDITIONAL_FLAGS>> は、次の表にリストされているプロファイルとフラグに置き換えてください。
この場合：
-
mongo-hostは、MongoDB サーバーの IP です（例：127.0.0.1） -
mongo-portは、MongoDB サーバーのポートです（例：27017） -
mongo-database-nameは、データベースの名前です（例：aem-author）
次のシナリオでは、追加のスイッチが必要となる場合もあります。
-
Java のメモリマッピングが正しく処理されない Windows システムでアップグレードを行う場合は、
--disable-mmapパラメーターをコマンドに追加してください。 -
Java 7 を使用している場合は、
-XX:MaxPermSize=2048mパラメーターを-Xmxパラメーターの直後に追加してください。
crx2oak ツールの使用に関する追加の手順については、 CRX2Oak 移行ツール. crx2oak ヘルパー JAR は、必要に応じて手動でアップグレードできます。その場合は、クイックスタートを展開した後に、手動で新しいバージョンに置き換えます。 AEMインストールフォルダー内の場所は次のとおりです。 <aem-install>/crx-quickstart/opt/extensions/crx2oak.jar. CRX2Oak 移行ツールの最新バージョンは、次の場所にあるAdobeリポジトリからダウンロードできます。 https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/crx2oak/
移行が正常に完了すると、ツールは終了コード 0 で終了します。さらに、AEM インストールディレクトリの crx-quickstart/logs にある upgrade.log ファイルで WARN および ERROR メッセージがないかどうかを確認してください。これらのメッセージは、移行中に発生した致命的ではないエラーを示している場合があります。
crx-quickstart/installフォルダーにある設定ファイルを確認します。移行が必要な場合は、ターゲットリポジトリを反映するように更新されます。
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 を使用する場合：
-
以前のバージョンの S3 コネクタに関連する、
crx-quickstart/install内の jar を削除します。 -
https://repo.adobe.com/nexus/content/groups/public/com/adobe/granite/com.adobe.granite.oak.s3connector/ から 1.8.x S3 コネクタの最新リリースをダウンロードします。
-
パッケージを一時フォルダーに抽出し、
jcr_root/libs/system/installの内容をcrx-quickstart/installフォルダーにコピーします。
適切なアップグレード開始コマンドの確認 determining-the-correct-upgrade-start-command
アップグレードを実行するには、jar ファイルを使用してAEMを起動し、インスタンスを起動することが重要です。 6.4 にアップグレードする場合は、アップグレードコマンドで選択できる遅延コンテンツ移行のその他のコンテンツ再構築および移行オプションも検討してください。
開始スクリプトからAEMを起動しても、アップグレードは開始されません。 ほとんどのお客様は、起動スクリプトを使用してAEMを起動し、この起動スクリプトをカスタマイズして、メモリ設定、セキュリティ証明書などの環境設定用のスイッチを含めています。 このため、適切なアップグレードコマンドを判断するには、次の手順に従うことをお勧めします。
-
実行中の AEM インスタンスで、コマンドラインから次のコマンドを実行します。
code language-shell ps -ef | grep java -
AEM プロセスを探します。次のように表示されます。
code language-shell /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.2.0-standalone-quickstart.jar start -c crx-quickstart -i launchpad -p 4502 -Dsling.properties=conf/sling.properties -
既存の jar のパス（この場合は
crx-quickstart/app/aem-quickstart*.jar）をcrx-quickstartフォルダーと同じ階層にある新しい jar に置き換えて、コマンドを変更します。例として前述のコマンドを使用すると、コマンドは次のようになります。code language-shell /usr/bin/java -server -Xmx1024m -XX:MaxPermSize=256M -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar cq-quickstart-6.4.0.jar -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.propertiesこれにより、適切なメモリ設定、カスタム実行モード、その他の環境パラメーターがすべてアップグレードに適用されます。 アップグレードが完了した後、今後の起動時に開始スクリプトからインスタンスを起動できます。
アップグレードされたコードベースのデプロイ deploy-upgraded-codebase
インプレースアップグレードプロセスが完了したら、更新されたコードベースをデプロイする必要があります。 ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。
アップグレード後のチェックとトラブルシューティングの実行 perform-post-upgrade-check-troubleshooting
詳しくは、 アップグレード後のチェックとトラブルシューティング.