Application Server インストールのアップグレード手順(Tomcat - Sidegrade) upgrade-steps-for-application-server-installations-tomcat

NOTE
このページでは、Tomcat上のAEM 6.5からAEM 6.5 LTSへのアップグレード手順の概要を説明します。 AEM 6.5 LTSからAEM 6.5 LTS Servicepack へのアップグレードについては、こちらを参照してください

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

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

移行の前提条件 migration-prerequisites

  • 必要なJava バージョン​の最小値:Tomcat サーバーにOracle® JRE 17/21がインストールされていることを確認してください。
  • Tomcat サーバー: AEM 6.5 LTS用のTomcat サーバーでサポートされているバージョンは、10.0.x​および​ 10.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 – アップグレードを使用

  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
experience-manager-65-lts-help-main-toc