Ubuntu で Apache Tomcat 11 のインストールとテスト実行

【概要】

このページでは，Ubuntu での Apache Tomcat 11 のインストールとテスト実行の手順を説明する（以下，Apache Tomcat のことを Tomcat と書く）。Tomcat 11 は Java 17 以降で動作し，本ページでは Eclipse Temurin 25 JDK を用いる。

【目次】

【関連する外部ページ】

Apache Tomcat 11 公式インストール手順

【サイト内の関連情報】

Ubuntu のインストールはこちらの別ページで説明している。

第１章　設定項目

このページでは，Apache 公式配布物（tar.gz）を展開してインストールする。Ubuntu の標準リポジトリには Tomcat 11 のパッケージが収録されていないため，公式配布物を用いる。次のように配置する。

第２章　前準備

Ubuntu のシステム更新

Ubuntu で OS のシステム更新を行うときは，端末で，次のコマンドを実行する。これは，パッケージ情報を最新の状態に保ち，インストール済みのパッケージをセキュリティアップデートやバグ修正を含めて更新するためである。 

# パッケージリストの情報を更新
sudo apt update
# インストール済みのパッケージを包括的に更新 (依存関係も考慮)
sudo apt full-upgrade
# カーネル更新等で実際に再起動が必要な場合のみ実行を推奨
# sudo shutdown -r now

Eclipse Temurin 25 JDK のインストール

Tomcat 11 の実行には Java 17 以降が必要である（Java 環境）。ここでは Eclipse Temurin 25 JDK を，Adoptium の公式 apt リポジトリからインストールする。端末で，次のコマンドを実行する。 

# リポジトリ追加に必要なパッケージを導入
sudo apt install -y wget apt-transport-https gpg
# Adoptium の GPG 公開鍵を取得
wget -qO - https://packages.adoptium.net/artifactory/api/gpg/key/public | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/adoptium.gpg > /dev/null
# Adoptium の apt リポジトリを登録
echo "deb https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
# パッケージリストの情報を更新
sudo apt update
# Temurin 25 JDK をインストール
sudo apt install -y temurin-25-jdk
# インストールの確認
java -version

第３章　Ubuntu での Apache Tomcat 11 のインストール手順例

Ubuntu を使用する場合は，次のように操作する。

  1. Apache 公式配布物のダウンロードと展開

    端末で，次のコマンドを実行する。バージョン番号（11.0.23）は，公式ダウンロードページで最新の 11 系に読み替える。 

    # 配布物をダウンロード
cd /tmp
wget https://dlcdn.apache.org/tomcat/tomcat-11/v11.0.23/bin/apache-tomcat-11.0.23.tar.gz
# /opt/tomcat へ展開
sudo mkdir -p /opt/tomcat
sudo tar -xzf apache-tomcat-11.0.23.tar.gz -C /opt/tomcat --strip-components=1
# 起動スクリプトに実行権限を付与
sudo chmod +x /opt/tomcat/bin/*.sh
  2. 環境変数の設定（/etc/bash.bashrc）

    /etc/bash.bashrc に次の2行を書き加える。 

    export CATALINA_HOME=/opt/tomcat
export CATALINA_BASE=/opt/tomcat

    環境変数 CATALINA_HOME，CATALINA_BASE が自動設定されるわけではないので，注意すること。

  3. Tomcat の起動 
    sudo /opt/tomcat/bin/startup.sh

第４章　Tomcat のテスト実行

Tomcat の example を開いてみる

Web ブラウザで http://localhost:8080/examples を開く（8080 は Tomcat の既定の HTTP ポート）。

Ubuntu の場合の Tomcat のファイル構成