Tomcat4.01 配置全攻略

攻略
相關網址：http://www.yufeng.net
-----------------------------

Tomcat4.01全攻略 
一：簡介 
tomcat是jakarta項目中的一個重要的子項目，其被JavaWorld雜誌的編輯選為2001年度最具創新的java產品(Most Innovative Java Product)，同時它又是sun公司官方推薦的servlet和jsp容器(具體可以見http://java.sun.com/products/jsp/tomcat/)，因此其越來越多的受到軟體公司和開發人員的喜愛。servlet和jsp的最新規範都可以在tomcat的新版本中得到實現。 

二：安裝及配置 
tomcat最新版本為4.0.1，這個版本用了一個新的servlet容器Catalina，完整的實現了servlet2.3和jsp1.2規範。注意安裝之前你的系統必須安裝了jdk1.2以上版本。 

(一)：安裝 
1：windows平台 
從tomcat網站下載jakarta-tomcat-4.0.1.exe，按照一般的windows程式安裝步驟即可安裝好tomcat,安裝時它會自動尋找你的jdk和jre的位置。 

2：linux平台 
下載jakarta-tomcat-4.0.1.tar.gz，將其解壓到一個目錄。 

(二)：配置 
運行tomcat需要設定JAVA_HOME變數 
set JAVA_HOME=c:/jdk (win98，在msdos方式下使用，或者放入autoexec.bat中) 
export JAVA_HOME=/usr/local/jdk (linux下使用，放到/etc/bashrc或者/etc/profile中) 

(三)：運行 
設定完畢後就可以運行tomcat伺服器了，進入tomcat的bin目錄，win98下用startup啟動tomcat，linux下用startup.sh，相應的關閉tomcat的命令為shutdown和shutdown.sh。 
啟動後可以在瀏覽器中輸入http://localhost:8080/測試，由於tomcat本身具有web伺服器的功能，因此我們不必安裝apache，當然其也可以與apache整合到一起，下面會介紹。 
下面你可以測試其內建的jsp和servlet樣本。 

三：應用 

(一):目錄結構 
tomcat的目錄結構如下： 
目錄名: 簡介 
bin : 存放啟動和關閉tomcat指令碼 
conf : 包含不同的設定檔,server.xml(Tomcat的主要設定檔)和web.xml 
work : 存放jsp編譯後產生的class檔案 
webapp: 存放應用程式樣本，以後你要部署的應用程式也要放到此目錄 
logs : 存放記錄檔 
lib/japser/common : 這三個目錄主要存放tomcat所需的jar檔案 


(二)：server.xml配置簡介 
下面我們將講述這個檔案中的基本配置資訊，更具體的配置資訊見tomcat的文檔 
server: 
port 指定一個連接埠，這個連接埠負責監聽關閉tomcat的請求 
shutdown 指定向連接埠發送的命令字串 
service: 
name 指定service的名字 
Connector (表示用戶端和service之間的串連): 
port 指定伺服器端要建立的連接埠號碼，並在這個斷口監聽來自用戶端的請求 
minProcessors 伺服器啟動時建立的處理請求的線程數 
maxProcessors 最大可以建立的處理請求的線程數 
enableLookups 如果為true，則可以通過調用request.getRemoteHost()進行DNS查詢來得到遠程用戶端的實際主機名稱，若為false則不進行DNS查詢，而是返回其ip地址 
redirectPort 指定伺服器正在處理http請求時收到了一個SSL傳輸請求後重新導向的連接埠號碼 
acceptCount 指定當所有可以使用的處理請求的線程數都被使用時，可以放到處理隊列中的請求數，超過這個數的請求將不予處理 
connectionTimeout 指定逾時的時間數(以毫秒為單位) 
Engine (表示指定service中的請求處理機，接收和處理來自Connector的請求): 
defaultHost 指定預設的處理請求的主機名稱，它至少與其中的一個host元素的name屬性值是一樣的 
Context (表示一個web應用程式，通常為WAR檔案，關於WAR的具體資訊見servlet規範): 
docBase 應用程式的路徑或者是WAR檔案存放的路徑 
path 表示此web應用程式的url的首碼，這樣請求的url為http://localhost:8080/path/**** 
reloadable 這個屬性非常重要，如果為true，則tomcat會自動檢測應用程式的/WEB-INF/lib 和/WEB-INF/classes目錄的變化，自動裝載新的應用程式，我們可以在不重起tomcat的情況下改變應用程式 
host (表示一個虛擬機器主機): 
name 指定主機名稱 
appBase 應用程式基底本目錄，即存放應用程式的目錄 
unpackWARs 如果為true，則tomcat會自動將WAR檔案解壓，否則不解壓，直接從WAR檔案中運行應用程式 
Logger (表示日誌，調試和錯誤資訊): 
className 指定logger使用的類名，此類必須實現org.apache.catalina.Logger 介面 
prefix 指定log檔案的首碼 
suffix 指定log檔案的尾碼 
timestamp 如果為true，則log檔案名稱中要加入時間，如下例:localhost_log.2001-10-04.txt 
Realm (表示存放使用者名稱，密碼及role的資料庫): 
className 指定Realm使用的類名，此類必須實現org.apache.catalina.Realm介面 
Valve (功能與Logger差不多，其prefix和suffix屬性解釋和Logger 中的一樣): 
className 指定Valve使用的類名，如用org.apache.catalina.valves.AccessLogValve類可以記錄應用程式的訪問資訊 
directory 指定log檔案存放的位置 
pattern 有兩個值，common方式記錄遠程主機名稱或ip地址，使用者名稱，日期，第一行請求的字串，HTTP響應代碼，發送的位元組數。combined方式比common方式記錄的值更多 

注意： 
1：經過我測試，我設定Context 的path="",reloadable=true，然後放一個WAR檔案到webapps目錄，結果tomcat不能檢測出此檔案(重起tomcat可以)，而把此檔案解壓，則tomcat會自動檢測出這個新的應用程式。如果不能自動檢測WAR檔案，我們可以利用下面管理中講的方法來部署應用程式。 

2：預設的server.xml中，Realm元素只設定了一個className屬性，但此檔案中也包含幾個通過JDBC串連到資料庫進行驗證的樣本(被注釋掉了)，通過Realm元素我們可以實現容器安全管理(Container Managed Security)。 

3：還有一些元素我們沒有介紹，如Parameter，loader，你可以通過tomcat的文檔擷取這些元素的資訊。 

(三)：管理 

1：配置 
在進行具體的管理之前，我們先給tomcat添加一個使用者，使這個使用者有許可權來進行管理。 
開啟conf目錄下的tomcat-users.xml檔案，在相應的位置添加下面一行： 

<user name="zf" password="zf" roles="standard,manager"/>
注意：這一行的最後部分一定是/>,tomcat的文檔掉了/符號，如果沒有/符號的話，tomcat重起時將無法訪問應用程式。通過logs/catalina.out檔案你可以看到這個錯誤的詳細資料。 

然後重起tomcat，在瀏覽器中輸入http://localhost:8080/manager/，會彈出對話方塊，輸入上面的使用者名稱和密碼即可。 

2：應用程式列表 
在瀏覽器中輸入http://localhost:8080/manager/list，瀏覽器將會顯示如下的資訊： 

OK - Listed applications for virtual host localhost 
/ex:running:1 
/examples:running:1 
/webdav:running:0 
/tomcat-docs:running:0 
/manager:running:0 
/:running:0 

上面的資訊分別為應用程式的路徑，目前狀態(running 或者stopped)，與這個程式相連的session數。 

3：重新裝載應用程式 
在瀏覽器中輸入 http://localhost:8080/manager/reload?path=/examples，瀏覽器顯示如下： 

OK - Reloaded application at context path /examples 

表示example應用程式裝載成功，如果我們將server.xml的Context元素的reloadable屬性設為true(見上面表格)，則沒必要利用這種方式重新裝載應用程式，因為tomcat會自動裝載。 

4：顯示session資訊 
在瀏覽器中輸入http://localhost:8080/manager/sessions?path=/examples，瀏覽器顯示如下： 

OK - Session information for application at context path /examples Default maximum session inactive interval 30 minutes 

5：啟動和關閉應用程式 
在瀏覽器中輸入http://localhost:8080/manager/start?path=/examples和http://localhost:8080/manager/stop?path=/examples分別啟動和關閉examples應用程式。 

6：部署及撤銷部署 
WAR有兩種組織方式，一種是按一定的目錄結構組織檔案，一種是一個尾碼為WAR的壓縮包，因此它的部署方式也有兩種： 
(1)：在瀏覽器中輸入：http://localhost:8080/manager/install?path=/examples&war=file:/c:examples 
就會將按目錄結構組織的WAR部署 

(2)：如果輸入:http://localhost:8080/manager/install?path=/examples&war=jar:file:/c:examples.war!/ 
就會將按壓縮包組織的WAR部署，注意此url後半部分一定要有!/號。 
部署後就可以用 http://localhost:8080/examples訪問了。 

在瀏覽器中輸入：http://localhost:8080/manager/remove?path=/examples 就會撤銷剛才部署的應用程式。 

(四)：與apache整合 
雖然tomcat也可以作web伺服器,但其處理靜態html的速度比不上apache,且其作為web伺服器的功能遠不如apache,因此我們想把apache和tomcat整合起來。 
我們以linux系統為例介紹. 
從apache網站下載apache1.3.22原始碼版本，然後使用如下命令配置安裝apache： 

mkdir /usr/local/apache 
tar zxvf apache.1.32.tar.gz 
cd apache.1.32 
./configure --prefix=/usr/local/apache --enable-module=so 
make 
make install 

注意configure命令指定目標安裝目錄，並且加入DSO(Dynamic Shared Object)支援，注意一定不要忘了這一個選項。 

然後下載webapp模組，將解壓後mod_webapp.so檔案放入apache的libexec目錄，編輯apache的conf目錄下的httpd.conf，在這個檔案的最後加入下面三行： 

LoadModule webapp_module libexec/mod_webapp.so 
WebAppConnection warpConnection warp localhost:8008 
WebAppDeploy examples warpConnection /examples/ 

第一行是加入webapp模組，如果編譯apache時不增加DSO支援，則無法使用LoadModule指令，第二行指定tomcat與apache的串連，第三行指定部署那個應用，這兩個指令使用格式如下： 

WebAppConnection [connection name] [provider] [host:port] 
WebAppDeploy [application name] [connection name] [url path] 

其中connection name指定串連名，provider只能是warp，port連接埠與你的tomcat的設定檔server.xml最後幾行指定的要保持一致。檔案如下： 

<Service name="Tomcat-Apache"> 
<Connector className="org.apache.catalina.connector.warp.WarpConnector"
port="8008" minProcessors="5" maxProcessors="75"
enableLookups="true"
acceptCount="10" debug="0"/> 
****** 
</Service> 

application name與你在tomcat中部署的應用程式名稱一致，url path指定訪問這個應用的url。例如上面的例子可以通過http://localhost/examples/來訪問tomcat中的examples應用。 

(五)：中文問題 
一般jsp的亂碼問題可以通過在jsp中加入<%@ page contentType="text/html;charset=GB2312" %>來解決，至於servlet的亂碼在可以使用servlet2.3中提供的HttpServeletRequest.setCharacterEncoding函數。更詳細的中文問題請見JSP/Servlet 中的漢字編碼問題。 

四：綜述 
tomcat作為一個servlet(jsp也被編譯為servlet執行)容器，其應用前景是非常好的，如果與jboss結合起來，則可以實現sun的j2ee規範(用jboss作ejb伺服器)。jboss的官方網站也提供整合了tomcat3.2*的jboss以供下載。另外一個開源的應用伺服器(enhydra) 也是基於tomcat的，其提供了更友好的管理介面，部署應用程式也更簡單，功能也更強大。

win98
環境變數的配置，通過編輯c:\autoexec.bat
添加
set JAVA_HOME=C:\jdk1.4
set CATALINA_HOME=C:\jatarta-tomcat-3
set CLASSPATH=C:\jatarta-tomcat-3\common\lib ervlet.jar;.
set PATH=C:\windows;C:\jdk1.4\bin
可能還需要增加你的環境空間，編輯C;\config.sys
增加
shell=C:\command.com /e:1024 /p
重起windows,就可以了