TomcatはJavaでWebアプリケーションを動かすために必要なソフトウェアだ。だいたいJavaを使うときはTomcatを使うのが一般的になっている。
このページではTomcatのインストール方法をご紹介しよう。初心者の方向けに紹介している。
目次
Tomcatとは？
TomcatはJavaで作られたWebアプリケーションを動かすために必要なWebコンテナの1つだ。Webコンテナなどの言葉がわからない方は下記をご参考に。
フリーで使えるものの中では最もメジャーと言えるのではないだろうか。
Webコンテナではあるが簡易なWebサーバー機能も備えており、簡易的に使うならTomcat単体でも十分だろう。システムとして公開したりする場合は、Webサーバーは別に用意し、連携して使う必要がある。
インストールの前提
このページでインストールを行う環境は以下だ。
|
OS |
Windows10(64Bit) |
|
Tomcat |
9.0.0.M10 |
※Tomcatを動かすためにはJDKがインストールされていることが前提となる。コマンドプロンプトでコマンド「java –version」を実行し、インストール済みであることを確認しよう。下記も参考に。
ダウンロード
Tomcatのダウンロードは、次のサイトから行える。
Apache Tomcat http://tomcat.apache.org/download-90.cgi
環境に合わせてバージョンを選ぼう。今回は最新のTomcat9をダウンロードする。
64bit版、32bit版がある。自身のPC環境に合ったものをダウンロードしよう。
Tomcatのインストール
ZIPファイルの展開
ダウンロードしたZIPファイル「apache-tomcat-9.0.0.M10.zip」を展開し、任意の場所へ置く。特に決まりはない。ここではCドライブ直下に置いた。
※「C:\Program Files」へ配置するとWinodows10のUACの影響で非常に苦労する場合があるのでUACの影響を受けない場所への配置をお勧めする。
またフォルダ名はわかりやすいように変更しても構わない。
（apache-tomcat-9.0.0.M10 → tomcat-9.0.0 など）
環境変数の設定
まずは、環境変数を設定していく。環境変数についてわからない方は下記ページを参考にしてほしい。
環境変数「CATALINA_HOME」を作成する。ユーザー変数で良い。変数値にはTomcatフォルダを置いた場所を指定する。
続いて、環境変数「Path」を編集する。末尾に「;%CATALINA_HOME%\bin;」という文字列を追記。
最後に、システム環境変数「JAVA_HOME」の確認しよう。
システム環境変数にJAVA_HOMEがあればOKだ。もしない場合は追加する必要がある。変数値はPCにインストールされているJavaフォルダの位置だ。
起動と停止
起動
Tomcatフォルダ配下のbinフォルダ内の「startup.bat」をダブルクリック。
以下のような画面が出ればOK。
正常に起動していれば、最後に「情報: Server startup in 1789ms」というような起動にかかった時間が表示される。また、
Webブラウザを立ち上げて「http://localhost:8080/」へアクセス。次の画面が表示される。
停止
binフォルダ内「shutdown.bat」をダブルクリックすればよい。
エラー
startup.batをダブルクリックしても起動できない場合は何も表示されない。そのような時はコマンドプロンプトを立ち上げ、binフォルダがある場所まで移動し、「startup.bat」をコマンドプロンプトから実行しよう。エラー内容が表示される。
|
1 2 3 |
Neither the JAVA_HOME nor the JRE_HOME environment variable is defined At least one of these environment variable is needed to run this program |
上記エラーは、環境変数「JAVA_HOME」が設定されていないために発生している。
Webアプリケーションマネージャ有効化
Tomcatにアプリケーションを配備した時の実行や停止、再実行を画面から実行できる「Webアプリケーションマネージャ」を有効にしよう。
「apache-tomcat-9.0.0.M10\conf」フォルダにある「tomcat-users.xml」ファイルを変更する。
「tomcat-users」要素に下記の行を追加する。
|
1 2 |
<role rolename="manager-gui"/> <user username="admin"password="pass" roles="manager-gui"/> |
※usernameとpasswordには任意の値を設定できる。
tomcatを再起動し、下記のURLにアクセスする。
http://localhost:8080/manager/html
アカウントとパスワードの入力を求められるので、設定したアカウントとパスワードを入力する。認証されると次の画面が表示される。
まとめ
このページではTomcatのインストール方法についてまとめてご紹介をしてきた。Tomcatのインストールはそれほど手順が多くないため、比較的わかりやすいだろう。
参考にしていただければ幸いだ。
localhostでアクセスすると無事開けるのでサーバーは立ち上げられていると思うのですが、startup.batで起動されたコマンドプロンプト内に文字化けがあります。(おそらく日本語が含まれているURIなどが文字化けしている。)
改善策がありましたら是非教えてほしいです。
いつもご愛読いただきありがとうございます。
コマンドプロンプトでは表示ためのフォント（書体）を自由に設定できるのですが、まずはそちらをご確認いただけますでしょうか。
(1) コマンドプロンプトのウィンドウの一番左上隅にあるアイコンをクリック
(2) 「プロパティ(P)」を選択
(3) 「フォント」タブを選択
(4) 「フォント(F)」の欄が「MSゴシック」になっているかを確認する（サイズの部分は任意の数値で大丈夫です）
返信に大分時間を開けてしまい申し訳ありませんでした。コマンドプロンプトのフォントはMSゴシックになっています。
同ウィンドウで「オプション」タブを開いて頂くと「現在のコードページ」という項目が最下部にありますが、そちらはどのような表記になっていますでしょうか？
932 (ANSI/OEM - 日本語 Shift-JIS)です。
コマンドプロンプトがShift-JIS設定なのに対して、TomcatがUTF-8という文字コードの日本語を出力しているようですね。
以下の手順をお試し下さい。
(1) tomcatをインストールした場所の「conf」というフォルダ内にある「logging.properties」というファイルをテキストエディタで開く
(2) 51行目、「java.util.logging.ConsoleHandler.encoding = UTF-8」と書かれた行があるので「UTF-8」を「SJIS」に書き換えて上書き保存する
うまく表示されました。ありがとうございます。
追加部分の
userusername="admin"password="pass" roles="manager-gui"
を
user username="admin" password="pass" roles="manager-gui"
に変更お願いいたします。
いつもご愛読いただきありがとうございます。
該当部分の修正を行いました。
今後とも、ご愛読のほどよろしくお願いいたします。
通りすがりですが文字化けのところ大変参考になりました。
誠にありがとうございました。
お役に立てたようで何よりでございます。
引き続き、ご愛読のほど、よろしくお願いいたします。
久しぶりにインストールする折に参考にさせていただきました。
とても助かりました。ありがとうございます。
一点だけ失礼します。
Webアプリケーションマネージャの認証についてですが、インデントの問題でしょうか。
ご記載の通りの
ですとユーザー名・パスワードが承認されず、
にしますと、無事承認されました。
お役に立てたようで何よりでございます。
引き続き、ご愛読のほど、よろしくお願いいたします。