コンテンツ
概要
目次
対象外
この基本的なアップグレードガイドでは対象となっていないトピックがいくつかあります。
パッチ
Apache Tomcatプロジェクトでは、パッチを提供していません。Tomcatの特定のバージョンで機能、バグ修正、またはセキュリティパッチが発表された場合は、そのバージョンにアップグレードする必要があります。OSベンダーまたはその他のテクニカルサポート組織からパッチを入手できる場合がありますが、Apache Tomcatプロジェクトではそのようなパッチは提供しません。
組み込みTomcat
組み込み環境で使用されているApache Tomcatのアップグレードは、このドキュメントでは説明していません。組み込み環境でApache Tomcatを使用している場合は、ここで提供されている入門ドキュメントなしでアップグレードを実行するために必要な知識を持っていると想定しています。
アップグレードの種類
アップグレードは、メジャーバージョン間のアップグレード(例:9.0から10.0) - 「メジャーアップグレード」として知られています - と、単一バージョン内でのアップグレード(例:9.0.45から9.0.85) - 「マイナーアップグレード」として知られています - の2種類のアップグレードに分類できます。それぞれの種類のアップグレードには、異なる手順に従う必要があります。
バージョン管理
メジャーアップグレード
Tomcatのメジャーバージョン間(例:9.0から10.0)をアップグレードする場合は、Tomcatの標準インストールから開始し、新しい構成ファイルを必要に応じて調整し、アプリケーションを追加するなどする方が最善です。
移行ガイドを読む
該当するアップグレードページに関連する移行ガイドを読む必要があります。Apache Tomcat 9.0からApache Tomcat 10.0にアップグレードする場合は、「Tomcat 10.0移行ガイド」を読んでください。これには、以前のバージョンからのアップグレードに適用されるすべての情報が含まれています。
一度に複数のバージョンをアップグレードする場合は、その間のすべての移行ガイドを読む必要があります。たとえば、Tomcat 8.5からTomcat 10.1にアップグレードする場合は、「Tomcat 9.0移行ガイド」、「Tomcat 10.0移行ガイド」、「Tomcat 10.1移行ガイド」を読む必要があります。
server.xmlファイルの移行
おそらく、移行する必要がある最も重要な構成ファイルは、conf/server.xml
ファイルです。
server.xml
ファイルに必要な変更の種類を迅速に判断する1つの方法は、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構成ファイルの違いを確認できます。
マイナーアップグレード
多くの場合、マイナーアップグレードは非常に簡単で、変更を加えることなく、以前のバージョンと同じ構成ファイルを使用できます。
移行ガイドを読む
使用しているメジャーバージョンの移行ガイド、特に「アップグレード」セクションを読むことは依然として重要です。
移行ガイドには、「注目すべき変更点」セクションも含まれており、メジャーバージョン内での変更(つまり、メジャーバージョンのリビジョン番号内のマイナーバージョン)が含まれており、非常に重要な変更が含まれています。このような変更には、新しいデフォルトの導入、新しい要件(通常はセキュリティのため)、以前のバージョンからの破壊的な変更(これも通常はセキュリティのため)が含まれます。
最後に、移行ガイドには、マイナーバージョン間の標準構成ファイルを比較して、それらのバージョン間で重要な変更が行われたかどうかを確認できるセクションがあります。使い方は簡単です。移行ガイドページのドロップダウンボックスから古いバージョンと新しいバージョンを選択し、「違いを表示」をクリックするだけです。
分割構成
RUNNING.txt
には、「高度な構成 - 複数のTomcatインスタンス」というタイトルのセクションがあります。これは、単一のApache Tomcatインストールを使用して、複数の個別のサーバーインスタンスを実行する方法について説明することを目的としています。この手法は、アップグレードの簡素化に役立ちます。
インストールの分割プロセスを説明し、アップグレードの実行方法について説明するプレゼンテーションがあります。