Tomcat相关配置

Tomcat相关配置

Administrator 862 2018-06-27

本文通过部署zrlog博客系统，来介绍如何Tomcat的虚拟主机配置和日志相关的配置。

配置Tomcat监听80端口

  • Tomcat默认监听的时8080端口，使得访问起来不够方便，而修改Tomcat的监听端口需要更改配置文件/usr/local/tomcat/conf/server.xml，然后搜索8080，将其改成80并重启服务，配置文件更改如下：

    <Connector port="80" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" />
    <!-- A "Connector" using the shared thread pool-->

    重启服务后查看是否监听到80端口：

    $ netstat -tlnp | grep java
tcp6       0      0 :::80                   :::*                    LISTEN      2054/java           
tcp6       0      0 127.0.0.1:8005          :::*                    LISTEN      2054/java           
tcp6       0      0 :::8009                 :::*                    LISTEN      2054/java

Tomcat虚拟主机

增加虚拟主机配置

  • Tomcat同样支持虚拟主机，编辑配置文件server.xml，查找host配置项：

    <Host name="localhost"  appBase="webapps"
            unpackWARs="true" autoDeploy="true">
  <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
         prefix="localhost_access_log" suffix=".txt"
         pattern="%h %l %u %t &quot;%r&quot; %s %b" />
</Host>

  • 与nginx和Apache不同，Tomcat的虚拟主机不是提供root网站根目录，而是提供WAR格式的包，包里包含站点的文件、目录、JSP文件等等，并且需要将包放在上面host配置中appBase指定的目录中，而unpackWARs配置为true，则Tomcat会自动解压WAR包；

  • 除了提供WAR包，也可以单独指定一个目录，目录内放站点的根目录；

  • 上面的valve配置项则是日志格式的配置项；

  • 增加一个虚拟主机需要在配置中增加一项host配置项，如下增加虚拟主机配置：

    <Host name="www.123.cn" appBase=""
      unpackWARS="true" autoDeploy="true"
      xmlValidation="false" xmlNamespaceAware="false">
      <Context path="" docBase="/data/wwwroot/123.cn/" debug="0"
reloadable="true" crossContext="true"/>
</Host>
    • 这里没有指定appBase，而是在Context配置项中指定了docBase，这就是定义的目录，用来存放网站根目录，也可以将WAR手动解压后放入docBase目录；
    • 如果不定义docBase，那么默认是在appBase/ROOT目录下，定义了docBase后，就以docBase为主，并且appBase和docBase可以一样；

部署站点

  • 部属站点我们使用zrlog博客系统，是由java构建的，首先下载zrlog；

  • 将zrlog的WAR包拷贝到/usr/local/tomcat/webapps/目录下，然后等待一会查看webapps目录，会看到zrlog的WAR包被自动解压出来，这是unpackWARS="true"配置的作用：

    $ cp zrlog.war /usr/local/tomcat/webapps/

$ ls /usr/local/tomcat/webapps/
docs  examples  host-manager  manager  ROOT  zrlog  zrlog.war

  • 自动解压完成后，不要删除原始的WAR包，否则自动解压出来的目录也会被删除，而将解压的目录更名，则tomcat会再次解压出与WAR同名的目录；

  • 然后使用浏览器访问zrlog的安装向导：

    zrlog

  • 安装向导首先要求配置数据库，我们登录MySQL，为zrlog创建一个名为zrlog的数据库，并且创建同名的用户，指定权限只能访问zrlog库：

    mysql> create database zrlog;
Query OK, 1 row affected (0.01 sec)

mysql> grant all on zrlog.* to 'zrlog'@127.0.0.1 identified by '123456';
Query OK, 0 rows affected, 1 warning (0.02 sec)

  • 在安装向导中填入数据库信息之后点击下一步，设置网站信息后安装完成：

    zrlog-site

zrlog虚拟主机配置完善

  • 上一步安装zrlog中，我们访问安装向导时，访问的URL是192.168.199.128/zrlog，而不是像Apache和nginx一般直接访问虚拟主机的Server_name；

  • 这是因为我们的zrlog的网站目录放在了webapps目录下，而我们配置文件中zrlog的虚拟主机配置，对应的网站根目录为docBase目录，所以我们将zrlog的根目录下的所有文件移动到docBase指定的目录下，即/data/wwwroot/123.cn/目录：

    $ mkdir -p /data/wwwroot/123.cn  

