Application Server インストールのアップグレード手順(Tomcat - Sidegrade) upgrade-steps-for-application-server-installations-tomcat
アップグレード前の手順 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 に実行されたアップグレードを文書化するためのものです。
-
AEM 6.5が既にデプロイされている場合は、バンドルが正しく機能していることを確認します。
https://<serveraddress:port>/system/console/bundles -
次に、AEM 6.5を停止します。 これは、次の場所にあるTomcat App Managerから実行できます:
https://<serveraddress:port>/manager/html -
アップグレード アクティビティを実行する前に、AEM 6.5 サーバーのバックアップなどの アップグレード前 アクティビティが完了していることを確認してください
-
Java 17/Java 21をインストールし、コマンドを実行して正しくインストールされていることを確認します。
code language-none java –version -
AEM 6.5 LTS互換Tomcat サーバーのセットアップ
-
AEM サーバーの開始パラメーターを確認し、必要システム構成に応じてパラメーターを更新してください。 詳しくは、Java 17/Java 21の考慮事項を参照してください
-
Java 17/Java 21を使用して、新しくダウンロードした6.5 LTS warをTomcat サーバーにデプロイし、次のコマンドを実行してAEM 6.5 LTS Tomcat サーバーを起動します。
code language-none $CATALINA_HOME/bin/catalina.sh start -
AEMを起動して実行したら、すべてのバンドルが実行状態であることを確認します。
https://<serveraddress:port>/cq/system/console/bundles -
AEM 6.5 LTS Tomcat サーバーを停止します。 ほとんどの場合、ターミナルから次のコマンドを実行して、
./catalina.shスクリプトを実行することで、これを行うことができます。code language-none $CATALINA_HOME/bin/catalina.sh stop -
次の手順に従って、AEM 6.5からAEM 6.5 LTSにコンテンツを移行します。AEM 6.5からAEM 6.5 LTSへのコンテンツの移行Oak – アップグレードを使用
-
コンテンツを移行したら、
sling.propertiesファイルに必要なカスタム変更を適用します -
次のコマンドを実行して、AEM 6.5 LTS Tomcat サーバーを起動します。
code language-none $CATALINA_HOME/bin/catalina.sh start -
AEMの起動時にエラーログを監視して、エラーがないことを確認し、AEMがスムーズに動作していることを確認します
-
AEM 6.5 LTSが開始されたら、バンドルが正しく機能していることを確認します。
https://<serveraddress:port>/cq/system/console/bundles
アップグレードしたコードベースのデプロイ deploy-upgraded-codebase
アップグレードプロセスが完了したら、更新されたコードベースをデプロイする必要があります。 ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。
アップグレード後のチェックとトラブルシューティングの実行 perform-post-upgrade-checks-and-troubleshooting
詳しくは、 アップグレード後の確認とトラブルシューティング を参照してください。