Ubuntu 20.04にApache Tomcat 10をインストールする方法を徹底解説

Apache Tomcat(Tomcatサーバー)は、JavaベースのWebアプリケーションを動作させるためのServletコンテナを備えたオープンソースのWebサーバーです。Tomcatには、JavaServer Pages(JSP)、WebSocket、Java Servlet、Java ELなどが含まれており、Javaコードを実行するための完全なJava HTTP Webサーバー環境を提供します。

熟練した開発者からなる大規模なコミュニティが、Apacheソフトウェア財団の管理下でTomcatサーバーをメンテナンスしています。そのため、Javaベースのアプリケーションを効率的に開発・運用するための優れた環境が整っています。クロスプラットフォームに対応しているため、WindowsとLinuxの両方で利用できる点も大きな魅力です。本記事の執筆時点におけるApache Tomcatの最新バージョンは10.0.18です。このガイドでは、Ubuntu 20.04にApache Tomcat 10をインストールする手順を6つのステップに分けて詳しく解説します。

1. Javaのインストール(最新版)

まず、Ubuntu 20.04をシステムに新規インストールしたばかりの場合は、Apache Tomcatをセットアップする前に、Linuxに新しいユーザーを追加しておく必要がある点に注意してください。

前述のとおり、Apache TomcatはJavaベースのアプリケーション向けに使用されるため、最新バージョンのJavaが必要です。最新のApache Tomcatを正しく動作させるには、JDK 8(Java Development Kit)以上のバージョンが必要となります。Linuxターミナルで以下のコマンドを実行すると、最新版のJDKをインストールできます。

sudo apt update

sudo apt install default-jdk -y

上記のコマンドで「-y」オプションを付けているのは、インストール時の確認メッセージを自動的にスキップするためです。次に、以下のコマンドでJavaのバージョンを確認しましょう。

java -version

上の画像のとおり、OpenJDKの最新バージョンである11.0.14がインストールされていることが確認できます。OpenJDKランタイム環境およびサーバーに関する重要な情報も同時に表示されます。

2. Apache Tomcat 10のインストール

Apache Tomcatには活発な開発チームがあり、最新のアップデートが定期的にリリースされています。以下のコマンドを使用して、公式サーバーからダウンロードしてください。

wget https://dlcdn.apache.org/tomcat/tomcat-10/v10.0.18/bin/apache-tomcat-10.0.18.tar.gz

このガイドを公開から数か月後に読んでいて、10.0.18以降に新しいバージョンがリリースされている場合は、上記コマンド内のバージョン番号を必ず変更してください。そのままだとコマンドが正常に機能せず、最新版のApache Tomcatのダウンロード中にエラーが発生します。

Tomcatのtar.gzファイルをダウンロードしたら、以下のコマンドでtarアーカイブを展開します。

tar xvf apache-tomcat-10.0.18.tar.gz

次に、展開したファイルを以下のコマンドで/usr/share/apache-tomcatディレクトリへ移動します。

sudo mv apache-tomcat-10.0.18 /usr/share/apache-tomcat

また、以下のコマンドを使えば、展開と移動を一つずつ実行する代わりに、一度に行うことも可能です。

sudo tar xzvf apache-tomcat-10*tar.gz -C /opt/tomcat --strip-components=1

3. Tomcatユーザーアカウントの設定

セキュリティの観点から、Tomcatサーバーは専用のユーザーアカウントで実行することをおすすめします。以下のコマンドを実行して、設定ファイルを開きましょう。

sudo nano /opt/tomcat/conf/tomcat-users.xml

次に、ユーザー名とパスワードを必要に応じて変更し、ファイルを保存します。

ロールを「manager」と「host-manager」に変更し、それぞれに対応するパスワードを設定してください。

最後に、Tomcatディレクトリに必要なファイル権限を以下のコマンドで設定します。

sudo chown -R tomcat:tomcat /opt/tomcat/ 
sudo chmod -R u+x /opt/tomcat/bin

4. Apache Tomcatへのアクセスを有効にする

