インプレースアップグレードの実行 performing-an-in-place-upgrade
アップグレード前の手順 pre-upgrade-steps
アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。詳しくは、コードのアップグレードとカスタマイズおよびアップグレード前のメンテナンスタスクを参照してください。また、システムが AEM 6.5 LTS の要件を満たしていることを確認し、 アップグレード計画に関する考慮事項と、Analyzer を使用して複雑さを見積もる方法を確認します。
移行の前提条件 migration-prerequisites
- 最低限必要な Java バージョン: Oracleの Java™ 17/21 がインストールされていることを確認します。
AEM クイックスタート jar ファイルの準備 prep-quickstart-file
-
新しいAEM 6.5 LTS jar ファイルをダウンロードします
-
インスタンスが実行中である場合は停止します
-
新しいAEM 6.5 LTS jar を使用して、
crx-quickstart
フォルダーの外部にある古い jar を置き換えます -
sling.properties
ファイル(通常はcrx-quickstart/conf/
に存在)のバックアップを作成してから、削除します -
次のコマンドを実行して新しいクイックスタート jar を解凍します。
code language-shell java -Xmx4096m -jar aem-quickstart.jar -unpack
-
カスタムの sling.properties を適用する必要がある場合は、新しいローカル AEM インスタンスを作成し、crx-quickstart/conf ディレクトリから sling.properties ファイルを取得します。 必要なカスタムの変更をこのファイルに適用し、アップグレードするAEM インスタンスの crx-quickstart/conf ディレクトリにコピーします。 カスタムプロパティがない場合、この手順はスキップできます。
アップグレードの実行 performing-the-upgrade
S3 を使用している場合:
-
以前のバージョンの S3 コネクタに関連する、
crx-quickstart/install
内の jar を削除します。 -
https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/ から 1.60.2 S3 コネクタの最新リリースをダウンロードします。
-
S3 コネクタ(バージョン 1.60.2)を抽出し、次のように
crx-quickstart/install
の下の次のフォルダーの内容をコピーします。com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1
の下crx-quickstart/install/1
コピーcom.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/15
の下crx-quickstart/install/15
コピー
次に、「正しいアップグレード開始コマンドの特定 セクションの情報を使用して確認した新しいコマンドを使用して、AEM インスタンスを開始しす。
適切なアップグレード開始コマンドの確認 determining-the-correct-upgrade-start-command
アップグレードを実行するには、jar ファイルを使用してAEMを起動してインスタンスを起動することが重要です。
起動スクリプトから AEM を起動した場合、アップグレードは開始されません。ほとんどの顧客は、起動スクリプトを使用して AEM を起動します。また、起動スクリプトをカスタマイズし、メモリ設定やセキュリティ証明書など、環境設定に関するスイッチを含めています。そのため、次の手順に従って、適切なアップグレードコマンドを確認することをお勧めします。
-
実行中の AEM インスタンスで、コマンドラインから次のコマンドを実行します。
code language-shell ps -ef | grep java
-
AEM プロセスを探します。次のように表示されます。
code language-shell /usr/bin/java -server -Xmx1024m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar crx-quickstart/app/cq-quickstart-6.5.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
フォルダーと同じ階層にある新しいAEM 6.5 LTS jar に置き換えて、コマンドを変更します。 例として前述のコマンドを使用すると、コマンドは次のようになります。code language-shell /usr/bin/java -server -Xmx4096m -Djava.awt.headless=true -Dsling.run.modes=author,crx3,crx3tar -jar <AEM-6.5-LTS.jar> -c crx-quickstart -p 4502 -Dsling.properties=conf/sling.properties
これにより、適切なメモリ設定、カスタム実行モードおよびその他の環境パラメーターすべてがアップグレードに適用されます。アップグレードが完了すると、それ以降の起動時には起動スクリプトからインスタンスを起動できます。
アップグレードしたコードベースのデプロイ deploy-upgraded-codebase
インプレースアップグレードプロセスが完了したら、更新したコードベースをデプロイする必要があります。ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。
アップグレード後のチェックおよびトラブルシューティングを実行 perform-post-upgrade-check-troubleshooting
アップグレード後のチェックおよびトラブルシューティングを参照してください。