はじめに

CentOS7 tomcatインストールをしてみました。

前提条件

Virtualbox　CentOS7のゲストOSを作成

作業概要

CentOS7 に Apache Tomcat 9.0.96 を導入した

OpenJDK 1.8.0 を yum（JAIST Vaultリポジトリ）からインストール

systemd によるサービス化まで対応

参考サイト

/etc/yum.repos.d配下にCentOS--valut用のリポジトリを作成

[root@localhost yum.repos.d]# pwd
/etc/yum.repos.d
[root@localhost yum.repos.d]# ls -tlr
合計 4
-rw-r--r--. 1 root root 586  7月 19 22:54 CentOS--valut.repo
drwxr-xr-x. 2 root root 248  7月 19 23:09 disable
[root@localhost yum.repos.d]#

JAISTミラーを使用

[root@localhost yum.repos.d]# cat CentOS--valut.repo
[vault-base]
name=CentOS-7 Vault Base
baseurl=http://ftp.jaist.ac.jp/pub/Linux/CentOS-vault/7.9.2009/os/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

[vault-updates]
name=CentOS-7 Vault Updates
baseurl=http://ftp.jaist.ac.jp/pub/Linux/CentOS-vault/7.9.2009/updates/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

[vault-extras]
name=CentOS-7 Vault Extras
baseurl=http://ftp.jaist.ac.jp/pub/Linux/CentOS-vault/7.9.2009/extras/$basearch/
enabled=1
gpgcheck=1
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7

[root@localhost yum.repos.d]#

YUMが保持しているキャッシュをすべて削除＆すべての有効なリポジトリからパッケージ情報を取得してキャッシュ化

[root@localhost yum.repos.d]# yum clean all && sudo yum makecache
読み込んだプラグイン:fastestmirror
リポジトリーを清掃しています: vault-base vault-extras vault-updates
読み込んだプラグイン:fastestmirror
Determining fastest mirrors
vault-base                                                                                                 | 3.6 kB  00:00:00
vault-extras                                                                                               | 2.9 kB  00:00:00
vault-updates                                                                                              | 2.9 kB  00:00:00
(1/10): vault-base/x86_64/group_gz                                                                         | 153 kB  00:00:15
(2/10): vault-base/x86_64/primary_db                                                                       | 6.1 MB  00:00:16
(3/10): vault-base/x86_64/filelists_db                                                                     | 7.2 MB  00:00:39
(4/10): vault-base/x86_64/other_db                                                                         | 2.6 MB  00:00:09
(5/10): vault-extras/x86_64/filelists_db                                                                   | 305 kB  00:00:15
(6/10): vault-extras/x86_64/other_db                                                                       | 154 kB  00:00:00
(7/10): vault-extras/x86_64/primary_db                                                                     | 253 kB  00:00:16
(8/10): vault-updates/x86_64/filelists_db                                                                  |  15 MB  00:01:50
(9/10): vault-updates/x86_64/other_db                                                                      | 1.6 MB  00:00:05
(10/10): vault-updates/x86_64/primary_db                                                                   |  27 MB  00:02:46
メタデータのキャッシュを作成しました

jdkインストール

# yum -y install java-1.8.0-openjdk-devel

apache-tomcat-9.0.17をダウンロードする

# cd /usr/local/src

# wget -4 https://archive.apache.org/dist/tomcat/tomcat-9/v9.0.96/bin/apache-tomcat-9.0.96.tar.gz

apache-tomcat-9.0.96.tar.gzを展開する

# tar xvzf apache-tomcat-9.0.96.tar.gz

/usr/local/src/apache-tomcat-9.0.96を/usr/tomcat9へリネームする

# mv apache-tomcat-9.0.96 /usr/tomcat9

環境変数設定

[root@localhost src]#
[root@localhost src]# cat /etc/profile.d/tomcat.sh
export CATALINA_HOME=/usr/tomcat9
export CATALINA_BASE=/usr/tomcat9

環境変数読み込み

# source /etc/profile.d/tomcat.sh

Tomcat のバージョン情報と環境設定を表示するスクリプト
※Tomcatをダウンロードしたらもともと入っているスクリプト「/usr/tomcat9/bin/version.sh」です

# /usr/tomcat9/bin/version.sh

