server.xmlの概要

server.xmlとは、Tomcatサーバの動作を定義する設定ファイルです。他にも設定ファイルはありますが、Tomcatに関する主要な設定はこのファイルで行います。server.xmlは$CATALINA_HOME\confディレクトリ配下にあります。

server.xmlの設定例

server.xmlの設定例について解説します。基本ルールとして、ネストされたタグの設定内容は親タグの設定内容を上書きします。

設定例の解説にはTomcatにあらかじめ用意されているserver.xmlの最小設定例を記載したファイルserver-minimal.xmlを修正したものです。実際の設定時にはserver-minimal.xmlに必要な設定を追加し、server.xmlにリネイムして使用することをお勧めします。server-minamal.xmlは$CATALINA_HOME\confディレクトリ配下にあります。

<!-- (1)Serverタグの設定 -->
<Server port="8005" shutdown="SHUTDOWN">
    <!-- (2)Serviceタグの設定 -->
    <Service name="Catalina">
        <!-- (3)Connectorタグの設定 -->
        <Connector port="8080" />
        <!-- (4)Engineタグの設定 -->
        <Engine name="Catalina" defaulthost="localhost">
            <!-- (5)Loggerタグの設定 -->
            <Logger classname="org.apache.catalina.logger.FileLogger" />
            <!-- (6)Hostタグの設定 -->
            <Host name="localhost" appbase="webapps">
                <!-- (7)ネストされたLoggerタグの設定 -->
                <Logger classname="org.apache.catalina.logger.FileLogger" />
            </Host>
        </Engine>
    </Service>
</Server>

1. (1)<Server>タグの設定です。<Server>タグはserver.xmlファイルでただ一つ存在する最上位のタグです。ポート番号8005を監視し、Tomcatを停止するためのSHUTDOWNコマンドを受け付ける設定を表しています。
2. (2)<Connector>タグと<Engine>タグをグループ化する<Service>タグの設定です。サービス名がCatalinaであることを表しています。
3. (3)ポート番号8080でクライアントからのリクエストを受け付けることを表しています。
4. (4)Tomcatエンジンの設定です。エンジン名がCatalina、リクエストホスト先がserver.xmlにない場合の接続先がlocalhostであることを表しています。
5. (5)エラーメッセージを出力する<Logger>タグの設定です。classname属性に指定されているFileLoggerクラスはファイルにエラーログを生成することを表しています(Tomcat5.5からは、<Logger>タグではなく、logging.propertiesファイルで行うようになりました)。
6. (6)クライアントからリクエストを受け付けるホスト名がlocalhostであることを表しています。
7. (7)<Host>タグ内の<Logger>タグの設定です。ホスト名localhostに限定したエラーログが対象になります。classname属性に指定されているSystemOutLoggerクラスは標準出力にエラーログを生成することを表します。localhostに対する処理を除くTomcatエンジンのエラーログは⑤の<Logger>タグで処理されます。

server.xmlの設定タグ

server.xmlで設定できるタグを以下に記載します。各タグで設定できる属性については解説を省略します。詳細解説を参照してください。