ドキュメントAEM 6.5 LTSユーザーガイド

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

Last update: Sun Apr 26 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用対象：
  • Experience Manager 6.5 LTS
  • トピック：

作成対象：

  • 管理者
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で削除されました。AEM 6.5 LTS🔗のOracle Java™ 17 documents、Oracle Java™ 21 documentsおよびJava&trade arguments considerationsを参照してください。

アップグレードを実行するには、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