tomcat配置手冊范本

1、1. tomcat的部署方式 以下部署方式都是針對 tomcat5.0以上版本。1.1 Context descriptorsTomcat4中的Manager和Admin管理工具其實(shí)就是利用它來部署的。在 Tomcat5中提出了 Context descriptor 這個(gè)概念，且為其配置了一個(gè)專有目錄，而不像 Tomcat4那樣大雜炫 一般地放置在$appBase目錄下。Context descriptor是一個(gè)只包含 Context元素的xml格式的部署文件，其中 Context元素與server.xml中的Context元素配置相同。對于一個(gè)給 定的主機(jī)，Context descripto

2、r放置在 $CATALINA_HOME/conf/enginename/hostname/目錄下面。Tomcat5 默認(rèn)安裝時(shí)，在 $CATALINA_HOME/conf/Catalina/localhost 目錄中有 admin.xml和manager.xml ,是兩個(gè)管理工具的部署描述符文件。而這兩個(gè)文件在 Tomcat4 中是放置在$CATALINA_HOME/webapps錄下面的。 使用方法：(1) 在$CATALINA_HOME/conf/enginename/hostname/目錄下新建 xxx.xml 文檔(2) 在xxx.xml文檔中配置如下Context docBase=&

3、quot;$catalina.home/server/webapps/host-manager" privileged="true" antiResourceLocking="false" antiJARLocking="false"> /Context注：docBase 也可以設(shè)置為eclipse 的 workplace/project/webroot1.2 靜態(tài)部署靜態(tài)部署是指在Tomcat運(yùn)行之前就把相關(guān)的Web應(yīng)用程序放置到合適的目錄，在 Tomcat啟動(dòng)的時(shí)候自動(dòng)來部署這些應(yīng)用程序。如果"deplo

4、yOnStartup" 屬性值為true ,那么在 Tomcat啟動(dòng)時(shí),在$appBase目錄下的 web 應(yīng)用程序?qū)⒈蛔詣?dòng)部署。部署的過程如下：(1) Context元素聲明的Web應(yīng)用程序?qū)⒈皇紫炔渴?，這包括 server.xml和context descriptor 文件中的Context元素所指的應(yīng)用程序；(2)部署擴(kuò)展目錄形式的 Web應(yīng)用程序；(3) 部署WA期式的 Web應(yīng)用程序；Tomcat5對于靜態(tài)方式的部署的增強(qiáng)主要就是：1、對于context descriptor方式的應(yīng)用程序的部署。2、如果擴(kuò)展目錄方式的應(yīng)用程序?qū)?yīng)有一個(gè)WARC件，且 WAR!更新過的，擴(kuò)展

5、目錄將被自動(dòng)刪除，Web應(yīng)用程序?qū)⒈粡腤A或件中重新部署。而在 Tomcat4中，即使WA或件已更 新也無法被重新部署，仍然會(huì)使用舊的擴(kuò)展目錄方式的Web應(yīng)用程序，除非你自己手動(dòng)刪除目錄，而且還要重啟Tomcat。1.3 動(dòng)態(tài)部署動(dòng)態(tài)部署是指在Tomcat已經(jīng)運(yùn)行以后在不重啟服務(wù)器的情況下部署應(yīng)用程序的方式。如果虛擬主機(jī)的"autoDeploy"屬性值為true ,則主機(jī)會(huì)在需要的時(shí)候試圖去部署和更新應(yīng) 用程序。這是由虛擬主機(jī)在后臺(tái)運(yùn)行的一個(gè)負(fù)責(zé)自動(dòng)加載的處理線程來完成的，它的工作流 程如下：1、部署新放入$appBase目錄的War方式的應(yīng)用程序。2、部署新放入$appB

6、ase目錄的擴(kuò)展目錄方式的應(yīng)用程序。3、如果一個(gè)擴(kuò)展目錄方式的應(yīng)用程序?qū)?yīng)的War文件更新了，則刪除此目錄，從 War文件中重新解開并部署。如果" unpackWARg屬性值為false ,則不解開，從 War文件中直接運(yùn) 行。（記?。翰挥米约簞h除擴(kuò)展目錄，也不用重啟服務(wù)器）4、如果應(yīng)用程序的/WEB-INF/web.xml文件被改變，則重新部署這個(gè)應(yīng)用。5、如果應(yīng)用程序?qū)?yīng)的Context元素配置發(fā)生了改變，則重新部署這個(gè)應(yīng)用。這包括server.xml 或者上下文描述符文件中的Context元素。6、如果 $CATALINA_HOME/conf/enginename/hostna

