1. 程式人生 > >超詳細Tomcat配置檔案解讀

超詳細Tomcat配置檔案解讀

1、瞭解tomcat Tomcat不是一個完整意義上的Jave EE(j2ee)伺服器,因為它沒有提供完整的Java EE企業應用平臺的API。但是由於Tomcat遵循apache開源協議,並且對當前Java開發框架開源元件Structs、Spring和Hibernate等實現完美支援,因此tomcat被眾多企業用來部署配置眾多的Java應用程式,實現替代一些商業的Java應用伺服器。2、Tomcat的目錄結構 要部署使用tomcat,則必須瞭解tomcat的目錄結構以及各目錄的作用。這裡以tomcat7為例 安裝Tomcat,再次不在闡述,[詳情請移步]

進入tomcat安裝目錄下:

|-- bin |   |-- bootstrap.jar tomcat啟動時所依賴的一個類,在啟動tomcat時會發現Using CLASSPATH: 是載入的這個類 |   |-- catalina-tasks.xml 定義tomcat載入的庫檔案,類檔案 |   |-- catalina.bat |   |-- catalina.sh                  tomcat單個例項在Linux平臺上的啟動指令碼 |   |-- commons-daemon-native.tar.gz            jsvc工具,可以使tomcat已守護程序方式執行,需單獨編譯安裝 |   |-- commons-daemon.jar            jsvc工具所依賴的java類 |   |-- configtest.bat |   |-- configtest.sh         tomcat檢查配置檔案語法是否正確的Linux平臺指令碼 |   |-- cpappend.bat |   |-- daemon.sh tomcat已守護程序方式執行時的,啟動,停止指令碼 |   |-- digest.bat |   |-- digest.sh |   |-- setclasspath.bat |   |-- setclasspath.sh |   |-- shutdown.bat |   |-- shutdown.sh tomcat服務在Linux平臺下關閉指令碼 |   |-- startup.bat |   |-- startup.sh          tomcat服務在Linux平臺下啟動指令碼 |   |-- tomcat-juli.jar |   |-- tomcat-native.tar.gz  使tomcat可以使用apache的apr執行庫,以增強tomcat的效能需單獨編譯安裝 |   |-- tool-wrapper.bat |   |-- tool-wrapper.sh |   |-- version.bat |   `-- version.sh 檢視tomcat以及JVM的版本資訊 |-- conf 顧名思義,配置檔案目錄 |   |-- catalina.policy 配置tomcat對檔案系統中目錄或檔案的讀、寫執行等許可權,及對一些記憶體,session等的管理許可權 |   |-- catalina.properties 配置tomcat的classpath等 |   |-- context.xml tomcat的預設context容器 |   |-- logging.properties 配置tomcat的日誌輸出方式 |   |-- server.xml        tomcat的主配置檔案 |   |-- tomcat-users.xml        tomcat的角色(授權使用者)配置檔案 |   `-- web.xml tomcat的應用程式的部署描述符檔案 |-- lib |-- logs 日誌檔案預設存放目錄 |-- temp |   `-- safeToDelete.tmp |-- webapps           tomcat預設存放應用程式的目錄,好比apache的預設網頁存放路徑是/var/www/html一樣 |   |-- docs tomcat文件 |   |-- examples                     tomcat自帶的一個獨立的web應用程式例子 |   |-- host-manager              tomcat的主機管理應用程式 | |   |-- META-INF           整個應用程式的入口,用來描述jar檔案的資訊 | |   |   `-- context.xml     當前應用程式的context容器配置,它會覆蓋tomcat/conf/context.xml中的配置 | |   |-- WEB-INF  用於存放當前應用程式的私有資源 | |   |   |-- classes  用於存放當前應用程式所需要的class檔案 |       |   | |-- lib          用於存放當前應用程式鎖需要的jar檔案 | |   |   `-- web.xml 當前應用程式的部署描述符檔案,定義應用程式所要載入的serverlet類,以及該程式是如何部署的 |   |-- manager                  tomcat的管理應用程式 |   |-- ROOT              指tomcat的應用程式的根,如果應用程式部署在ROOT中,則可直接通過http://ip:port 訪問到 `-- work 用於存放JSP應用程式在部署時編譯後產生的class檔案

