Apache Tomcat Connector實務

Introduction

Apache Tomcat Connector的目的是讓User可以透過80或443的port訪問Tomcat Server。也許你會想: 我直接把Tomcat Server的port從8080改成80不就好了嗎?也許這是一種方式，假如你的server主機上不只有tomcat，必須還有apache時，該怎麼辦?又或者你想提供一個單一入口管道可以去訪問不同機器上的Tomcat Server，可能也會需要用到它。而我所遇到的問題是因為facebook的FB.ui API在2012年3月之後，如果主機不是使用80或443的port會造成Dialong Hang住。此外，我的server上還有裝這個筆記本，才會讓我想使用這個解決方法。

網路上其實可以找到許多關於設定Apache Tomcat Connector的文章，我也想著: 大部分已經寫的很齊全了，我應該不需要再著墨。然而在我實際操作時，也遇到不少問題。雖然我是邊看電影邊研究怎做(不可能的任務2、3與交響情人夢)，也花了一個工作天才完成。我所使用的作業系統是CentOS5.6，Apache2.2.3。其中要做的事情，只是要把mod_jk.so安裝到apache上，接著做些設定就好了，但為什麼我要花一個工作天研究呢? 原因很簡單，首先是mod_jk最新版是2012年發佈的，大部分教學都已經是過時的玩意了；還有我希望能夠支援http與https，而教學大都對http做說明。廢話少說，我們直接開始進行安裝與設定工作。

下載與編譯

首先至Apache Tomcat Connector下載頁面，取得source code並編譯。這裡必須注意的是: apxs必須安裝https-devel才會出現，不妨先使用find / | grep apxs找看看系統中是否存在與位置在哪。

wget http://www.apache.org/dist/tomcat/tomcat-connectors/jk/tomcat-connectors-1.2.35-src.tar.gz
tar zxvf tomcat-connectors-1.2.35-src.tar.gz
cd tomcat-connectors-1.2.35-src/native
./configure --with--apxs=/usr/sbin/apxs --with--apache2=/etc/httpd

在編譯完成後，會產生mod_jk.so到apache-2.0資料夾中。將它複製到httpd/modules中並修改httpd.conf，加入“LoadModule jk_module modules/mod_jk.so”。

Tomcat的設定

設定相當簡單，只需要在%TOMCAT_HOME%/confg/server.xml中，加入ajp1.3的connector即可。目的是為了提供Apache連進來的管道。如下圖，Apache連至Tomcat所使用的port為8009，而Tomcat會將它導向至8443。(8443一般為https的port，如果沒使用就改為8080 port)

Apache的設定

Apache設定重點為網址過濾導向清單與Tomcat對應設定。在我的主機上有以下項目:

httpd.conf: http server設定
ssl.conf: https設定
mod_jk.conf: apache tomcat connector設定
workers.properties: 與tomcat的對應設定

httpd.conf要將其它config給加進去。其中關係是httpd.conf包含ssl.conf與mod_jk.conf，mod_jk.conf包含workers.properties。這裡最需要注意的是: 順序。ssl.conf要在mod_jk.conf之後給include進來，否則你在ssl.conf中怎設定都會無法作用(我在這裡被荼毒很久)。

接著設定mod_jk.conf。最需要注意的是JkWorkersFile與JkMount，JkWorkersFile是workers.properties的路徑，而JkMount是負責設定URL的對應。以我的例子而言，在Tomcat Server上我有LearningEnglish與LogoutArmyCD兩個應用程式，因此我針對LearningEnglish與LogoutArmyCD兩個名稱做filter，當然你也可以針對附檔名去處理。這兩個AP分別對應到le與lacd，這標記是記錄在workers.properties中。

JkWorkersFile conf/workers.properties
JkLogFile  /var/log/jk.log
JkShmFile  /var/log/jk-runtime-status
JkLogLevel info
JkLogStampFormat "[%a %b %d %H:%M:%S %Y] "
JkOptions +ForwardKeySize +ForwardURICompat -ForwardDirectories
JkRequestLogFormat "%w %V %T"
 
JkMount /LearningEnglish le
JkMount /LearningEnglish/* le
 
JkMount /LogoutArmyCD lacd
JkMount /LogoutArmyCD/* lacd

ssl.conf的部分只需要加入Filter對應即可。當User透過https訪問到LearningEnglish或LogoutArmyCD時，會自動導向至le與lacd所設定的Tomcat Server上。

<VirtualHost *:443>
...
JkMount /LearningEnglish le
JkMount /LearningEnglish/* le
 
JkMount /LogoutArmyCD lacd
JkMount /LogoutArmyCD/* lacd
</VirtualHost>

workers.properties的樣本可以從/tomcat-connectors-1.2.35-src/conf中找到。下面的設定是LearningEnglish這個AP的設定。需注意的是，如果你要改成自己的標記，只要將le部分替代掉即可，而worker.le.host與worker.le.port分別代表Tomcat Server的ip位置與所使用的ajp13的port。

worker.balancer.balance_workers=le
worker.list=le
worker.le.reference=worker.template
worker.le.host=localhost
worker.le.port=8009
worker.le.type=ajp13
worker.le.activation=A

最後將Tomcat與Apache Server重新啟動就可以使用了!

Summary

mod_jk與workers.properties還有許多有的沒的設定我並沒有深入去研究，如果有興趣的人可以參考官網文件嘗試修改看看。另外在我使用這個方法之後，對應用程式並非沒有任何影響。舉例來說，原先透過HttpServletResponse寫出做頁面導向的javascript(window.top.location)無法正常執行。因此在使用這個方式之後，作者建議你要將應用程是仔細測過一次!

OS: “當年”就是使用這個來破只允許80 port通過的防火牆，好讓機器可以上msn。

阿兩的筆記本 Ryoutsu's Notebook

搜尋此網誌