7、me/目錄下增加了上下文描述符文件，則重新部署這個(gè)應(yīng)用。看來Tomcat5在動(dòng)態(tài)部署上花費(fèi)了不少功夫，其中的亮點(diǎn)主要就是如果我們修改了web.xml、server.xml配置文件，增加了上下文描述符文件，動(dòng)態(tài)更新了War文件時(shí)都可以實(shí)現(xiàn)應(yīng)用程序的自動(dòng)部署和更新，而不用重新啟動(dòng)Tomcat服務(wù)器，在Tomcat4中都是必須重新啟動(dòng)服務(wù)器的，這是一個(gè)非常喜人的變化。2. tomcat 的配置方式以下配置方式都是針對tomcat5.0以上版本。2.1 server.xml元素詳解兀素名屬性解釋serverport指定一個(gè)端口，這個(gè)端口負(fù)責(zé)監(jiān)聽關(guān)閉tomcat 的請求shutdown指定向端口發(fā)送的命

8、令字符串servicename指定service 的名字Connector（表示客戶端和service 之間的連 接）port指定服務(wù)器端要?jiǎng)?chuàng)建的端口號(hào)，并在這個(gè) 斷口監(jiān)聽來自客戶端的請求minProcessors服務(wù)器啟動(dòng)時(shí)創(chuàng)建的處理請求的線程數(shù)， 最小空閑連接線程數(shù)，用于提高系統(tǒng)處理性能， 默認(rèn)值為10maxProcessors最大可以創(chuàng)建的處理請求的線程數(shù)，最接 線程數(shù)，即：并發(fā)處理的最大請求數(shù)，默認(rèn)值為 75enableLookups如果為true ,則可以通過調(diào)用request.getRemoteHost（）進(jìn)彳D DNSlE詢來得到 遠(yuǎn)程客戶端的實(shí)際主機(jī)名，若為false則不進(jìn)行

9、DNSg詢，而是返回其ip地址redirectPort表示當(dāng)請求被傳輸或完整性保護(hù)的容時(shí)，非SS請求將會(huì)被重7E向的端口 acceptCount指定當(dāng)所有可以使用的處理請求的線程數(shù) 都被使用時(shí)，可以放到處理隊(duì)列中的請求數(shù)，超過這個(gè)數(shù)的請求將小予處埋，應(yīng)大于等于maxProcessors ,默認(rèn)值為 100connectionTimeout網(wǎng)絡(luò)連接超時(shí)，單位：毫秒。設(shè)置為 0表示永不 超時(shí)，這樣設(shè)置有隱患的。通?？稍O(shè)置為30000毫秒。表示該組件產(chǎn)生調(diào)試日志信息的詳細(xì)級(jí) 別，數(shù)字越大，產(chǎn)生的日志信息越詳細(xì).如果不 指定，該屬性值將被設(shè)置為（0）. 但是調(diào)試信息是否出現(xiàn)在日志中，還進(jìn)一步取決于10

10、g4j類另1J org.jboss.web.tomcat.tc5.Tomcat5的threshold設(shè)置請求編碼格式DebugURIEncodingEngine（ Wtk 指定service 中的 請求處理機(jī)，接收 和處理來自 Connector 的請求）defaultHost指定缺省的處理請求的主機(jī)名，它至少與 其中的一個(gè)host兀素的name屬性值是l樣的Context（表小 一個(gè)web應(yīng)用程序， 通常為WA&件， 關(guān)于WAR勺具體信 息見servlet 規(guī)）docBase應(yīng)用程序的路徑或者是 WARL件存放的路 徑path表7K此web應(yīng)用程序的url的前綴，這樣請求的 url

