跳到主要內容

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。

Resource

留言

這個網誌中的熱門文章

PostgreSQL - Unattended installation on windows

Introduction 要將別人軟體包裝到自己軟體中,不可或缺的東西就是Unattended installation。以Unattended installation來說,我們可以選擇透過Installer的silent mode安裝,也可以透過把目標軟體做成portable的版本。本篇文章分享這兩種方法,教導大家如何將PostgreSQL透過Unattended installation方式安裝到目標系統成為service。 Note. 本篇以PostgreSQL 10.7為例。 Install with installer Tips 安裝程式或反安裝程式的參數,除了可以直接上官網搜尋Installation User Guide以外,也可以直接使用help參數查詢: postgresql- 10.7 - 2 -windows-x64.exe --help Windows安裝程式主要有EnterpriseDB與BigSQL兩種。BigSQL版本安裝元件是透過網路下載且支援參數不如EnterpriseDB版本多,以我們需求來說,我們傾向於使用EnterpriseDB版本。接下來分享給大家安裝與反安裝方法。 Installation @ echo off set INSTALL_DIR =C:\postgres10 set INSTALLER =postgresql- 10.7 - 2 -windows-x64.exe   rem options for installation set SSMDB_SERVICE =postgresql- 10 set MODE =--unattendedmodeui none --mode unattended   set DB_PASSWD =--superpassword postgres set DB_PORT =--serverport 5432   set SERVICE_NAME =--servicename % SSMDB_SERVICE %   set PREFIX =--prefix "%INSTALL_DIR%" set DATA_DIR =--datadir "%INSTALL_DIR%\data"   set OPTIONS =

How to install RIDE on Windows?

Introduction 多年沒在Windows上開發RobotFramework,趁著這次整理一下RIDE安裝方法。 目前RIDE最新版本與Python對應版本如下: (3.6 < python <= 3.11) Install current released version (2.0.8.1) with: pip install -U robotframework-ride 安裝Python 直接到Python官網找尋最新的3.11版本,我使用3.11.9: link 。安裝就是一直下一步而已。 安裝wxPython 每次安裝RIDE最困難的都是wxPython。看了一下 官網 描述,我就姑且相信一下: 接著進入下 載頁面 就有安裝教學。基本上就是到Python目錄下的Scripts直接執行以下command: pip install -U wxPython 安裝RIDE 接著就如RIDE官網所說,執行以下command: pip install -U robotframework-ride 啟動RIDE 直接在相同目錄下執行ride就可以啟動了,你也可以直接在桌面建ride連結,加快下次啟動時間。 沒想到這次這麼順利就安裝完成了。因為我是使用java去啟動robot framework,就不特別講要怎麼使用pip安裝robot framework了。

Hello World!

即將要搬家,因此舊網頁內容將慢慢轉移至Blogger。 如果要存取舊網頁,可以使用以下連結: https://wiki.tonylin.idv.tw/dokuwiki/doku.php