アプリケーションサーバーインストール(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 サーバーがサーブレット 6 をサポートしている場合は、インプレースアップグレードを実行して手順 3 を続行できます。
- サイドグレード:新しい設定を希望する場合、または WLP サーバーがサーブレット 6 をサポートしていない場合は、AEM AEM 6.5 to AEM 6.5 LTS Content Migration Using Oak-upgrade ガイドに従って、新しい WLP インスタンスを設定し、コンテンツを移行します。 アップグレードされたコードベースのデプロイの節にスキップします
-
AEM インスタンスを停止します。通常は、次のコマンドを使用して実行できます。
code language-shell <path-to-wlp-directory>/bin/server stop server_name
-
不要なファイルとフォルダーを削除します。具体的に削除する必要のある項目は次のとおりです。
-
通常、フォルダーの cq-quickstart-65.war
dropins
とexpanded
フォルダーはそれぞれ<path-to-aem-server>/dropins/cq-quickstart-65.war
と<path-to-aem-server>/apps/expanded/cq-quickstart-65.war
にあります -
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/
に存在)のバックアップを作成して削除します -
ファイルで servlet のバージョンを 6.0
server.xml
に変更します -
Java 17/Java 21 をインストールし、次を実行して正しくインストールされていることを確認します。
code language-shell java -version
-
AEM サーバーの開始パラメーターを確認し、必要に応じてパラメーターを更新してください。 詳しくは、Java 17/Java 21 に関する考慮事項を参照してください。
-
新しい 6.5 LTS war をダウンロードし、
/<path-to-aem-server>/dropins/
にある 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 インスタンスを停止します。- 手順 5 で作成したバックアップファイルを参照して、カスタム
sling.properties
の変更を新しく生成されたsling.properties
ファイルに適用します。 - AEM インスタンスを起動します。 通常は、次を実行することで実行できます。
<path-to-wlp-directory>/bin/server start server_name
アップグレードしたコードベースのデプロイ deploy-upgraded-codebase
アップグレードプロセスが完了したら、更新されたコードベースをデプロイする必要があります。 ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。
アップグレード後のチェックとトラブルシューティングの実行 perform-post-upgrade-checks-and-troubleshooting
アップグレード後のチェックおよびトラブルシューティングを参照してください。