コンテンツ

概要

Apache Tomcat® のアップグレードは、環境の複雑さによって、簡単にも複雑にもなります。このドキュメントでは、Apache Tomcat のアップグレードの基本事項を説明し、独自の環境固有のアップグレード計画と手順を確立するための出発点として使用できます。

目次

対象外の項目

この基本的なアップグレードガイドでは、扱っていないいくつかのトピックがあります。

パッチ

Apache Tomcat プロジェクトはパッチを提供していません。Tomcat の特定のバージョンで機能、バグ修正、またはセキュリティパッチが発表された場合、そのバージョンにアップグレードする必要があります。OS ベンダーやその他の技術サポート組織からパッチを入手できる場合がありますが、Apache Tomcat プロジェクトはそのようなパッチを提供しません。

組み込み Tomcat

組み込み環境で使用されている Apache Tomcat のアップグレードは、このドキュメントではカバーしていません。組み込み環境で Apache Tomcat を使用している場合、ここに提供されているような入門ドキュメントなしでアップグレードを実行するために必要な知識を持っているものと想定されます。

アップグレードの種類

アップグレードは、メジャーバージョン間のアップグレード(例:9.0 から 10.0) – 「メジャーアップグレード」として知られるものと、単一バージョン内のアップグレード(例:9.0.45 から 9.0.85) – 「マイナーアップグレード」として知られるものの2種類に分けられます。各アップグレードの種類で従うべき手順は異なります。

バージョニング

Apache Tomcat のバージョン番号は X.Y.Z の形式で、X.Y は「メジャー」バージョン番号、Z はメジャーバージョン内のリビジョン番号です。Tomcat 10.1 と 11.0 間のアップグレードは「メジャーアップグレード」と見なされ、10.1.20 から 10.1.21 へのアップグレードは「マイナーアップグレード」と見なされます。

メジャーアップグレード

Tomcat のメジャーバージョン間をアップグレードする場合(例:9.0 から 10.1)、Tomcat の標準インストールから開始し、新しい設定ファイルをニーズに合わせて調整し、アプリケーションを追加するなどの方法が最適です。

移行ガイドを読む

特定のアップグレードページに関連する移行ガイドを読んでください。Apache Tomcat 9.0 から Apache Tomcat 10.1 にアップグレードする場合、以前のバージョンからのアップグレードに適用されるすべての内容をカバーしている「Tomcat 10.1 移行ガイド」を読む必要があります。

一度に複数のバージョンを飛び越えてアップグレードする場合、その間のすべての移行ガイドを読む必要があります。例えば、Tomcat 8.5 から Tomcat 10.1 にアップグレードする場合、「Tomcat 9.0 移行ガイド」、「Tomcat 10.0 移行ガイド」、そして「Tomcat 10.1 移行ガイド」を読む必要があります。

server.xml ファイルの移行

おそらく移行しなければならない最も重要な設定ファイルは、conf/server.xml ファイルでしょう。

server.xml ファイルにどのような変更が必要かを素早く判断する一つの方法は、diff プログラムを使用して、既存の古い Tomcat バージョンファイルと、古い Apache Tomcat バージョンに付属していた標準設定ファイルを比較することです。

例:

$ diff /path/to/stock/tomcat/conf/server.xml /path/to/your/tomcat/conf/server.xml

これにより、元のファイルに対して、あなたの環境に固有の変更点が表示されます。これらの変更点を新しい Apache Tomcat バージョンの新規インストールに適用できます。

その他の重要なファイル

以前のインストールからコピーまたは適応したい設定ファイルが他にもいくつかあります。以下は、古いインストールでカスタマイズした可能性のあるその他のファイルのリストです。

  • conf/web.xml
  • conf/context.xml
  • conf/tomcat-users.xml
  • conf/logging.properties
  • bin/setenv.sh (存在する場合)
  • conf/catalina.properties
  • conf/catalina.policy
  • conf/jaspic-providers.xml

不明な場合は、上記と同じ手法を使用して、インストールと標準の Apache Tomcat 設定ファイルとの間の相違点を確認できます。

マイナーアップグレード

多くの場合、マイナーアップグレードは非常に単純で、以前のバージョンと同じ設定ファイルを変更なしで使用できます。

移行ガイドを読む

使用しているメジャーバージョンの移行ガイド、特に「アップグレード」セクションを読むことは依然として重要です。

移行ガイドには、「注目すべき変更」セクションも含まれており、メジャーバージョン内の変更、つまりメジャーバージョンのリビジョン番号内のマイナーバージョンに含まれる非常に重要な変更が記載されています。これらの種類の変更には、新しいデフォルトの導入、新しい要件(通常はセキュリティのため)、または以前のバージョンからの互換性のない変更(これも通常はセキュリティのため)が含まれます。

最後に、移行ガイドには、マイナーバージョン間の標準設定ファイルを比較して、それらのバージョン間で重要な変更が加えられたかどうかを確認できるセクションがあります。使い方は簡単です。移行ガイドページのドロップダウンボックスから古いバージョンと新しいバージョンを選択し、「View Differences」をクリックするだけです。

設定の分割

RUNNING.txtには、「高度な設定 - 複数の Tomcat インスタンス」というタイトルのセクションがあります。これは、単一の Apache Tomcat インストールを使用して複数の個別のサーバーインスタンスを実行する方法を説明することを意図しています。この手法は、アップグレードを簡素化するのに役立ちます。

インストールを分割するプロセス、そしてアップグレードを実行する方法を説明するプレゼンテーションが利用可能です。

より簡単なアップグレードのために Tomcat のインストールを分割する