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

NOTE
ここでは、Tomcat 上のAEM 6.5 LTS からAEM 6.5 LTS Servicepack へのアップグレード(インプレースアップグレード)手順の概要を説明します。 AEM 6.5 から 6.5 LTS へのアップグレードについては ​ こちらを参照 ​

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

アップグレードを実行する前に、いくつかの手順を完了しておく必要があります。詳しくは ​ アップグレード前のメンテナンスタスク ​ を参照してください。 また、システムが AEM 6.5 LTS Servicepack の要件 ​ を満たしていることを確認し、​ アップグレード計画に関する考慮事項 ​ を参照してください。

移行の前提条件 migration-prerequisites

  • 最低限必要な Java バージョン:Tomcat サーバーにOracle® JRE 17/21 がインストールされていることを確認します。
  • Tomcat サーバー:AEM 6.5 LTS 用 Tomcat サーバーとそのサービスパックのサポート対象バージョンは、10.0.x10.1.x です。

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

この手順のすべての例では、Tomcat をアプリケーションサーバーとして使用しており、AEM 6.5 LTS の作業用バージョンが既にデプロイされていることを示しています。 ここでは、AEM バージョン 6.5 LTS から 6.5 LTS Servicepack へのアップグレードについて説明します。

  1. AEM 6.5 LTS が既にデプロイされている場合は、https://<serveraddress:port>/system/console/bundles にアクセスしてバンドルが正常に動作していることを確認します。

  2. 次に、AEM 6.5 LTS を停止します。 これは、次の場所にある Tomcat App Manager から実行できます。https://<serveraddress:port>/manager/html

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

  4. AEM 6.5 LTS Tomcat サーバーを停止します。 ほとんどの状況で、./catalina.sh スクリプトを実行することで設定できます。このために、ターミナルから次のコマンドを実行します。

    code language-none
    $CATALINA_HOME/bin/catalina.sh stop
    
  5. 不要なファイルとフォルダーを削除します。具体的に削除する必要のある項目は次のとおりです。

    • cq-quickstart-65.war ファイルと、通常 cq-quickstart-65 に配置され webapps フォルダーの <path-to-aem-server>/webapps フォルダー

    • launchpad/startup フォルダー。 サーバーフォルダーにいると仮定して、ターミナルで次のコマンドを実行して削除できます。

      code language-shell
      rm -rf <path-to-aem-server>/bin/crx-quickstart/launchpad/startup
      
    • base.jar ファイル。 これを行うには、次のコマンドを実行します。

      code language-shell
      find <path-to-aem-server>/bin/crx-quickstart/launchpad -type f -name "org.apache.sling.launchpad.base.jar*" -exec rm -f {} \;
      
    • BootstrapCommandFile_timestamp.txt ファイル:

      code language-shell
      rm -f <path-to-aem-server>/bin/crx-quickstart/launchpad/felix/bundle0/BootstrapCommandFile_timestamp.txt
      
    • 次のコマンドを実行して sling.options ファイルを削除します。

      code language-shell
      find <path-to-aem-server>/bin/crx-quickstart/launchpad -type f -name "sling.options.file" -exec rm -rf {} \;
      
    • sling.bootstrap.txt ファイルを削除します。

      code language-shell
      rm -rf <path-to-aem-server>/bin/crx-quickstart/launchpad/sling_bootstrap.txt
      
  6. sling.properties ファイル(通常 <path-to-aem-server>/bin/crx-quickstart/launchpad/ に存在)のバックアップを作成して削除します

  7. AEM 6.5 LTS Servicepack war ファイルを <path-to-aem-server>/webapps フォルダーにコピーします。

  8. 次のコマンドを実行して、AEM 6.5 LTS Tomcat サーバーを起動します。

    code language-none
    $CATALINA_HOME/bin/catalina.sh start
    
  9. AEMの起動中にエラーログを監視し、エラーがなく、AEMがスムーズに実行されていることを確認します

  10. AEM 6.5 LTS が起動したら、https://<serveraddress:port>/cq/system/console/bundles にアクセスしてバンドルが正常に機能していることを確認します。

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

詳しくは、​ アップグレード後のチェックとトラブルシューティング ​ を参照してください。

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