11、為 localhost:8080/path/*reloadable這個(gè)屬性非常重要,如果為true，則tomcat 會(huì)自動(dòng)檢測應(yīng)用程序的/WEB-INF/lib 和 /WEB-INF/classes 目錄的變化，自動(dòng)裝載新的 應(yīng)用程序，我們可以在不重起tomcat的情況下改變應(yīng)用程序host（表小個(gè)虛擬主機(jī)）name指定主機(jī)名appBase應(yīng)用程序基本目錄，即存放應(yīng)用程序的目unpackWARs如果為true ,則tomcat會(huì)自動(dòng)將 WA設(shè)件 解壓，否則不解壓，直接從 WA或件中運(yùn)行應(yīng)用 程序Logger（ W/K 日志，調(diào)試和錯(cuò)誤 信息）className指定logger使用的類名，此類必

12、須實(shí)現(xiàn)org.apache.catalina.Logger接口prefix指定log文件的前綴suffix指定log文件的后綴timestamp如果為true ,則log文件名中要加入時(shí)間，如下例：localhost_log.2001-10-04.txtRealm（表小存 放用戶名，密碼及 role的數(shù)據(jù)庫）className指定Realm使用的類名，此類必須實(shí)現(xiàn)org.apache.catalina.Realm接口Valve（功能與Logger差/、多，其className指定Vake使用的類名，如用org.apache.catalina.valves.AccessLogValveprefi

13、x 和 suffix 屬性解釋和Logger中的一樣）類可以記錄應(yīng)用程序的訪問信息directory一指7E log義件存放的位直pattern有兩個(gè)值，common式記錄遠(yuǎn)程主機(jī)名或 ip地址，用戶名，日期，第L行請求的字符串， HiiPU何應(yīng)代碼，發(fā)送的字節(jié)數(shù)。combined方式比common式記錄的值更多<Server> 兀素它代表整個(gè)容器,是Tomcat實(shí)例的頂層元素.由org.apache.catalina.Server 接口來 定義.它包含一個(gè)<Service>元素.并且它不能做為任何元素的子元素.<Server port="8005&qu

14、ot; shutdown="SHUTDOWN" debug="0">1> className 指定實(shí)現(xiàn) org.apache.catalina.Server接口的類.默認(rèn)值為org.apache.catalina.core.StandardServer2> port指定Tomcat監(jiān)聽shutdown命令端口 .終止服務(wù)器運(yùn)行時(shí)，必須在Tomcat服務(wù) 器所在的機(jī)器上發(fā)出 shutdown命令.該屬性是必須的.3> shutdown指定終止 Tomcat服務(wù)器運(yùn)行時(shí)，發(fā)給Tomcat服務(wù)器的shutdown監(jiān)聽端 口的字符串.該屬

15、性必須設(shè)置該元素由 org.apache.catalina.Service 接口定義，它包含一個(gè) <Engine>元素，以及一 個(gè)或多個(gè)<Connector>,這些Connector元素共享用同一個(gè) Engine元素Service name="Catalina"><Service name="Apache">第一個(gè)<Service>處理所有直接由Tomcat服務(wù)器接收的web客戶t#求.第二個(gè)<Service>處理所有由Apahce服務(wù)器轉(zhuǎn)發(fā)過來的 Web§戶請求1> cl

16、assName 指定實(shí)現(xiàn) org.apahce.catalina.Service 接口的類.默認(rèn)為 org.apahce.catalina.core.StandardService2> name定義Service 的名字<Engine> 元素每個(gè)Service元素只能有一個(gè) Engine元素.元素處理在同一個(gè)<Service>中所有<Connector> 元素接收至U的客戶請求 .由 org.apahce.catalina.Engine 接口定義.<Engine name="Catalina" defaultHost=&quo

17、t;localhost" debug="0">1> className指定實(shí)現(xiàn) Engine接口的類，默認(rèn)值為 StandardEngine2> defaultHost 指定處理客戶的默認(rèn)主機(jī)名，在<Engine>中的<Host>子元素中必須定義這一主機(jī)3> name定義 Engine 的名字在<Engine> 可以包含如下元素 <Logger>, <Realm>, <Value>, <Host><Host>元素它由Host接口定義.一個(gè)Engi

18、ne元素可以包含多個(gè) <Host>元素.每個(gè)<Host>的元素定 義了一個(gè)虛擬主機(jī).它包含了一個(gè)或多個(gè)Web應(yīng)用.<Host name="localhost" debug="0" appBase="webapps" unpackWARs="true" autoDeploy="true">1> className指定實(shí)現(xiàn) Host接口的類.默認(rèn)值為 StandardHost2> appBase指定虛擬主機(jī)的目錄，可以指定絕對目錄，也可以指定相對于&l

19、t;CATALINA_HOMEX對目錄.如果沒有此項(xiàng)，默認(rèn)為 <CATALINA_HOME>/webapps3> autoDeploy如果此項(xiàng)設(shè)為true,表示Tomcat服務(wù)處于運(yùn)行狀態(tài)時(shí)，能夠監(jiān)測 appBase下的文件，如果有新有web應(yīng)用加入進(jìn)來，會(huì)自運(yùn)發(fā)布這個(gè) WEBS用4> unpackWARsto果此項(xiàng)設(shè)置為true,表示把 WEBZ用的WAR：件先展開為開放目錄結(jié) 構(gòu)后再運(yùn)行.如果設(shè)為false將直接運(yùn)行為WA戲件5> alias指定主機(jī)別名，可以指定多個(gè)別名6> deployOnStartup 如果此項(xiàng)設(shè)為true,表示Tomcat服務(wù)器啟

20、動(dòng)時(shí)會(huì)自動(dòng)發(fā)布 appBase目錄下所有的 Web應(yīng)用.如果 Web應(yīng)用中的server.xml 沒有相應(yīng)的 <Context>元素，將采用Tomcat默認(rèn)的Context7> name定義虛擬主機(jī)的名字在 <Host> 元素中可以包含如下子元素<Logger>, <Realm>, <Value>, <Context><Context> 元素它由Context接口定義.是使用最頻繁的元素.每個(gè)Context元素代表了運(yùn)行在虛擬主 機(jī)上的單個(gè) Web應(yīng)用.一個(gè)<Host>可以包含多個(gè)<Co

21、ntext>元素.每個(gè)web應(yīng)用有唯一的一個(gè) 相 對 應(yīng) 的 Context 代 表 web應(yīng) 用自身.servlet 容器為 第一個(gè) web應(yīng)用創(chuàng) 建一個(gè) ServletContext 對象.<Context path="/myweb" docBase="sample" debug="0" reloadbale="true">1> className 指定實(shí)現(xiàn) Context 的類,默認(rèn)為 StandardContext 類2> path指定訪問 Web應(yīng)用的URL入口，注意/myw

22、eb,而不是 myweb了事3> reloadable 如果這個(gè)屬性設(shè)為true, Tomcat服務(wù)器在運(yùn)行狀態(tài)下會(huì)監(jiān)視在WEB-INF/classes 和 Web-INF/lib 目錄CLASS文件的改運(yùn).如果監(jiān)視到有 class文 件被更新，服務(wù)器自重新加載 Web應(yīng)用4> cookies指定是否通過 Cookies來支持Session,默認(rèn)值為true5> useNaming指定是否支持 JNDI,默認(rèn)值為了 true在<Context> 元素中可以包含如下元素<Logger>, <Realm>,Resource>，<Re

23、sourceParams>Connector 元素由Connector接口定義.Connector元素代表與客戶程序?qū)嶋H交互的給件，它負(fù)責(zé)接收客戶請求，以及向客戶返回響應(yīng)結(jié)果.Connector port="8080" maxThread="50" minSpareThreads="25"maxSpareThread="75" enableLookups="false" redirectPort="8443" acceptCount="100" de

24、bug="0" connectionTimeout="20000" disableUploadTimeout="true" /><Connection port="8009" enableLookups="false" redirectPort="8443" debug="0" protocol="AJP/1.3" />第一個(gè) Connector元素定義了一個(gè) HTTP Connector,它通過8080端口接收 HT

25、TP青求； 第二個(gè)Connector元素定義了一個(gè) JD Connector,它通過8009端口接收由其它服務(wù)器轉(zhuǎn)發(fā) 過來的請求.Connector元素共用屬性：1> className指定實(shí)現(xiàn) Connector接口的類2> enableLookups如果設(shè)為true,表示支持域名解析，可以把IP地址解析為主機(jī)名.WEB應(yīng)用中調(diào)用request.getRemoteHost方法返回客戶機(jī)主機(jī)名.默認(rèn)值為true3> redirectPort 指定轉(zhuǎn)發(fā)端口 .如果當(dāng)前端口只支持non-SSL請求，在需要安全通信的場命，將把客戶請求轉(zhuǎn)發(fā)至SSL的redirectPort 端口Ht

26、tpConnector元素的屬性1> className 實(shí)現(xiàn) Connector 的類2> port設(shè)定Tcp/IP端口，默認(rèn)值為8080,如果把8080改成80,則只要輸入 localhost 即可，因?yàn)門CP/IP的默認(rèn)端口是803> address如果服務(wù)器有二個(gè)以上ip地址，此屬性可以設(shè)定端口監(jiān)聽的ip地址.默認(rèn)情況下，端口會(huì)監(jiān)聽服務(wù)器上所有的ip地址4> bufferSize設(shè)定由端口創(chuàng)建的輸入流的緩存大小.默認(rèn)值為2048byte5> protocol 設(shè)定Http協(xié)議，默認(rèn)值為 HTTP/1.16> maxThreads設(shè)定在監(jiān)聽端口的線程的

27、最大數(shù)目，這個(gè)值也決定了服務(wù)器可以同時(shí)響應(yīng)客戶請求的最大數(shù)目.默認(rèn)值為2007> acceptCount設(shè)定在監(jiān)聽端口隊(duì)列的最大客戶請求數(shù)量，默認(rèn)值為10.如果隊(duì)列已滿，客戶必須等待.8> connectionTimeout 定義建立客戶連接超時(shí)的時(shí)間.如果為-1,表示不限制建立客戶連接的時(shí)間JkConnector 的屬性1> className 實(shí)現(xiàn) Connector 的類2> port設(shè)定AJP端口號(hào)3> protocol 必須設(shè)定為 AJP/1.32.1 如何加大tomcat連接數(shù)在tomcat配置文件 server.xml 中的Connector ./&

28、gt;配置中和最接數(shù)相關(guān)的參數(shù)為maxProcessors和acceptCount 。如果要加大并發(fā)連接數(shù)，應(yīng)同時(shí)加大這兩個(gè)參數(shù)。web server允許的最接數(shù)還受制于操作系統(tǒng)的核參數(shù)設(shè)置，通常Windows是2000個(gè)左右，Linux是1000個(gè)左右。tomcat4中的配置示例：<Connector className="org.apache.coyote.tomcat4.CoyoteConnector"port="8080" minProcessors="10" maxProcessors="1024"

29、enableLookups="false" redirectPort="8443"acceptCount="1024" debug="0" connectionTimeout="30000" /> 對于其他端口的偵聽配置，以此類推。2.2 tomcat中如何禁止列目錄下的文件在tomcat_home/conf/web.xml中，把 listings 參數(shù)設(shè)置成 false 即可，如下：<servlet>.<init-param><param-name>l

30、istings</param-name><param-value>false</param-value></init-param>.</servlet>2.3 解決tomcat存不足異常的問題1) 在通過startup.bat 啟動(dòng)修改 Catalina.bat 文件： 在 "rem Execute Java with the applicable properties”語句后添加 “ set CATALINA_OPTS= -Xms128m -Xmx768m” 語句，重起 tomcat 服務(wù)，設(shè) 置生效。2)利用window

31、s的系統(tǒng)服務(wù)啟動(dòng)tomcat服務(wù)，即通過執(zhí)行 tomcat.exe ,它讀取注冊表中 的值，而不是catalina.bat的設(shè)置.可通過如下兩種方式來解決： 修改注冊表 HKEY_LOCAL_MACHINESOFTWAREApache Software FoundationTomcatService ManagerTomcat5ParametersJavaOptions 原值為-Dcatalina.home="C:ApacheGroupTomcat 5.0"-Djava.endorsed.dirs="C:ApacheGroupTomcat 5.0commonend

32、orsed"-Xrs加入-Xms300m -Xmx350m重起tomcat服務(wù)，設(shè)置生效進(jìn)入tomcat客戶端設(shè)置 Initial memory pool 與 Maxinum memory pool 兩項(xiàng)，重起 tomcat 服務(wù)，設(shè)置生 效。1.1 windows更改系統(tǒng)環(huán)境變量力口上 JAVA_OPTS=-Xms64m -Xmx512mLinux在tomcat_home/bin/catalina.sh的前面，力口set JAVA_OPTS='-Xms64 -Xmx512'2.5 如何添加默認(rèn)訪問頁面 修改文件 web.xml ,在welcome-list 里面添加

33、index.wml作為默認(rèn)的訪問頁面 <welcome-file-list><welcome-file>index.html</welcome-file><welcome-file>index.htm</welcome-file><welcome-file>index.jsp</welcome-file></welcome-file-list>2.6 host 配置實(shí)例<Host name="20" debug="0" appBa

34、se="/webapps" uppackWars="true" autoDeploy="true">Context path="" docBase="ROOT" debug="0"/><!-下面套用的是tomcat自帶的管理頁面，在虛擬主機(jī)下也可使用 ->Context path="/manager" debug="0" privileged="true"docBase="/opt/

35、tomcat/server/webapps/manager"/>Context path="/jive" docBase="jive" debug="0"reloadable="true" crossContext="true"/>Logger className="org.apache.catalina.logger.FileLogger" prefix="host1_log." suffix=".txt" ti

36、mestamp="true"/></Host>2.7 解決通過admin發(fā)布時(shí)war包亂碼問題在tomcat配置文件server.xml 中的Connector/> 配置中設(shè)置 URIEncoding屬 性為 GBK 例： Connector port="8009"enableLookups="false" redirectPort="8443"protocol="AJP/1.3" URIEncoding="GBK"/>2.8 建立虛擬主機(jī)在下建

37、立文件夾 vhost.mydomain.。然后修改 jakarta-tomcat-5.5.xconfserver.xml<Engine defaultHost="localhost" name="Catalina"><Host appBase="vhost/.mydomain." name=".mydomain./">/Host><Host appBase="webapps" name="localhost">/Host>Rea