アプリケーションサーバーのインストールのアップグレード手順(Tomcat - インプレースアップグレード) upgrade-steps-for-application-server-installations-tomcat-inplace
アップグレード前の手順 pre-upgrade-steps
アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。詳しくは アップグレード前のメンテナンスタスク を参照してください。 また、システムが AEM 6.5 LTS Servicepack の要件 を満たしていることを確認し、 アップグレード計画に関する考慮事項 を参照してください。
移行の前提条件 migration-prerequisites
- 最低限必要な Java バージョン:Tomcat サーバーにOracle® JRE 17/21 がインストールされていることを確認します。
- Tomcat サーバー:AEM 6.5 LTS 用 Tomcat サーバーとそのサービスパックのサポート対象バージョンは、10.0.x と 10.1.x です。
アップグレードの実行 performing-the-upgrade
この手順のすべての例では、Tomcat をアプリケーションサーバーとして使用しており、AEM 6.5 LTS の作業用バージョンが既にデプロイされていることを示しています。 ここでは、AEM バージョン 6.5 LTS から 6.5 LTS Servicepack へのアップグレードについて説明します。
-
AEM 6.5 LTS が既にデプロイされている場合は、
https://<serveraddress:port>/system/console/bundlesにアクセスしてバンドルが正常に動作していることを確認します。 -
次に、AEM 6.5 LTS を停止します。 これは、次の場所にある Tomcat App Manager から実行できます。
https://<serveraddress:port>/manager/html -
アップグレードアクティビティを実行する前に、AEM 6.5 LTS サーバーのバックアップなどの アップグレード前 アクティビティが完了していることを確認してください
-
AEM 6.5 LTS Tomcat サーバーを停止します。 ほとんどの状況で、
./catalina.shスクリプトを実行することで設定できます。このために、ターミナルから次のコマンドを実行します。code language-none $CATALINA_HOME/bin/catalina.sh stop -
不要なファイルとフォルダーを削除します。具体的に削除する必要のある項目は次のとおりです。
-
cq-quickstart-65.war ファイルと、通常
cq-quickstart-65に配置されwebappsフォルダーの<path-to-aem-server>/webappsフォルダー -
launchpad/startupフォルダー。 サーバーフォルダーにいると仮定して、ターミナルで次のコマンドを実行して削除できます。code language-shell rm -rf <path-to-aem-server>/bin/crx-quickstart/launchpad/startup -
base.jarファイル。 これを行うには、次のコマンドを実行します。code language-shell find <path-to-aem-server>/bin/crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \; -
BootstrapCommandFile_timestamp.txtファイル:code language-shell rm -f <path-to-aem-server>/bin/crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt -
次のコマンドを実行して
sling.optionsファイルを削除します。code language-shell find <path-to-aem-server>/bin/crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \; -
sling.bootstrap.txtファイルを削除します。code language-shell rm -rf <path-to-aem-server>/bin/crx-quickstart/launchpad/sling_bootstrap.txt
-
-
sling.propertiesファイル(通常<path-to-aem-server>/bin/crx-quickstart/launchpad/に存在)のバックアップを作成して削除します -
AEM 6.5 LTS Servicepack war ファイルを
<path-to-aem-server>/webappsフォルダーにコピーします。 -
次のコマンドを実行して、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にアクセスしてバンドルが正常に機能していることを確認します。
アップグレード後のチェックとトラブルシューティングの実行 perform-post-upgrade-checks-and-troubleshooting
詳しくは、 アップグレード後のチェックとトラブルシューティング を参照してください。