CATALINA_HOMEが設定されない時の想定原因と対処法

投稿日：2021年3月14日更新日：2021年1月24日

＜目次＞

(１) CATALINA_HOMEが設定されない時の想定原因と対処法
　 (１-１) 発生状況・エラーメッセージ
　 (１-２) 原因
　 (１-３) 対処法

(１) CATALINA_HOMEが設定されない時の想定原因と対処法

Tomcatのインストールにおいて、TeraTermで環境変数CATALINA_HOMEがechoで表示されない（上手く設定できていない）場合に考え得る原因と対処方法について記述します。

(１-１) 発生状況・エラーメッセージ

TeraTermからTomcat8のインストールを実施した後に、環境変数CATALINA_HOMEの値を確認するために下記コマンドを実行したら、環境変数が表示されなかった。

$ echo $CATALINA_HOME

（図１１１）

＞目次にもどる

(１-２) 原因

CATALINA_HOME等の環境変数を設定する箇所はいくつかあり、例えば次のような設定箇所があります。

①systemdのユニットファイル

「ユニットファイル」はサービスとして起動する際の設定を行う際に作成するファイルです。[サービス名].serviceという名前で作成され、例えばTomcatの場合はtomcat.serviceといった名前です。このユニットファイルの中で、サービス起動時に設定する環境変数（CATALINA_HOME等）を定義しています。

サービスの場合は後述する「ログインシェルの起動ファイル」で設定された環境変数は読み込まれないため、このユニットファイルの中で確実に定義する必要があります。

（設定シーン）
サービス起動時に環境変数を使う場合

②ログインシェルの起動ファイル（/etc/profileなど）

TeraTerm等からID/Passwordを指定してリモート接続（ログインシェル）する際に適用される環境変数の設定です（/etc/profileなど）。

⇒参考：ログインシェルと非ログインシェルとは？

TeraTermでログインした際にCATALINA_HOMEが設定されていないケースはこちらに該当します。

（設定シーン）
ログインシェルで環境変数を使用する場合（SSHによるリモート接続等）

＞目次にもどる

(１-３) 対処法

ログインシェルの起動ファイル「/etc/profile」に環境変数の設定を追記していきます。

①viエディタで起動ファイルを開く
⇒viエディタの使い方

$ sudo vi /etc/profile

②環境変数の設定を追記

末尾に下記の文言を追記します。「XX」の箇所はご自身のTomcatのバージョンに併せて修正してください（例：apache-tomcat-8.5.55）

JRE_HOME=/usr/java/default
CATALINA_HOME=/usr/local/src/apache-tomcat-XX.XX.XX
export JRE_HOME CATALINA_HOME

（図１３２）

③ログアウト＆再ログイン

設定を反映するために、一度TeraTerm等をログアウトしてから、再度ログインします。

（図１３３）

④反映確認

再度echoコマンドで反映されている事を確認します。

$ echo $CATALINA_HOME

（図１３４）

＞目次にもどる