Using CATALINA_BASE:   /usr/tomcat9
Using CATALINA_HOME:   /usr/tomcat9
Using CATALINA_TMPDIR: /usr/tomcat9/temp
Using JRE_HOME:        /usr
Using CLASSPATH:       /usr/tomcat9/bin/bootstrap.jar:/usr/tomcat9/bin/tomcat-juli.jar
Using CATALINA_OPTS:
Server version: Apache Tomcat/9.0.96
Server built:   Oct 3 2024 19:44:30 UTC
Server number:  9.0.96.0
OS Name:        Linux
OS Version:     3.10.0-1160.el7.x86_64
Architecture:   amd64
JVM Version:    1.8.0_412-b08
JVM Vendor:     Red Hat, Inc.

ホームディレクトリを作成せずに/usr/tomcat9をホームディレクトリとしてtomcatユーザを作成する

# useradd -M -d /usr/tomcat9 tomcat

/usr/tomcat9の配下の所有ユーザと所有グループをtomcatとする

chown -R tomcat:tomcat /usr/tomcat9

tomcat9を起動

[root@localhost src]# $CATALINA_HOME/bin/startup.sh
Using CATALINA_BASE:   /usr/tomcat9
Using CATALINA_HOME:   /usr/tomcat9
Using CATALINA_TMPDIR: /usr/tomcat9/temp
Using JRE_HOME:        /usr
Using CLASSPATH:       /usr/tomcat9/bin/bootstrap.jar:/usr/tomcat9/bin/tomcat-juli.jar
Using CATALINA_OPTS:
Tomcat started.

tomcat9を停止

[root@localhost src]# $CATALINA_HOME/bin/shutdown.sh
Using CATALINA_BASE:   /usr/tomcat9
Using CATALINA_HOME:   /usr/tomcat9
Using CATALINA_TMPDIR: /usr/tomcat9/temp
Using JRE_HOME:        /usr
Using CLASSPATH:       /usr/tomcat9/bin/bootstrap.jar:/usr/tomcat9/bin/tomcat-juli.jar
Using CATALINA_OPTS:

systemdユニットファイル作成

# vi /usr/lib/systemd/system/tomcat9.service

[Unit]
Description=Apache Tomcat Servlet Container
After=syslog.target network.target

[Service]
Type=forking
User=tomcat
Group=tomcat
ExecStart=/usr/tomcat9/bin/startup.sh
ExecStop=/usr/tomcat9/bin/shutdown.sh
KillMode=none

[Install]
WantedBy=multi-user.target

tomcat9サービスを自動起動して起動する

systemctl enable tomcat9
systemctl start tomcat9

tomcat9サービスが起動したことを確認する

[root@localhost logs]# systemctl status tomcat9.service
● tomcat9.service - Apache Tomcat Servlet Container
   Loaded: loaded (/usr/lib/systemd/system/tomcat9.service; enabled; vendor preset: disabled)
   Active: active (running) since 日 2025-07-20 00:02:49 JST; 5s ago
  Process: 10610 ExecStart=/usr/tomcat9/bin/startup.sh (code=exited, status=0/SUCCESS)
 Main PID: 10624 (java)
   CGroup: /system.slice/tomcat9.service
           mq10624 /usr/bin/java -Djava.util.logging.config.file=/usr/tomcat9/conf/logging.properties -Djava.util.logging.manag...

 7月 20 00:02:49 localhost.localdomain systemd[1]: Starting Apache Tomcat Servlet Container...
 7月 20 00:02:49 localhost.localdomain systemd[1]: Started Apache Tomcat Servlet Container.

httpsとhttpと8080ポートを許可した

# firewall-cmd --permanent --add-service=http
# firewall-cmd --permanent --add-service=https
# firewall-cmd --permanent --add-port=8080/tcp

ファイアウォールを反映させる
# firewall-cmd --reload

以下のURLにてブラウザでアクセスする

http://サーバのIPアドレス:8080/

Basic 認証を設定

以下のサイトを参考にしました。
https://qiita.com/KOJI-YAMAMOTO/items/c1dd9ad924ba197a9a79

/usr/tomcat9/conf/web.xmlにBasic認証の設定を追加

行末の上に追加する
先頭の+が追加した行です。

[root@localhost conf]# diff -u /usr/tomcat9/conf/web.xml_org /usr/tomcat9/conf/web.xml
--- /usr/tomcat9/conf/web.xml_org       2024-10-04 04:44:30.000000000 +0900
+++ /usr/tomcat9/conf/web.xml   2025-07-20 22:47:40.068879089 +0900
@@ -4749,4 +4749,23 @@
         <welcome-file>index.jsp</welcome-file>
     </welcome-file-list>

