XML Technology Research Lab: 安裝 Tomcat 5.5.x

安裝 Tomcat 5.5.x

This document is provided as is. You are welcomed to use it for non-commercial purpose.
Written by: 國立中興大學資管系呂瑞麟

請勿轉貼

看其他教材

支援一般連線

Tomcat 是一個讓開發者能夠執行 JSP/servlet 的伺服器（比較專業的說法是 container），其安裝步驟如下：

安裝 JDK 1.5.x 版或者更新的版本。

記得要設定環境變數 JAVA_HOME。假設 JDK 安裝在 c:\jdk，我們需要執行 set JAVA_HOME=c:\jdk或者在控制台內設定。

安裝 Tomcat（我們以 5.5.x 版為例；並假設 Tomcat 安裝於 d:\tomcat）。下列的設定不適用於 Tomcat 6.x 或者 Ttomcat 7.x 版。

下載點 http://tomcat.apache.org/download-55.cgi
請下載 zip 檔並將它解壓縮到 d:\
為了減少 typing，將目錄名稱從 apache-tomcat-5.5.x 改成 tomcat
為了測試方便，我們建議將 d:\tomcat\conf\context.xml 這個檔案內的 <Context> 改成 <Context reloadable="true"> 。
為了能使用 servlet，請修改 d:\tomcat\conf\web.xml，將下列設定的註解刪除掉：
```
  <servlet>
    <servlet-name>invoker</servlet-name>
    <servlet-class>org.apache.catalina.servlets.InvokerServlet</servlet-class>
    ...
  </servlet>
  ...
  <servlet-mapping>
    <servlet-name>invoker</servlet-name>
    <url-pattern>/servlet/*</url-pattern>
  </servlet-mapping>
  
```
上述兩項設定的大概意思是：如果瀏覽器傳過來 URL 的最後面包含 /servlet/任意servlet名稱（即 url-pattern 的設定，其中 * 代表任意servlet名稱），Tomcat 就會把工作交給名稱為 invoker 的程式負責（即 servlet-name），而 invoker 實際上是 org.apache.catalina.servlets.InvokerServlet 類別。
假設我們要建立一個新的專案，其名稱為 xml，請在 d:\tomcat\webapps 建立一個目錄 d:\tomcat\webapps\xml，並在 d:\tomcat\webapps\xml 下建立 d:\tomcat\webapps\xml\WEB-INF 以及 d:\tomcat\webapps\xml\WEB-INF\classes。

開啟”命令提示字元”，並 cd 到 d:\tomcat\bin；執行 .\startup.bat，你將會看到一連串的訊息，執行的畫面類似下圖：
開啟你喜歡的瀏覽器，並輸入 http://127.0.0.1:8080/。如果你的結果如下圖，表示你的安裝成功；你也可以在進一步測試一下 tomcat 提供的 JSP 和 servlet 的範例。

支援安全連線

許多資訊系統往往要求比較高的安全強度，其中一項就是希望能夠在連線的過程，彼此交換的資料都能夠以加密的方式來進行；也就是使用 https。 tomcat 也支援 https，而且設定的方式也很簡單。如果要使得 tomcat 支援安全連線，請先確認你已經依據上一節的內容完成 tomcat 的基本安裝。要進行 https 連線之前，tomcat（或者其他的網頁伺服器）都需要一個電子憑證；電子憑證的目的主要是希望能夠經由公正的第三者來證明"你就是你說的你"或者"使用者連過去的公司真的就是那家公司"。如果你開發的系統是給一個正式的機構，那麼我們建議你去申請一個電子憑證，例如：VerySign 等公司。如果你只是想測試一下，那麼你可以建立自己的電子憑證，只不過你的使用者可能會怕怕的，我們等一下以圖片說明。
為 tomcat 產生電子憑證，以及利用瀏覽器來使用 https 的方式如下：

產生電子憑證：請開啟"命令提示字元"視窗，並依照以下畫面來執行：

密碼的長度要求至少 6 位。預設的情形下，該電子憑證（.keystore）的有效期間是 3 個月；你可以加長，假設你想加長為 365 天，請在指令最後加上 -validity 365即可。
請將 .keystore 檔放置於 tomcat 的目錄；在本範例中，請放在 d:\tomcat。

請修改 d:\tomcat\conf\server.xml 的內容。利用編輯器（例如記事本之類的工具）開啟檔案，並找尋如下的部分：

    <!-- Define a SSL HTTP/1.1 Connector on port 8443 -->
    <!--
    <Connector port="8443" maxHttpHeaderSize="8192"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" disableUploadTimeout="true"
               acceptCount="100" scheme="https" secure="true"
               clientAuth="false" sslProtocol="TLS" />
    -->

首先，將 Connector 標籤前後的註解刪除掉；然後，依據下列綠色的部分加到 server.xml 中。其中，passwd 必須與你之前產生電子憑證時的密碼相同。修改後的 server.xml 如下所示：

    <!-- Define a SSL HTTP/1.1 Connector on port 8443 -->
    <Connector port="8443" maxHttpHeaderSize="8192"
               maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
               enableLookups="false" disableUploadTimeout="true"
               acceptCount="100" scheme="https" secure="true"
               clientAuth="false" sslProtocol="TLS" 
               keystoreFile=".keystore" keystorePass="passwd" />