アプリケーションサーバーインストール(WLP)のアップグレード手順 upgrade-steps-for-application-server-installations-wlp

NOTE
ここでは、WLP (WebSphere® Liberty)上のAEM 6.5 LTS のアップグレード手順の概要を説明します。

アップグレード前の手順 pre-upgrade-steps

アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。詳しくは、コードのアップグレードとカスタマイズおよびアップグレード前のメンテナンスタスクを参照してください。さらに、お使いのシステムが AEM 6.5 LTS の要件を満たしていることを確認してください。

アップグレードの計画や、AEM Analyzer を使用してAEMのアップグレードの複雑さを見積もる方法を確認してください。

移行の前提条件 migration-prerequisites

  • 最低限必要な Java バージョン:WLP サーバーにIBM® Sumeru JRE 17/21 がインストールされていることを確認します。

アップグレードの実行 performing-the-upgrade

  1. アップグレードアクティビティを実行する前に、AEM 6.5 サーバーのバックアップなどの アップグレード前手順を完了していることを確認してください

  2. 要件に応じて、次のいずれかのアップグレードパスを選択します。

    1. インプレースアップグレード:現在の WLP サーバーがサーブレット 6 をサポートしている場合は、インプレースアップグレードを実行して手順 3 を続行できます。
    2. サイドグレード:新しい設定を希望する場合、または WLP サーバーがサーブレット 6 をサポートしていない場合は、AEM AEM 6.5 to AEM 6.5 LTS Content Migration Using Oak-upgrade ガイドに従って、新しい WLP インスタンスを設定し、コンテンツを移行します。 アップグレードされたコードベースのデプロイの節にスキップします
  3. AEM インスタンスを停止します。通常は、次のコマンドを使用して実行できます。

    code language-shell
    <path-to-wlp-directory>/bin/server stop server_name
    
  4. 不要なファイルとフォルダーを削除します。具体的に削除する必要のある項目は次のとおりです。

    • 通常、フォルダーの cq-quickstart-65.wardropinsexpanded フォルダーはそれぞれ <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
      
  5. sling.properties ファイル(通常 crx-quickstart/conf/ に存在)のバックアップを作成して削除します

  6. ファイルで servlet のバージョンを 6.0server.xml に変更します

  7. Java 17/Java 21 をインストールし、次を実行して正しくインストールされていることを確認します。

    code language-shell
    java -version
    
  8. AEM サーバーの開始パラメーターを確認し、必要に応じてパラメーターを更新してください。 詳しくは、Java 17/Java 21 に関する考慮事項を参照してください。

  9. 新しい 6.5 LTS war をダウンロードし、/<path-to-aem-server>/dropins/ にある dropins フォルダーにコピーします。

  10. AEM インスタンスを起動します。通常は、次のコマンドを使用して起動できます。

    code language-shell
    <path-to-wlp-directory>/bin/server start server_name
    
  11. sling.properties にカスタムの変更がある場合は、次の手順に従ってください。

    1. <path-to-wlp-directory>/bin/server stop server_name を実行して、AEM インスタンスを停止します。
    2. 手順 5 で作成したバックアップファイルを参照して、カスタム sling.properties の変更を新しく生成された sling.properties ファイルに適用します。
    3. AEM インスタンスを起動します。 通常は、次を実行することで実行できます。<path-to-wlp-directory>/bin/server start server_name

アップグレードしたコードベースのデプロイ deploy-upgraded-codebase

アップグレードプロセスが完了したら、更新されたコードベースをデプロイする必要があります。 ターゲットバージョンの AEM で動作するようにコードベースを更新するための手順については、コードおよびカスタマイズのアップグレードのページを参照してください。

アップグレード後のチェックとトラブルシューティングの実行 perform-post-upgrade-checks-and-troubleshooting

アップグレード後のチェックおよびトラブルシューティングを参照してください。

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2