host-managerおよびTomcatマネージャーアプリケーションには、デフォルトではlocalhostからのみアクセスできるため、アクセス権限の設定が重要です。アクセスを許可する方法は2つあり、特定のリモートシステムのみを許可するか、すべてのシステムを許可するかを選択できます。managerアプリケーションとhost-managerアプリケーション用に、context.xmlファイルを開いて編集します。

sudo nano /opt/tomcat/webapps/manager/META-INF/context.xml

sudo nano /opt/tomcat/webapps/host-manager/META-INF/context.xml

次に、アクセスを許可するIPアドレスを追加して該当行を変更します。Linuxで自分のIPアドレスを確認する方法がわからない場合は、関連ガイドを参照してください。

allow="127\.\d+\.\d+\.\d+|::1|0:0:0:0:0:0:0:1|10.0.2.15" />

最後にファイルを保存すると、システムがmanagerおよびhost-managerへのアクセスを許可するようになります。

5. Tomcatのsystemdファイルの設定

Tomcatには、サービスの起動・停止用のbashスクリプトが用意されていますが、systemdサービスとしてすべてのタスクを管理できるように、スタートアップスクリプトを作成することもできます。まず、以下のコマンドでtomcat.serviceファイルを開きましょう。

sudo nano /etc/systemd/system/tomcat.service

次に、以下の内容をエディタに貼り付けて保存します。

[Unit]
Description=Tomcat
After=syslog.target network.target
[Service]
Type=forking
User=tomcat
Group=tomcat
Environment=JAVA_HOME=/usr/lib/jvm/default-java
Environment='JAVA_OPTS=-Djava.awt.headless=true'
Environment=CATALINA_HOME=/usr/share/apache-tomcat
Environment=CATALINA_BASE=/usr/share/apache-tomcat
Environment=CATALINA_PID=/usr/share/apache-tomcat/temp/tomcat.pid
ExecStart=/usr/share/apache-tomcat/bin/catalina.sh start
ExecStop=/usr/share/apache-tomcat/bin/catalina.sh stop
[Install]
WantedBy=multi-user.target

以下のコマンドを実行してsystemdサービスをリロードし、ファイルに加えた変更を反映させます。

sudo systemctl daemon-reload

続いて、以下のコマンドでTomcatアプリケーションを起動し、自動起動を有効にします。

sudo systemctl start tomcat.service

sudo systemctl enable tomcat.service

ターミナルで以下のコマンドを実行して、Tomcatサービスのステータスを確認しましょう。

sudo systemctl status tomcat.service

上の画像のとおり、ステータスに「active (running)」と表示されていれば、Tomcatサービスが正常に稼働しています。

6. Tomcat Webサーバーへのアクセス

デフォルトでは、Tomcatサーバーはポート8080で実行されます。以下のコマンドでポートの状態を確認できます。

sudo ss -tunelp | grep 8080

次に、ブラウザからTomcatサーバーにアクセスします。

https://localhost:8080/

最後に、LinuxマシンからTomcat 10にアクセスするために、ユーザー名とパスワードを入力します。

Webインターフェースからは、サーバーのステータス確認、マネージャーアプリのダウンロード、host-managerの利用などが可能です。WebブラウザからTomcat 10にアクセスする際にエラーが発生した場合は、tomcat.serviceを再度リロードしてください。これにより、Tomcatサービスが新たに起動し、すべてのデータが正しく読み込まれます。tomcat.serviceをリロードした後は、前述の手順に従って、サービスの起動・有効化・ステータス確認を再度実行してください。

Apache Tomcat 10のインストール完了!

以上が、Ubuntu 20.04にApache Tomcat 10を簡単にインストールしてセットアップする方法です。本記事ではプロセスを6つのステップに分割し、Tomcat 10のインストールに関する必要な事項をすべて網羅しました。

Apache Tomcatのセットアップを成功させるためには、手順を一つずつ確実に実行することが重要です。インストールの流れは、Tomcat 10のインストールから始まり、WebブラウザからのTomcatサーバーへのアクセス確認で完了します。上記の手順では、Apache Tomcat 10をスムーズにインストールできるよう、いくつかのショートカット的なコマンドも紹介しています。ぜひ参考にしてください。