アプリケーションサーバーのインストールのアップグレード手順(Tomcat) upgrade-steps-for-application-server-installations-tomcat

NOTE
ここでは、Tomcat 上のAEM 6.5 LTS のアップグレード手順の概要を説明します。

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

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

移行の前提条件 migration-prerequisites

  • 最低限必要な Java バージョン:Tomcat サーバーにOracle® JRE 17/21 がインストールされていることを確認します。
  • Tomcat サーバー:AEM 6.5 LTS 用の Tomcat サーバーのサポートされているバージョンは、10.0.x10.1.x です。

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

この手順では、どの例でも JBoss をアプリケーションサーバーとして使用し、有効な AEM のバージョンが既にデプロイされているものとします。ここでは、AEM バージョン 6.5 から 6.5 LTS へのアップグレードについて説明します。

  1. AEM 6.5 が既にデプロイされている場合は、https://<serveraddress:port>/system/console/bundles にアクセスしてバンドルが正常に動作していることを確認します。

  2. 次に、AEM 6.5 を停止します。これは、次の場所にある Tomcat App Manager から実行できます。https://<serveraddress:port>/manager/html

  3. アップグレードアクティビティを実行する前に、AEM 6.5 サーバーのバックアップなどの アップグレード前アクティビティが完了していることを確認してください

  4. Java 17/Java 21 をインストールし、次のコマンドを実行して正しくインストールされていることを確認します。

    code language-none
    java –version
    
  5. AEM 6.5 LTS 互換の Tomcat サーバーの設定

  6. AEM サーバーの開始パラメーターを確認し、システム要件に従ってパラメーターを更新してください。 詳しくは、Java 17/Java 21 に関する考慮事項を参照してください

  7. Java 17/Java 21 を使用して、新しくダウンロードした 6.5 LTS war を Tomcat サーバーにデプロイし、次のコマンドを実行してAEM 6.5 LTS Tomcat サーバーを起動します。

    code language-none
    $CATALINA_HOME/bin/catalina.sh start
    
  8. AEMを起動して実行したら、次の場所にアクセスして、すべてのバンドルが実行状態であることを確認します。https://<serveraddress:port>/cq/system/console/bundles

  9. AEM 6.5 LTS Tomcat サーバーを停止します。 ほとんどの状況で、./catalina.sh スクリプトを実行することで設定できます。このために、ターミナルから次のコマンドを実行します。

    code language-none
    $CATALINA_HOME/bin/catalina.sh stop
    
  10. 次の手順に従って、AEM 6.5 からAEM 6.5 LTS にコンテンツを移行します。AEM 6.5 からAEM 6.5 LTS へのコンテンツ移行Oak-upgrade を使用する

  11. コンテンツが移行されたら、sling.properties ファイルに必要なカスタム変更を適用します

  12. 次のコマンドを実行して、AEM 6.5 LTS Tomcat サーバーを起動します。

    code language-none
    $CATALINA_HOME/bin/catalina.sh start
    
  13. AEMの起動中にエラーログを監視し、エラーがなく、AEMがスムーズに実行されていることを確認します

  14. AEM 6.5 LTS が起動したら、https://<serveraddress:port>/cq/system/console/bundles にアクセスしてバンドルが正常に機能していることを確認します。

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

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

アップグレード後のチェックとトラブルシューティングの実行 perform-post-upgrade-checks-and-troubleshooting

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

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