$ mv /usr/local/tomcat/webapps/zrlog/* /data/wwwroot/123.cn/

  • 由于站点是在虚拟机中，而域名配置的是www.123.cn，所以需要配置hosts，将域名指向虚拟机；

  • 重启Tomcat服务，然后直接在浏览器中访问www.123.cn域名，查看是否能够访问到zrlog：

    zrlog-domian

  • 在Tomcat的server.xml中，appBase的目录webapps是以相对路径配置的，相对路径是相对Tomcat安装目录的位置；而webapps下的ROOT目录就是Tomcat安装后的默认访问页面，ROOT下的文件可以用localhost/index.jsp的形式进行访问；

  • 如果在配置文件中自定义了appBase的路径，那么也需要在自定义的路径下创建ROOT目录，并且将图片、静态文件等放到ROOT下才能正常访问；

Tomcat日志

  • Tomcat的日志默认在/usr/local/tomcat/logs目录下：

    $ ls /usr/local/tomcat/logs/
catalina.2018-06-26.log      localhost.2018-06-27.log
catalina.2018-06-27.log      localhost.2018-06-28.log
catalina.2018-06-28.log      localhost_access_log.2018-06-26.txt
catalina.out                 localhost_access_log.2018-06-27.txt
host-manager.2018-06-26.log  localhost_access_log.2018-06-28.txt
host-manager.2018-06-27.log  manager.2018-06-26.log
host-manager.2018-06-28.log  manager.2018-06-27.log
localhost.2018-06-26.log     manager.2018-06-28.log

  • 其中catalina开头的是综合日志，记录了Tomcat服务相关的信息和错误信息:

    $ tail catalina.out 
28-Jun-2018 00:18:30.261 信息 [www.123.cn-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/usr/local/tomcat/webapps] has finished in [126] ms
28-Jun-2018 00:18:30.261 信息 [www.123.cn-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deploying web application directory [/usr/local/tomcat/work]
28-Jun-2018 00:18:30.317 信息 [www.123.cn-startStop-1] org.apache.catalina.startup.HostConfig.deployDirectory Deployment of web application directory [/usr/local/tomcat/work] has finished in [56] ms
28-Jun-2018 00:18:30.427 信息 [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler ["http-nio-80"]
28-Jun-2018 00:18:30.757 信息 [main] org.apache.coyote.AbstractProtocol.start Starting ProtocolHandler ["ajp-nio-8009"]
28-Jun-2018 00:18:30.762 信息 [main] org.apache.catalina.startup.Catalina.start Server startup in 16836 ms
六月 28, 2018 12:18:30 上午 com.zrlog.plugincore.server.impl.NioServer create
信息: plugin listening on port -> 45941
六月 28, 2018 12:18:30 上午 com.zrlog.plugincore.server.impl.NioServer create
信息: load jar files
    • 主要需要关注错误、严重级别的日志，而catalina.2018-xx-xx-xx.log与catalina.out内容相同，只是前者会每天生成一个新日志；

  • host-manager.xxxx-xx-xx.log和manager日志是管理相关日志，host-manager是虚拟主机管理日志，一般较少使用；

  • localhost和localhost_access是虚拟主机相关日志，有access命名的是访问日志，反之则是虚拟主机错误日志：

    $ tail -n3 localhost.2018-06-28.log 
28-Jun-2018 00:18:23.303 信息 [localhost-startStop-1] org.apache.catalina.core.ApplicationContext.log ContextListener: contextInitialized()
28-Jun-2018 00:18:23.303 信息 [localhost-startStop-1] org.apache.catalina.core.ApplicationContext.log SessionListener: contextInitialized()
28-Jun-2018 00:18:23.305 信息 [localhost-startStop-1] org.apache.catalina.core.ApplicationContext.log ContextListener: attributeAdded('StockTicker', 'async.Stockticker@60be3b74')

$ tail -n3 localhost_access_log.2018-06-28.txt 
192.168.199.199 - - [28/Jun/2018:00:19:27 +0800] "GET /asf-logo-wide.svg HTTP/1.1" 304 -
192.168.199.199 - - [28/Jun/2018:00:19:27 +0800] "GET /bg-upper.png HTTP/1.1" 304 -
192.168.199.199 - - [28/Jun/2018:00:19:50 +0800] "GET / HTTP/1.1" 200 11250

  • 访问日志默认不会生成，需要在server.xml中配置，例如配置zrlog虚拟主机的访问日志，在<Host></Host>中添加如下配置：

    <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"
   prefix="123.cn_access" suffix=".log"
   pattern="%h %l %u %t &quot;%r&quot; %s %b" />
    • prefix定义日志文件名的前缀，suffix定义日志文件后缀名，pattern定义日志格式，directory定义日志存储目录。
    • 新增加的虚拟主机默认不会生成类似默认虚拟主机的localhost.data.log日志，错误日志会统一记录到catalina.out中，所以Tomcat出现问题时，应该第一时间查看catalina.out日志。
Tomcat zrlog