超詳細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 "%r" %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 "%r" %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)來實現會話持久的效果。