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的設定
- httpd.conf: http server設定
- ssl.conf: https設定
- mod_jk.conf: apache tomcat connector設定
- workers.properties: 與tomcat的對應設定
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。
留言
張貼留言