3、瞭解tomcat的主配置檔案(server.xml)結構及含義 如下圖所示,前端請求被tomcat直接接收或者由前端的代理,通過HTTP,或者AJP代理給Tomcat,此時請求被tomcat中的connector接收,不同的connector和Engine被service元件關聯起來,在一個Engine中定義了許多的虛擬主機,由Host容器定義,每一個Host容器代表一個主機,在各自的Host中,又可以定義多個Context,用此來定義一個虛擬主機中的多個獨立的應用程式。

4、單例項應用程式配置一例

規劃: 
網站網頁目錄:/web/www      域名:www.test1.com 
論壇網頁目錄:/web/bbs     URL:bbs.test1.com/bbs 
網站管理程式:$CATALINA_HOME/wabapps   URL:manager.test.com    允許訪問地址:172.23.136.* 

conf/server.xml 
<Server port="8005" shutdown="SHUTDOWN"> 
  <Listener className="org.apache.catalina.core.AprLifecycleListener" SSLEngine="on" /> 
  <Listener className="org.apache.catalina.core.JasperListener" /> 
  <Listener className="org.apache.catalina.core.JreMemoryLeakPreventionListener" /> 
  <Listener className="org.apache.catalina.mbeans.GlobalResourcesLifecycleListener" /> 
  <Listener className="org.apache.catalina.core.ThreadLocalLeakPreventionListener" /> 
  <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> 
  <!-- 定義的一個名叫“UserDatabase”的認證資源,將conf/tomcat-users.xml載入至記憶體中,在需要認證的時候到記憶體中進行認證 --> 
  <Service name="Catalina"> 
  <!-- # 定義Service元件,同來關聯Connector和Engine,一個Engine可以對應多個Connector,每個Service中只能一個Engine --!> 
    <Connector port="80" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" /> 
    <!-- 修改HTTP/1.1的Connector監聽埠為80.客戶端通過瀏覽器訪問的請求,只能通過HTTP傳遞給tomcat。  --> 
    <Connector port="8009" protocol="AJP/1.3" redirectPort="8443" /> 
    <Engine name="Catalina" defaultHost="test.com"> 
    <!-- 修改當前Engine,預設主機是,www.test.com  --> 
    <Realm className="org.apache.catalina.realm.LockOutRealm"> 
        <Realm className="org.apache.catalina.realm.UserDatabaseRealm" 
               resourceName="UserDatabase"/> 
    </Realm> 
    # Realm元件,定義對當前容器內的應用程式訪問的認證,通過外部資源UserDatabase進行認證 
      <Host name="test.com"  appBase="/web" unpackWARs="true" autoDeploy="true"> 
      <!--  定義一個主機,域名為:test.com,應用程式的目錄是/web,設定自動部署,自動解壓    --> 
        <Alias>www.test.com</Alias> 
        <!--    定義一個別名www.test.com,類似apache的ServerAlias --> 
        <Context path="" docBase="www/" reloadable="true" /> 
        <!--    定義該應用程式,訪問路徑"",即訪問www.test.com即可訪問,網頁目錄為:相對於appBase下的www/,即/web/www,並且當該應用程式下web.xml或者類等有相關變化時,自動過載當前配置,即不用重啟tomcat使部署的新應用程式生效  --> 
        <Context path="/bbs" docBase="/web/bbs" reloadable="true" /> 
        <!--  定義另外一個獨立的應用程式,訪問路徑為:www.test.com/bbs,該應用程式網頁目錄為/web/bbs   --> 
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="/web/www/logs" 
               prefix="www_access." suffix=".log" 
               pattern="%h %l %u %t &quot;%r&quot; %s %b" /> 
        <!--   定義一個Valve元件,用來記錄tomcat的訪問日誌,日誌存放目錄為:/web/www/logs如果定義為相對路徑則是相當於$CATALINA_HOME,並非相對於appBase,這個要注意。定義日誌檔案字首為www_access.並以.log結尾,pattern定義日誌內容格式,具體欄位表示可以檢視tomcat官方文件   --> 
      </Host> 
      <Host name="manager.test.com" appBase="webapps" unpackWARs="true" autoDeploy="true"> 
      <!--   定義一個主機名為man.test.com,應用程式目錄是$CATALINA_HOME/webapps,自動解壓,自動部署   --> 
        <Valve className="org.apache.catalina.valves.RemoteAddrValve" allow="172.23.136.*" /> 
        <!--   定義遠端地址訪問策略,僅允許172.23.136.*網段訪問該主機,其他的將被拒絕訪問  --> 
        <Valve className="org.apache.catalina.valves.AccessLogValve" directory="/web/bbs/logs" 
               prefix="bbs_access." suffix=".log" 
               pattern="%h %l %u %t &quot;%r&quot; %s %b" /> 
        <!--   定義該主機的訪問日誌      --> 
      </Host> 
    </Engine> 
  </Service> 
