アプリケーションサーバーのインストールのアップグレード手順(Tomcat) 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-upgrade を使用する
-
コンテンツが移行されたら、
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
詳しくは、 アップグレード後のチェックとトラブルシューティングを参照してください。