003-tomcat配置文件-server、tomcat-users

1、server.xml讲解

位于conf下

<?xml version="1.0" encoding="UTF-8"?>

  <!-- Server代表一个 Tomcat 实例。可以包含一个或多个 Services，其中每个Service都有自己的Engines和Connectors。

       port="8005"指定一个端口，这个端口负责监听关闭tomcat的请求

  -->

  <Server port="8005" shutdown="SHUTDOWN">

    <!-- 监听器 -->

    <Listener className="org.apache.catalina.startup.VersionLoggerListener" />

    <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" />

   <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" />

   <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" />

   <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" />

   <!-- 全局命名资源，定义了UserDatabase的一个JNDI(java命名和目录接口)，通过pathname的文件得到一个用户授权的内存数据库 -->

   <GlobalNamingResources>

     <Resource name="UserDatabase" auth="Container"

               type="org.apache.catalina.UserDatabase"

               description="User database that can be updated and saved"

               factory="org.apache.catalina.users.MemoryUserDatabaseFactory"

               pathname="conf/tomcat-users.xml" />

   </GlobalNamingResources>

   <!-- Service它包含一个<Engine>元素,以及一个或多个<Connector>,这些Connector元素共享用同一个Engine元素 -->

   <Service name="Catalina">

     <!--

         每个Service可以有一个或多个连接器<Connector>元素，

         第一个Connector元素定义了一个HTTP Connector,它通过8080端口接收HTTP请求;第二个Connector元素定

         义了一个JD Connector,它通过8009端口接收由其它服务器转发过来的请求.

     -->

     <Connector port="8080" protocol="HTTP/1.1"

                connectionTimeout="20000"

                redirectPort="8443" />

     <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" />

     <!-- 每个Service只能有一个<Engine>元素 -->

     <Engine name="Catalina" defaultHost="localhost">

       <Realm className="org.apache.catalina.realm.LockOutRealm">

         <Realm className="org.apache.catalina.realm.UserDatabaseRealm"

                resourceName="UserDatabase"/>

       </Realm>

       <!-- 默认host配置，有几个域名就配置几个Host，但是这种只能是同一个端口号 -->

       <Host name="localhost"  appBase="webapps"

             unpackWARs="true" autoDeploy="true">

     　　<!-- Tomcat的访问日志，默认可以关闭掉它，它会在logs文件里生成localhost_access_log的访问日志 -->

         <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>

       <Host name="www.lhx.com"  appBase="webapps"

             unpackWARs="true" autoDeploy="true">

         <Context path="" docBase="/myweb1" />

         <Valve className="org.apache.catalina.valves.AccessLogValve" directory="logs"

                prefix="hzg_access_log" suffix=".txt"

                pattern="%h %l %u %t &quot;%r&quot; %s %b" />

       </Host>

     </Engine>

   </Service>

 </Server>

访问http://localhost:8080/aaa和http://www.lhx.com/8080/aaa效果一致。

1.1、Host节点下的appBase与Context下的docBase

appBase目录表示

　　这个目录下面的子目录将自动被部署为应用。
　　这个目录下面的.war文件将被自动解压缩并部署为应用

docBase只是指向了你某个应用的目录，这个可以和appBase没有任何关系。

总结：
　　如果你想自己指定路径，那么应该在docBase里面
　　如果你想简单，那么直接把他们复制到appBase下面就行了

如果重复设置，也就是2个指向了一个目录，也能运行，但你的应用下面的每个子目录，其实是被部署为单独的应用的。
如你的应用为myApp, 放在了 d:\project\myApp 里面有2个子目录 d:\project\myApp\images 、d:\project\myApp\js

你可以通过
1 设置 appBase 指向 d:\project 来让系统自动部署
2 你可以手工指定docBase到 d:\project\myApp
3 如果你指定了 appBase到 d:\project\myApp 那么 d:\project\myApp\images这个将不再是普通的子目录，而是一个单独的虚拟目录，或者叫应用了。因为其被自动部署
d:\project\myApp\js 也一样的后果

<!--appBase 下面加了一行docBase，把路径配置到docBase中，把appBase为空，就OK了-->

  <Host name="localhost"  appBase="webapps"

       unpackWARs="true" autoDeploy="true"

       xmlValidation="false" xmlNamespaceAware="false">

   <Context path="test1" docBase="D:\\JavaWebTest" debug="0" reloadable="true" crossContext="true"/>

访问：http//localhost:8080/test1/即可

1.2、不同于Catalina/localhost/xxx.xml

<?xml version="1.0" encoding="UTF-8"?>

<Context docBase = "D:\\JavaWebTest\xxx" path="xxx"></Context>

在tomcat的conf/Catalina/localhost目录下创建一个xxx.xml文件

启动tomcat,然后访问：http//localhost:8080/xxx 即可

path：指访问路径

docBase：指项目路径

当然也可指向

<?xml version="1.0" encoding="UTF-8"?>

<Context docBase = "D:\\JavaWebTest\" ></Context>

直接访问：http//localhost:8080 即可

尽管也允许直接在server.xml文件中配置<Context>元素，但不提倡采用这种方式。

问题一、Tomcat 错误“inside the host appBase has been specified, and will be ignored”

错误信息：

警告: A docBase D:/Tomcat/webapps/myApp inside the host appBase has been specified, and will be ignored

错误原因：
　　假设要部署工程 "myApp"，放到了 ${catalina.home}/webapps 下。（这相当于隐性的定义了一个 docBase ，指向" ${catalina.home}/webapps/myApp " ）。

　　同时在 /conf/Catalina/localhost 下建立了配置文件 myApp.xml ，在其中定义了 docBase ，目标指向 " ${catalina.home}/webapps/myApp " 。

　　这样，在 Tomcat 启动的时候，先找到了 myApp.xml 配置文件中定义的 docBase，然后 Tomcat 自动检测 ${catalina.home}/webapps 下是否存放了合法的工程，并自动加载（根据配置文件的设置）。这样，Tomcat 又找到了一个相同的 docBase，所以输出了错误信息。

解决办法：
　　将 myApp 工程从 ${catalina.home}/webapps 目录移出，然后修改配置文件 myApp.xml 指向该目录。

2、tomcat-users.xml：配置Tomcat的server的manager信息

<?xml version="1.0" encoding="UTF-8"?>

<tomcat-users xmlns="http://tomcat.apache.org/xml"

              xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

              xsi:schemaLocation="http://tomcat.apache.org/xml tomcat-users.xsd"

              version="1.0">

<role rolename="manager-gui"/>

<user username="manager" password="manager" roles="manager-gui"/>

</tomcat-users>