</Server> 

conf/tomcat-users.xml 
<?xml version='1.0' encoding='utf-8'?> 
<tomcat-users> 
  <role rolename="manager-gui" /> 
  <!--  定義一種角色名為:manager-gui    --> 
  <user username="cz" password="manager$!!110" roles="manager-gui" /> 
  <!--  定義一個使用者的使用者名稱以及密碼,並賦予manager-gui的角色    --> 
</tomcat-users> 

由以上配置不難看出存在的一個問題。如果我們想要對其中一個應用程式的配置做一些修改,那麼就必須重新啟動tomcat,那樣勢必就會影響到另外兩個應用程式的正常服務。因此以上配置是不適合線上使用的,因此需要將其配置為多例項,每個例項只跑一個獨立的應用程式,那樣我們應用程式之間就不會在互相受到影響。但是我們將面臨這樣一個問題,80埠只能被一個HTTP/1.1 Connector監聽,而三個tomcat例項則至少需要3個HTTP/1.1 Connector,這樣我們就需要一個前端代理做分發處理,接收HTTP 80埠的請求,按域名通過每個tomcat例項的AJP/1.3 Connector傳遞請求。而前端的代理選擇apache,基於這樣的思路,我們還可以做到tomcat的負載均衡,而且apache會將接收的HTTP超文字傳輸報文重新封裝成二進位制格式通過AJP/1.3 協議傳遞給後端的tomcat處理,在效率上也是有明顯的提升。

5、結合apache構造多例項tomcat叢集 apache結合tomcat的方式主要有三種:mod_jk,ajp_proxy,http_proxy(以http協議代理給tomcat),而當前使用最多的還是要數mod_jk。因為mod_jk出現的較早,技術已經相當成熟,而且具備叢集節點健康檢測功能,支援大型的AJP資料包。

安裝apache,tomcat這裡不在詳述,需要了解,[請狂戳這裡] 安裝tomcat-connectors tar zxvf tomcat-connectors-1.2.30-src.tar.gz cd tomcat-connectors/src ./configure --with-apxs=/usr/local/apache/bin/apxs make && make install

①單獨建立httpd-jk.conf

單獨建立httpd-jk.conf檔案用來配置mod_jk的相關設定 vim /usr/local/apache2/conf/extra/httpd-jk.conf

LoadModule jk_module modules/mod_jk.so # 配置apache裝載mod_jk.so模組 JkWorkersFile /usr/local/apache/conf/extra/workers.properties # 指定儲存了worker相關工作屬性定義的配置檔案 JkLogFile /usr/local/apache/logs/mod_jk.log # 定義mod_jk模組的日誌檔案 JkLogLevel info # 定義mod_jk模組日誌的記錄級別

