アプリケーションサーバーインストール(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
アップグレード後のチェックおよびトラブルシューティングを参照してください。