アプリケーションサーバーのインストール(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 サーバーがServlet 6をサポートしている場合、インプレースアップグレードを実行して手順3に進むことができます。
    2. Sidegrade:新しいセットアップを希望する場合、またはWLP サーバーがServlet 6をサポートしていない場合は、AEM 6.5からAEM 6.5 LTSへのコンテンツ移行Oak-upgrade ガイドに従って新しいWLP インスタンスを設定し、​ アップグレードされたCodebase セクションにスキップしてコンテンツを移行します
  3. AEM インスタンスを停止します。 これは通常、次のコマンドを使用して実行できます。

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

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

  6. サーブレットのバージョンをserver.xml ファイルの​ 6.0 ​に変更します

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

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

  9. 新しい6.5 LTS戦争をダウンロードし、次の場所にあるDropins フォルダーにコピーします:/<path-to-aem-server>/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. カスタム sling.propertiesの変更を、新しく生成されたsling.properties ファイルに適用します(手順5で作成したバックアップファイルを参照します)
    3. AEM インスタンスを起動します。 通常は、次を実行して実行できます:<path-to-wlp-directory>/bin/server start server_name

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

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

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

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

recommendation-more-help
experience-manager-65-lts-help-main-toc