②建立worker相關工作屬性定義的配置檔案 vim /usr/local/apache/conf/extra/workers.properties worker.list=Cluster1,stat worker.web2.port=8003 worker.web2.host=172.23.138.19 worker.web2.type=ajp13 worker.web2.lbfactor=1

worker.web3.port=8003 worker.web3.host=172.23.136.144 worker.web3.type=ajp13 worker.web3.lbfactor=1 worker.Cluster1.type=lb worker.Cluster1.balance_workers=web2,web3 worker.Cluster1.sticky_session = 1

worker.stat.type=status worker.list=Cluster2 worker.manager2.port=7003 worker.manager2.host=172.23.138.19 worker.manager2.type=ajp13 worker.manager2.lbfactor=1

worker.manager3.port=7003 worker.manager3.host=172.23.136.144 worker.manager3.type=ajp13 worker.manager3.lbfactor=1 worker.Cluster2.type=lb worker.Cluster2.balance_workers=manager2,manager3 worker.Cluster2.sticky_session = 1

③配置後端tomcat多例項 使用指令碼快速部署tomcat例項,修改新例項的AJP/1.3 Connector的監聽埠,HTTP/1.1 Connector的監聽埠以及Server容器的監聽埠。指令碼內容如下:

#!/bin/bash 

# when:2013-01-21 

# who: [email protected] 

Java_Home=/usr/java/jdk1.7.0_10 

Tomcat_Home=/usr/local/tomcat_7 

Tomcat_User=tomcat 

New_instance=/usr/local/new 

if [ ! -d $New_instance ];then 

        mkdir -p $New_instance 

else 

        echo "The parh alreadly exists..." 

        exit 

fi 

id $Tomcat_User 2&> /dev/null & useradd -r $Tomcat_User 

cp -r $Tomcat_Home/conf $New_instance 

mkdir -p $New_instance/{logs,temp,webapps/ROOT,work} 

cat > $New_instance/tomcat.sh << EOF 

#!/bin/sh 

JAVA_HOME=`echo $Java_Home` 

JAVA_OPTS="-Xms64m -Xmx128m" 

CATALINA_HOME=`echo $Tomcat_Home` 

CATALINA_BASE=`echo $New_instance` 

export JAVA_HOME JAVA_OPTS CATALINA_HOME CATALINA_BASE 

su `echo $Tomcat_User` \$CATALINA_HOME/bin/catalina.sh \$1 

EOF 

cat > $New_instance/webapps/ROOT/index.jsp << EOF 

<html><body><center> 

<h1>This is a new tomcat instance!</h1> 

</br> 

Now time is: <%=new java.util.Date()%> 

</center> 

</body></html> 

EOF 

chown $Tomcat_User:$Tomcat_User -R $New_instance 

現在後端每臺tomcat節點的配置狀況如下:

www.test.com例項:

<Server port="8000">

<Connector port="8001" protocol="HTTP/1.1">

<Connector port="8003" protocol="AJP/1.3">

</Server>

manager.test.com例項:

<Server port="7000">

<Connector port="7001" protocol="HTTP/1.1">

<Connector port="7003" protocol="AJP/1.3">

</Server>

使用新例項中的tomcat.sh進行啟動每個例項

④配置多域名的負載均衡 vim /usr/local/apache/conf/extra/httpd-vhosts.conf  

NameVirtualHost *:80 <VirtualHost *:80>     ServerName www.test.com     JkMount /* Cluster1 </VirtualHost> <VirtualHost *:80>     ServerName manager.test.com     JkMount /* Cluster2     JkMount /status stat </VirtualHost>

到此基於多域名多例項的tomcat負載均衡叢集構建完成,啟動apache即可,基於當前結構還可結合持久會話管理器(PersistentManager)來實現會話持久的效果。