アプリケーションサーバーのインストール(WLP)のアップグレード手順 upgrade-steps-for-application-server-installations-wlp
アップグレード前の手順 pre-upgrade-steps
アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。 詳しくは、コードのアップグレードとカスタマイズおよびアップグレード前のメンテナンスタスクを参照してください。 さらに、お使いのシステムがAEM 6.5 LTS🔗の要件を満たしていることを確認してください。
アップグレードの計画と、AEM AnalyzerがAEMのアップグレードに関する複雑さを見積もるのに役立つことを確認してください。
移行の前提条件 migration-prerequisites
- 必要なJava バージョンの最小値:WLP サーバーにIBM® Sumeru JRE 17/21がインストールされていることを確認してください。
アップグレードの実行 performing-the-upgrade
-
アップグレード アクティビティを実行する前に、AEM 6.5 サーバーのバックアップなど、 アップグレード前の手順を完了していることを確認してください
-
要件に応じて、次のいずれかのアップグレードパスを選択します。
- インプレースアップグレード:現在のWLP サーバーがServlet 6をサポートしている場合、インプレースアップグレードを実行して手順3に進むことができます。
- Sidegrade:新しいセットアップを希望する場合、またはWLP サーバーがServlet 6をサポートしていない場合は、AEM 6.5からAEM 6.5 LTSへのコンテンツ移行Oak-upgrade ガイドに従って新しいWLP インスタンスを設定し、 アップグレードされたCodebase セクションにスキップしてコンテンツを移行します
-
AEM インスタンスを停止します。 これは通常、次のコマンドを使用して実行できます。
code language-shell <path-to-wlp-directory>/bin/server stop server_name -
不要なファイルとフォルダーを削除します。 具体的に削除する必要のある項目は次のとおりです。
-
dropinsフォルダーの cq-quickstart-65.war と、通常はそれぞれ<path-to-aem-server>/dropins/cq-quickstart-65.warと<path-to-aem-server>/apps/expanded/cq-quickstart-65.warにあるexpandedフォルダー -
launchpad/startupフォルダー。 サーバーフォルダーにいると仮定して、ターミナルで次のコマンドを実行することで削除できます。code language-shell rm -rf crx-quickstart/launchpad/startup -
base.jarファイル。 これには、次のコマンドを実行します。code language-shell find crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \; -
BootstrapCommandFile_timestamp.txtファイル:code language-shell rm -f crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt -
次を実行して、
sling.optionsファイルを削除します。code language-shell find crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \; -
sling.bootstrap.txtファイルを削除します。code language-shell rm -rf crx-quickstart/launchpad/sling_bootstrap.txt
-
-
sling.propertiesファイル (通常はcrx-quickstart/conf/に存在)のバックアップを作成して削除します -
サーブレットのバージョンを
server.xmlファイルの 6.0 に変更します -
Java 17/Java 21をインストールし、次のコマンドを実行して正しくインストールされていることを確認します。
code language-shell java -version -
AEM サーバーの開始パラメーターを確認し、要件に応じてパラメーターを更新してください。 詳しくは、Java 17/Java 21の考慮事項を参照してください。
-
新しい6.5 LTS戦争をダウンロードし、次の場所にあるDropins フォルダーにコピーします:
/<path-to-aem-server>/dropins/ -
AEM インスタンスを起動する:通常、次のコマンドを使用して実行できます。
code language-shell <path-to-wlp-directory>/bin/server start server_name -
sling.propertiesにカスタム変更がある場合は、次の手順に従ってください。<path-to-wlp-directory>/bin/server stop server_nameを実行してAEM インスタンスを停止します- カスタム
sling.propertiesの変更を、新しく生成されたsling.propertiesファイルに適用します(手順5で作成したバックアップファイルを参照します) - AEM インスタンスを起動します。 通常は、次を実行して実行できます:
<path-to-wlp-directory>/bin/server start server_name
アップグレードしたコードベースのデプロイ deploy-upgraded-codebase
アップグレードプロセスが完了したら、更新されたコードベースをデプロイする必要があります。 ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。
アップグレード後のチェックとトラブルシューティングの実行 perform-post-upgrade-checks-and-troubleshooting
アップグレード後のチェックおよびトラブルシューティングを参照してください。