+    <security-constraint>
+      <web-resource-collection>
+       <web-resource-name>User Basic Auth</web-resource-name>
+       <url-pattern>/*</url-pattern>
+     </web-resource-collection>
+     <auth-constraint>
+       <role-name>role1</role-name>
+     </auth-constraint>
+    </security-constraint>
+
+    <login-config>
+      <auth-method>BASIC</auth-method>
+      <realm-name>User Basic Auth</realm-name>
+    </login-config>
+   <security-role>
+     <role-name>role1</role-name>
+   </security-role>
+
+
 </web-app>

xmlを文法チェックするためにxmllint（libxml2）をインストールする

#  yum install -y libxml2

/usr/tomcat9/conf/web.xmlの文法チェックする
リターンコードで正常の0が返ってくること


#  xmllint --noout /usr/tomcat9/conf/web.xml
#  echo $?
# 0

/usr/tomcat9/conf/tomcat-users.xmlにユーザとパスワード情報を設定

先頭の+が追加した行です

[root@localhost conf]# diff -u /usr/tomcat9/conf/tomcat-users.xml_org /usr/tomcat9/conf/tomcat-users.xml
--- /usr/tomcat9/conf/tomcat-users.xml_org      2024-10-04 04:44:30.000000000 +0900
+++ /usr/tomcat9/conf/tomcat-users.xml  2025-07-20 22:49:05.041634227 +0900
@@ -52,5 +52,9 @@
   <user username="tomcat" password="<must-be-changed>" roles="tomcat"/>
   <user username="both" password="<must-be-changed>" roles="tomcat,role1"/>
   <user username="role1" password="<must-be-changed>" roles="role1"/>
+
 -->
+<role rolename="role1"/>
+<user username="sample" password="test" roles="role1"/>
+
 </tomcat-users>

/usr/tomcat9/conf/tomcat-users.xmlの文法チェックをする　
リターンコードで正常の0が返ってくること

# xmllint --noout /usr/tomcat9/conf/tomcat-users.xml
# echo $?
# 0

構文チェックの失敗パターンを試してみました

<5userの誤った文としました。 正しくは<userです

<role rolename="role1"/>
<5user username="sample" password="test" roles="role1"/>

エラー文が出力されます

[root@localhost conf]# xmllint --noout /usr/tomcat9/conf/tomcat-users.xml
/usr/tomcat9/conf/tomcat-users.xml:59: parser error : StartTag: invalid element name
<5user username="sample" password="test" roles="role1"/>
 ^

ブラウザにてtomcatにアクセスするとユーザとパスワードを求められた

Basic認証が動作しています。

tomcatに/usr/tomcat9/conf/tomcat-users.xmlにて設定したユーザとパスワードを入力してログインしました

OSに入ってtomcatのバージョンを確認してみた

環境変数を確認
CATALINA_HOMEに現在使用しているtomcatのパスが設定してあります。

# env | grep CATA
CATALINA_HOME=/usr/tomcat9
CATALINA_BASE=/usr/tomcat9

現在のtomcatのバージョンを確認するコマンド

# cat $CATALINA_HOME/RELEASE-NOTES | grep "Apache Tomcat Version"
                     Apache Tomcat Version 9.0.96

環境によっては以下のファイルでもtomcatのバージョンを確認できます。
本記事の環境ではVERSION.txtがないため、バージョンを確認することが出来ませんでした

# cat $CATALINA_HOME/VERSION.txt

まとめ

CentOS 7 に Apache Tomcat をインストールしました。
今回特に苦労した点は、CentOS 7 がすでにサポート終了（EOL）となっており、標準のリポジトリが利用できなかったことです。パッケージのインストールがうまくいかず苦戦しましたが、参照リポジトリを Vault（JAIST ミラー）に切り替えることで無事解決しました。

Tomcat は他の一般的なサービス（nginx や httpd など）と比べて構成がやや複雑で、Java 環境の準備や systemd サービス化の作業が必要です。ただし、一つひとつの手順を丁寧に確認しながら進めれば、安定して構築できます。

tomcatは基本的にはxmlファイルで構成されています。一部シェルなどのファイルが含まれる場合もあります。

Tomcatのサービスを再起動前にxml構文チェック「xmllint 」は実施した方が良いです。
文法エラーでTomcatのサービスの起動に失敗する可能性があるため