此頁面已封存且不再更新. 請注意,此頁面上提供的資訊可能已過時或不正確。 主要的 封存頁面 有簡短的說明。 |
如何在 Apache Tomcat 中安裝 Redmine¶
因為我已經在執行 Apache Tomcat 伺服器,所以我想用 Jruby 在它裡面執行 Redmine,這樣我就不必管理 mongrel/passenger 的設定。
這比我想像的要容易得多,並且在 Ubuntu Karmic 上使用那裡提供的 tomcat6 套件,與 Redmine 0.8.0 和 0.8.6 版本都能夠完美運作。
0.8.7 版本上有一個尚未解決的問題!請參閱 https://redmine.dev.org.tw/issues/4276
*已針對 1.1.1 版本在建置 war 檔和在 Tomcat 6 上執行時發生的問題,變更了 warble.rb。
先決條件和假設¶
假設您已經安裝了一個可以在純 Ruby 環境中運作的 Redmine,這意味著它可以與./scripts/server -e production
一起運作。如果沒有,請先查看一般的安裝文件!
我正在使用與執行在與 Tomcat 應用程式伺服器相同的機器上的 MySQL 伺服器的 Socket 連線。
透過網路連線到 MySQL 可能需要一些額外的步驟(例如配置 JDBC)。
還假設您已經安裝並執行了一個 Tomcat 應用程式伺服器 - 如果您還沒有安裝,也不知道如何安裝,您很可能會使用純 Ruby 以預設方式執行 Redmine。
儘管如此,對於不太熟悉 Java 平台但仍然願意在此處測試 Redmine 的 Redmine 開發人員,我在下面添加了有關如何設定和執行 Tomcat 伺服器的章節。
安裝必要的工具¶
- Jruby 二進制檔(可能只是用於測試,沒有用於部署?我還沒有卸載它並測試是否仍然有效,但我認為它們會有效)
- aptitude install jruby1.2
- 進入 Redmine 目錄
cd redmine-VERSION
- 在 Tomcat Servlet 容器外部手動測試執行 Redmine - 只是為了確保它在部署到 Tomcat 之前可以正常運作(資料庫等)
jruby ./script/server -e production
- 安裝 warbler gem - 一個將 Rails 應用程式打包為 Java Web 應用程式 .war 檔的工具
gem install warbler
建置 .war 檔¶
.war 檔是一個 Web 應用程式套件 - 將應用程式打包以部署到 Java Servlet 容器的標準方式。
- 在配置模式下執行 warbler
warble config
- 或者,如果 warbler 不在您的路徑中,就像在我的設定中一樣:~/.gem/ruby/1.8/bin/warble config
- 編輯 warbler 配置
vim config/warble.rb
- 將以
config.dirs...
開頭的行更改為如下所示config.dirs = %w(app config lib log vendor tmp extra files lang)
- 取消註釋此行並添加 i18n 和 rack 以進行打包
config.gems += ["activerecord-jdbcmysql-adapter", "jruby-openssl", "i18n", "rack"]
- 從 Redmine 0.8.7 開始(此版本之前的版本不需要!),您還需要創建一個「會話密鑰」
rake config/initializers/session_store.rb
- 再次運行 warble(不帶 config)
warble
- 或者如果 warble 不在您的路徑中,例如在我的設置中:~/.gem/ruby/1.8/bin/warble
您現在應該在 redmine 目錄中有一個名為 redmine-VERSION.war
的文件。
部署 Web 應用程序並享受¶
將 redmine war 文件放入您的 tomcat webapps 目錄中
cp redmine-VERSION.war $TOMCAT_HOME/webapps/redmine.war
Redmine 應該在 http://your-tomcat-host.name:8080/redmine 上運行 - 您可能需要調整主機名和端口。
Tomcat 設置¶
如上所述,如果您閱讀了本操作指南,通常您已經在運行 tomcat 或至少知道如何安裝它。但是對於願意出於其他原因使用它的人(例如,試圖重現錯誤的 Redmine 開發人員 :)),這裡有一些關於安裝 tomcat 的說明
- 安裝 Java 6 JDK - 從 sun 下載或使用來自您的 Linux 發行版的軟件包,在 Ubuntu 上,即
apt-get install openjdk-6-jdk
- 下載 Tomcat,例如從 https://tomcat.dev.org.tw/download-60.cg 提到的位置下載 - 例如
wget http://apache.autinity.de/tomcat/tomcat-6/v6.0.20/bin/apache-tomcat-6.0.20.tar.gz
- 解壓縮存檔
- tar xvfz apache-tomcat-6.0.20.tar.gz
- 您將有一個目錄(在上面的部署步驟中稱為 TOMCAT_HOME),進入該目錄並運行 tomcat
sh bin/startup.sh
- 通過檢查 http://your-tomcat-host.name:8080 來測試 tomcat 是否正在運行
就是這樣,您已準備好在該 Tomcat 服務器中部署 redmine!