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

NOTE
ここでは、AEM 6.5 LTS のインプレースアップグレード手順の概要を説明します。 アプリケーションサーバーにデプロイされたインストールがある場合は、 アプリケーションサーバーインストールのアップグレード手順を参照してください。

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

アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。詳しくは、コードのアップグレードとカスタマイズおよびアップグレード前のメンテナンスタスクを参照してください。また、システムが AEM 6.5 LTS の要件を満たしていることを確認し、 アップグレード計画に関する考慮事項と、Analyzer を使用して複雑さを見積もる方法を確認します。

移行の前提条件 migration-prerequisites

  • 最低限必要な Java バージョン: Oracleの Java™ 17/21 がインストールされていることを確認します。

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

  1. 新しいAEM 6.5 LTS jar ファイルをダウンロードします

  2. 正しいアップグレード開始コマンドを確認します

  3. インスタンスが実行中である場合は停止します

  4. 新しいAEM 6.5 LTS jar を使用して、crx-quickstart フォルダーの外部にある古い jar を置き換えます

  5. sling.properties ファイル(通常は crx-quickstart/conf/ に存在)のバックアップを作成してから、削除します

  6. 次のコマンドを実行して新しいクイックスタート jar を解凍します。

    code language-shell
    java -Xmx4096m -jar aem-quickstart.jar -unpack
    
  7. カスタムの sling.properties を適用する必要がある場合は、新しいローカル AEM インスタンスを作成し、crx-quickstart/conf ディレクトリから sling.properties ファイルを取得します。 必要なカスタムの変更をこのファイルに適用し、アップグレードするAEM インスタンスの crx-quickstart/conf ディレクトリにコピーします。 カスタムプロパティがない場合、この手順はスキップできます。

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

S3 を使用している場合:

  1. 以前のバージョンの S3 コネクタに関連する、crx-quickstart/install 内の jar を削除します。

  2. https://repo1.maven.org/maven2/com/adobe/granite/com.adobe.granite.oak.s3connector/ から 1.60.2 S3 コネクタの最新リリースをダウンロードします。

  3. S3 コネクタ(バージョン 1.60.2)を抽出し、次のように crx-quickstart/install の下の次のフォルダーの内容をコピーします。

    1. com.adobe.granite.oak.s3connector-1.60.2/jcr_root/libs/system/install/1 の下 crx-quickstart/install/1 コピー
    2. 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

NOTE
Java 8/11 引数の一部のサポートは、Java 17/21 で削除されました。Oracle Java™ 17 ドキュメントOracle Java™ 21 ドキュメントおよび AEM 6.5 LTS の Java&trade 引数に関する考慮事項を参照してください。

アップグレードを実行するには、jar ファイルを使用してAEMを起動してインスタンスを起動することが重要です。

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

  1. 実行中の AEM インスタンスで、コマンドラインから次のコマンドを実行します。

    code language-shell
    ps -ef | grep java
    
  2. 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
    
  3. 既存の 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

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

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2