Bitnami Redmine安裝程序 --文檔

時間 2019-11-10

標籤 bitnami redmine 安裝程序文檔简体版

原文原文鏈接

注意：在運行此頁面上顯示的命令以前,您應該經過執行installdir/use_APPNAME腳本（Linux和Mac OS X）或單擊「開始 - > Bitnami APPNAME堆棧」下的「開始」菜單中的快捷方式來加載Bitnami堆棧環境。>應用程序控制臺「（Windows）.瞭解更多。

注意：運行此頁面上顯示的命令時，請將installdir佔位符替換爲Bitnami堆棧的完整安裝目錄。

描述

Redmine是一個流行的開源項目管理和問題跟蹤平臺,涵蓋多個項目和子項目,每一個項目和子項目都有本身的一組用戶和工具,來自同一個地方.php

試用OS X VM for Mac（測試版）.這款新產品讓您只需點擊幾下便可在Mac上輕鬆運行此應用程序.不須要VirtualBox！在此處查找更多相關信息.

Bitnami Redmine Stack的第一步

歡迎來到您的新Bitnami應用程序!如下是您首次啓動應用程序時可能須要的幾個問題（和答案！）.html

系統要求是什麼?

在下載和安裝應用程序以前，請檢查您的系統是否知足這些要求.mysql

如何安裝Bitnami Redmine Stack?

Windows,OS X和Linux安裝程序linux

從Bitnami網站下載Bitnami Redmine Stack的可執行文件。git
運行下載的文件：github
- 在Linux上，爲安裝程序提供可執行權限並在控制檯中運行安裝文件。
- 在其餘平臺上，雙擊安裝程序並按照顯示的說明進行操做。

有關詳細信息,請查看有關如何下載和安裝Bitnami堆棧的FAQ說明.web

該應用程序將安裝到如下默認目錄:正則表達式

操做系統	目錄
視窗	C：\Bitnami \ APPNAME-VERSION
Mac OS X.	/應用/APPNAME-VERSION
Linux的	/opt/APPNAME-VERSION（以root用戶身份運行）

OS X VMsql

從Bitnami網站下載Bitnami Redmine Stack的OS X VM文件。
雙擊圖像文件並將WordPress OS X VM圖標拖到「應用程序」文件夾，開始安裝過程。
雙擊Applications文件夾中的圖標啓動VM。

我須要什麼證件？

您須要應用程序憑據,包括用戶名和密碼.這些憑據容許您登陸到新的Bitnami應用程序.shell

爲我首次登陸應用程序設置的管理員用戶名是什麼？

對於Windows，Linux和OS X安裝程序，您在首次安裝應用程序時配置了用戶名。
對於OS X VM，能夠經過單擊應用程序歡迎頁面右下角的Bitnami徽章來獲取用戶名。

什麼是管理員密碼？

對於Windows,Linux和OS X安裝程序,您在首次安裝應用程序時配置了密碼.
對於OS X VM,能夠經過單擊應用程序歡迎頁面右下角的Bitnami徽章來獲取密碼.

如何啓動或中止服務？

Linux的

Bitnami本機安裝程序包括一個用於管理服務的圖形工具。此工具在Linux上名爲 manager-linux-x64.run，位於安裝目錄中。要使用此工具，請雙擊該文件，而後使用圖形界面啓動，中止或從新啓動服務。能夠在「服務器事件」選項卡中檢查服務器日誌消息。

本機安裝程序還包括一個命令行腳本,用於啓動,中止和從新啓動應用程序,名爲ctlscript.sh.能夠在安裝目錄中找到此腳本,並接受選項start,stop,restart和status.要使用它,請按照如下示例登陸服務器控制檯並執行它：

無需任何服務名稱便可調用它來啓動全部服務：

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh start
#installdir 爲安裝目錄
```
僅經過將服務名稱做爲參數傳遞來使用它來從新啓動特定服務 - 例如,mysql,postgresql或apache:

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart mysql
sudo installdir/ctlscript.sh restart postgresql
sudo installdir/ctlscript.sh restart apache
```
獲取全部服務的當前狀態：
```
installdir/ctlscript.sh status
```

可用服務列表因每一個應用程序所需的組件而異.

Mac OS X.

Bitnami本機安裝程序包括一個用於管理服務的圖形工具.此工具在Mac OS X上名爲manager-osx,位於安裝目錄中.要使用此工具,請雙擊該文件,而後使用圖形界面啓動,中止或從新啓動服務.能夠在「服務器事件」選項卡中檢查服務器日誌消息.

本機安裝程序還包括一個命令行腳本,用於啓動,中止和從新啓動應用程序,名爲ctlscript.sh.能夠在安裝目錄中找到此腳本,並接受選項start,stop,restart和status.要使用它,請按照如下示例登陸服務器控制檯並執行它:

無需任何服務名稱便可調用它來啓動全部服務:

注意:若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）.
```
sudo installdir/ctlscript.sh start
```
僅經過將服務名稱做爲參數傳遞來使用它來從新啓動特定服務 - 例如,mysql或apache:

注意:若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）.
```
sudo installdir/ctlscript.sh restart mysql
sudo installdir/ctlscript.sh restart apache
```
獲取全部服務的當前狀態：
```
installdir/ctlscript.sh status
```

可用服務列表因每一個應用程序所需的組件而異。

注意：若是您使用的是Mac OS X-VM的堆棧管理器，請查看如下博客文章，瞭解如何從其圖形工具管理服務。

Window

Bitnami本機安裝程序包括一個用於管理服務的圖形工具。此工具在Windows上名爲manager-windows.exe,位於安裝目錄中.要使用此工具,請雙擊該文件,而後使用圖形界面啓動,中止或從新啓動服務.能夠在「服務器事件」選項卡中檢查服務器日誌消息.

Windows本機安裝程序建立快捷方式以啓動和中止在「開始」菜單中的「程序 - > Bitnami APPNAME堆棧 - > Bitnami服務」下建立的服務,也能夠從Windows「服務」控制面板管理服務器.使用APPNAMESERVICENAME格式命名服務,其中APPNAME是應用程序名稱的佔位符,SERVICENAME是服務名稱的佔位符.例如,Bitnami WordPress Stack的本機安裝程序安裝名爲wordpressApache和wordpressMySQL的服務.

這些服務將在引導期間自動啓動.要修改此行爲,請參閱有關在Windows上禁用服務的部分.

如何訪問管理面板？

經過瀏覽到http://localhost/admin訪問管理面板。

如何直接從Redmine應用程序或Web瀏覽器中查看Subversion存儲庫？

注意：Bitnami Redmine Stack的Windows安裝程序再也不包含Subversion.此堆棧的Linux和Mac OS X安裝程序繼續像之前同樣包含Subversion.

Redmine容許用戶檢查存儲庫更改並連接到案例.只需在項目的「設置 - >存儲庫」選項卡中配置「存儲庫URL」便可.

SCM: Subversion
URL: http://your_repository
Login: repository_login
Password: repository_password

如何配置Redmine以與Subversion進行高級集成？

在開始本指南以前,請考慮到在Redmine應用程序中查看存儲庫更改不是必需的.若是您只想查看存儲庫更改並連接到問題,則只需配置項目存儲庫：「項目 - >設置 - >存儲庫 - > URL和控制版本系統」.

此Redmine配置用於自動存儲庫建立和權限管理。從v1.1.3-1開始，Redmine Stack爲此配置提供了全部必需的模塊。本指南已更新，可與Redmine 2.1.4配合使用。

按着這些次序：

確保在Apache配置文件（httpd.conf）中啓用了mod_dav模塊。應在下一步中提到的模塊以前加載此模塊。
```
LoadModule dav_module modules/mod_dav.so
```

在Apache配置文件中添加如下行：

LoadModule dav_svn_module modules/mod_dav_svn.so
 LoadModule perl_module modules/mod_perl.so

您還須要將以下行添加到installdir/apache2/bin/envvars文件中（路徑可能會根據版本而更改）：

LD_LIBRARY_PATH="installdir/perl/lib/5.16.3/x86_64-linux-thread-multi/CORE/:$LD_LIBRARY_PATH"
 export LD_LIBRARY_PATH

將Redmine.pm文件複製到Perl modules文件夾中：

cp installdir/apps/redmine/htdocs/extra/svn/Redmine.pm installdir/perl/lib/site_perl/5.8.8/*/Apache2/

爲存儲庫建立目錄，例如：

mkdir installdir/repository
mkdir installdir/repository/svn
chown root:daemon installdir/repository/ [or "your_user:your_user" if you installed the Stack without root privileges]
chown root:daemon installdir/repository/svn/ [or "your_user:your_user" if you installed the Stack without root privileges]
chmod 0755 installdir/repository
chmod 0750 installdir/repository/svn

將這些行添加到installdir/apps/redmine/conf/httpd-app.conf文件中：

PerlLoadModule Apache2::Redmine
 <Location /svn>
   DAV svn
   SVNParentPath "installdir/repository/svn"
   Order deny,allow
   Deny from all
   Satisfy any

   PerlAccessHandler Apache::Authn::Redmine::access_handler
   PerlAuthenHandler Apache::Authn::Redmine::authen_handler
   AuthType Basic
   AuthName "Redmine SVN Repository"

   #read-only access
   <Limit GET PROPFIND OPTIONS REPORT>
      Require valid-user
      Allow from all
      # Allow from another-ip
      Satisfy any
   </Limit>
   # write access
   <LimitExcept GET PROPFIND OPTIONS REPORT>
     Require valid-user
   </LimitExcept>

   ## for mysql
   RedmineDSN "DBI:mysql:database=bitnami_redmine;host=localhost;mysql_socket=installdir/mysql/tmp/mysql.sock" 

   RedmineDbUser "bitnami"
   RedmineDbPass "bitnami_database_password"
   #You can find this value at installdir/apps/redmine/htdocs/config/database.yml
 </Location>

重啓服務器：

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）.
```
sudo installdir/ctlscript.sh restart apache
```
以管理員身份登陸Redmine應用程序,而後導航到「設置 - >存儲庫 - >啓用WS以進行存儲庫管理」.
單擊「生成密鑰」並保存密鑰.

在crontab中添加如下行.您可使用命令crontab -e編輯crontab：

*/2 * * * * installdir/ruby/bin/ruby installdir/apps/redmine/htdocs/extra/svn/reposman.rb --redmine localhost:YOUR_APACHE_PORT/redmine --svn-dir installdir/repository/svn --owner root --group daemon --command="installdir/subversion/bin/svnadmin create --pre-1.6-compatible --fs-type fsfs" --url http://localhost:YOUR_APACHE_PORT/svn --key="YOUR_API_KEY" --verbose >> /var/log/reposman.log

若是已將Redmine配置爲經過SSL進行訪問，則能夠在先前的crontab行中指定--redmine http://127.0.0.1:3001/redmine。

檢查一切是否正常，從Redmine應用程序建立項目並檢查/var/log/reposman.log文件。

感謝Jedbifa在Bitnami論壇上發佈了完整的指南.

如何配置出站電子郵件設置？

能夠在installdir/apps/redmine/htdocs/config/configuration.yml文件中配置電子郵件設置.在舊版本中,使用installdir/apps/redmine/htdocs/config/email.yml文件.

該文件包含大多數常見方案的示例配置設置,包括Gmail.要將Gmail用做SMTP服務器,請查找並取消註釋Gmail設置,以便最終獲得如下結果.請務必使用您計劃使用的Gmail賬戶的正確憑據更新user_name和密碼變量.

# ==== SMTP server at using TLS (GMail)
# This might require some additional configuration. See the guides at:
# http://www.redmine.org/projects/redmine/wiki/EmailConfiguration
#
email_delivery:
  delivery_method: :smtp
  smtp_settings:
    enable_starttls_auto: true
    address: "smtp.gmail.com"
    port: 587
    domain: "smtp.gmail.com" # 'your.domain.com' for Google Apps
    authentication: :plain
    user_name: "USERNAME@gmail.com"
    password: "PASSWORD"

修改配置文件後，請按照這些說明從新啓動服務。

要更改電子郵件中顯示的連接,請導航至「管理 - >設置 - >常規 - >主機名稱和路徑」部分,而後輸入您的域名和端口.

有關此Redmine wiki頁面和此Redmine博客文章的更多信息.

排除郵件配置問題

若是您收到包含「530 5.7.0必須首先發出STARTTLS命令...」的錯誤消息，請確保在密碼行後面設置了enable_starttls_auto屬性。例如：

email_delivery:
   delivery_method: :smtp
   smtp_settings:
     enable_starttls_auto: true
     address: "smtp.gmail.com"
     port: 587
     domain: "smtp.gmail.com" # 'your.domain.com' for GoogleApps
     authentication: :plain
     user_name: "USERNAME@gmail.com"
     password: "PASSWORD"

在Redmine 2.0或更高版本中,若是您看到相似於「發送郵件時發生錯誤（SSL_connect返回= 1 errno = 0狀態= SSLv2 / v3讀取服務器問候A：未知協議）」的錯誤,請從中刪除tls:true選項該configuration.yml文件.而後,從新啓動服務.
若是使用不須要身份驗證的SMTP服務器,則可能須要在configuration.yml文件中添加openssl_verify_mode:'none'選項.

要將應用程序配置爲使用其餘第三方SMTP服務來發送電子郵件,例如SendGrid或Mandrill,請參閱常見問題解答.

注意：若是您使用Gmail做爲出站電子郵件服務器而且在嘗試正確發送電子郵件時遇到問題，請查看如何解決Gmail SMTP問題，以瞭解這些問題的緣由以及解決方法。

如何在Redmine上安裝插件？

在安裝插件以前,請確保該插件與您的Redmine版本兼容.對於Redmine插件目錄中的插件,請檢查每一個插件的「兼容:」字段.

經過執行installdir/use_redmine腳本（Linux和Mac OS X）或單擊「開始 - > Bitnami Redmine堆棧 - >應用程序控制臺」（Windows）下的「開始」菜單中的快捷方式加載Bitnami堆棧環境。瞭解更多。
下載插件並將其複製到installdir/apps/redmine/htdocs/plugins.

若是插件須要遷移,請運行如下命令來升級數據庫.建議在運行這些命令以前備份數據庫.

cd installdir/apps/redmine/htdocs/
bundle install --without development test postgresql sqlite
ruby bin/rake redmine:plugins RAILS_ENV=production

使用這些說明重啓Redmine.

將插件複製到installdir/apps/redmine/htdocs/plugins目錄後,運行如下命令:

cd installdir/apps/redmine/htdocs/
bundle install --without development test postgresql sqlite --no-deployment
bundle install --without development test postgresql sqlite --deployment
ruby bin/rake redmine:plugins RAILS_ENV=production

使用這些說明重啓Redmine.

插件安裝疑難解答

若是你在Redmine 2.4.0-0中收到這樣的錯誤而且更好:

You are trying to install in deployment mode after changing your Gemfile. Run 'bundle install' elsewhere and add the updated Gemfile.lock to version control.

嘗試按照錯誤消息中的建議將--no-deployment參數添加到bundle install命令.

若是您使用適用於Windows的Bitnami Redmine安裝程序，而且您的瘦服務器在安裝插件後未運行，請手動運行它們以瞭解錯誤：
- 轉到Bitnami Redmine控制檯：「開始 - >程序文件 - > Bitnami Redmine堆棧 - >使用Redmine」
- 轉到apps/redmine/htdocs.
- 運行如下命令:
```
bundle exec thin start -e production -p 3001 --prefix /redmine
```
如今，您能夠在啓動服務器或經過Web瀏覽器訪問應用程序時看到錯誤，網址爲http://127.0.0.1:3001/redmine。

如何安裝Redmine Agile插件？

手動安裝Redmine Agile插件（須要免費註冊）.強烈建議先建立備份.備份完成後,請按照下列步驟操做:

將.zip文件保存在installdir/apps/redmine/htdocs/plugins目錄中.在解壓縮插件以前,請確保您在該目錄中:
```
cd installdir/apps/redmine/htdocs/plugins
```
解壓縮Agile插件文件（VERSION-EDITION是佔位符.您的文件應包含已下載的版本和所選版本）:
```
unzip redmine_agile_VERSION-EDITION.zip
```
刪除「.zip」文件:
```
rm redmine_agile_VERSION_EDITION.zip
```

切換到htdocs目錄並安裝所需的gem:

cd installdir/apps/redmine/htdocs/
bundle install --without development test postgresql sqlite --no-deployment
bundle install --without development test postgresql sqlite --deployment

安裝和遷移Redmine Agile數據庫:

bundle exec rake redmine:plugins RAILS_ENV=production
bundle exec rake redmine:plugins NAME=redmine_agile RAILS_ENV=production

注意:它可能會顯示有關日誌生成文件的警告消息.在這種狀況下,請運行如下命令:

注意:若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）.
sudo chown :bitnami log/production.log
sudo chmod g+w log/production.log

從新啓動服務以使更改生效:

注意:若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）.
```
sudo installdir/ctlscript.sh restart
```
登陸到Redmine安裝並導航到「管理 - >敏捷」部分以配置新插件。
導航到「項目 - >項目 - >設置 - >模塊」菜單以在項目中啓用Agile插件。

如何安裝Redmine Custom Workflows插件？

在安裝Redmine Custom Workflows插件以前，請建立一個備份.備份完成後,請按照下列步驟操做:

切換到Redmine插件目錄並獲取最新的自定義工做流程版本:

cd installdir/apps/redmine/htdocs/plugins
git clone http://github.com/anteo/redmine_custom_workflows.git

安裝插件:

cd installdir/apps/redmine/htdocs/
bundle exec rake redmine:plugins:migrate RAILS_ENV=production

注意：它可能會顯示有關日誌生成文件的警告消息.在這種狀況下,請運行如下命令:

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）。
sudo chown :bitnami log/production.log
sudo chmod g+w log/production.log

從新啓動服務以使更改生效:

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）.
```
sudo installdir/ctlscript.sh restart
```
登陸到Redmine安裝並導航到「管理 - >自定義工做流」部分以配置新插件.

如何建立Redmine的完整備份？

Bitnami Redmine堆棧是自包含的,執行備份的最簡單選項是複製或壓縮Bitnami堆棧安裝目錄,要以安全的方式執行此操做,您須要中止全部服務器,所以若是您有人連續訪問應用程序,則此方法可能不合適.

注意：若是您只想建立數據庫備份，請參閱MySQL和PostgreSQL的這些說明。

在Linux和Mac OS X上備份

按着這些次序：

切換到要保存備份的目錄.
```
cd /your/directory
```
中止全部服務器.

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前.請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh stop
```
使用堆棧內容建立壓縮文件.

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo tar -pczvf application-backup.tar.gz installdir
```
啓動全部服務器。

注意：若是以root身份安裝堆棧，則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）.
```
sudo installdir/ctlscript.sh start
```
將application-backup.tar.gz文件下載或傳輸到安全位置.

您如今應該將application-backup.tar.gz文件下載或傳輸到安全位置.

在Windows上備份

按着這些次序:

使用「開始」菜單或圖形管理器工具中的快捷方式中止全部服務器.
使用堆棧內容建立壓縮文件.您可使用7-Zip或WinZip等圖形工具,或者右鍵單擊文件夾,單擊「發送到」,而後選擇「壓縮（壓縮）文件夾」選項.
將壓縮文件下載或傳輸到安全位置.
使用「開始」菜單或圖形管理器工具中的快捷方式啓動全部服務器.

在Linux和Mac OS X上還原

按着這些次序：

切換到包含備份的目錄:
```
cd /your/directory
```
中止全部服務器.

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh stop
```
將當前堆棧移動到其餘位置:

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）。
```
sudo mv installdir /tmp/bitnami-backup
```
將備份文件解壓縮到原始目錄:

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）。
```
sudo tar -pxzvf application-backup.tar.gz -C /
```
啓動全部服務器.

注意：若是以root身份安裝堆棧,則僅使用sudo.在運行如下命令以前,請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh start
```

重要信息：還原時，請記住保留文件和文件夾的原始權限。例如，若是您最初在Linux上以root用戶身份安裝堆棧，請確保還原的文件也歸root全部。

在Windows上還原

切換到包含備份的目錄：
```
cd /your/directory
```
使用「開始」菜單或圖形管理器工具中的快捷方式中止全部服務器。
執行如下命令卸載之前的服務：
```
serviceinstall.bat
```
在桌面中建立一個名爲Backups的安全文件夾，並將當前堆棧移動到該文件夾。請記住將PATH替換爲文件夾的正確位置：
```
move installdir \PATH\Backups
```
使用7-Zip或Winzip等工具解壓縮備份文件，或者只需雙擊.zip文件解壓縮，而後將其移動到原始目錄。
經過從提高的命令提示符運行如下命令來安裝服務：
```
cd installdir
serviceinstall.bat INSTALL
```
使用「開始」菜單或圖形管理器工具中的快捷方式啓動全部服務器。

如何升級Redmine？

強烈建議您在開始更新過程以前建立備份。若是您有重要數據，建議您建立並嘗試還原備份以確保一切正常。

升級Redmine和全部堆棧組件（推薦）

您能夠按照如下步驟升級應用程序和堆棧組件：

啓動一個新的Redmine服務器。
將數據庫備份複製到新服務器。
中止全部服務器並僅啓動MySQL。

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh stop apache
sudo installdir/ctlscript.sh stop mysql
sudo installdir/ctlscript.sh start mysql
```

刪除之前的數據庫並建立新數據庫。您可使用安全密碼配置數據庫用戶密碼。若是數據庫託管在其餘服務器上，請記住添加-h選項以指定主機名。

mysql -u root -p
Password: ****
mysql> drop database bitnami_redmine;
mysql> create database bitnami_redmine;
mysql> grant all privileges on bitnami_redmine.* to 'bn_redmine'@'localhost' identified by 'DATABASE_PASSWORD';

恢復新數據庫：

mysql -u root -p bitnami_redmine < backup.sql

編輯Redmine配置文件以更新installdir / apps / redmine / htdocs / config / database.yml中的數據庫用戶密碼（與以前設置的密碼相同）。
```
production:
  adapter: mysql2
  database: bitnami_redmine
  host: localhost
  username: bn_redmine
  password: "DATABASE_PASSWORD"
  encoding: utf8
```

將數據庫遷移到最新版本：

cd installdir/apps/redmine/htdocs/
ruby bin/rake db:migrate RAILS_ENV=production

升級故障排除

若是看到如下錯誤，請轉到數據庫並刪除指定的表並再次運行遷移命令。
```
Mysql::Error: Table 'changeset_parents' already exists: CREATE TABLE `changeset_parents` (`changeset_id` int(11) NOT NULL, `parent_id` int(11) NOT NULL) ENGINE=InnoDB
```
運行如下命令：
```
mysql -u root -p 
 mysql> use bitnami_redmine;
 mysql> drop table changeset_parents;
cd installdir/apps/redmine/htdocs/ 
ruby bin/rake db:migrate RAILS_ENV=production
```
而後，將installdir / apps / redmine / htdocs / files目錄從舊安裝複製到新安裝。若是你已經在之前的版本安裝的插件，複製從目錄提供商/插件目錄複製到新的安裝面積，在插件目錄中。檢查插件是否與新版本兼容，而後運行如下命令：
```
ruby bin/rake redmine:plugins RAILS_ENV="production"
```
清理緩存和會話。
```
ruby bin/rake tmp:cache:clear
ruby bin/rake tmp:sessions:clear
```
重啓服務器。

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart
```
若是從1.x版本升級，您會看到相似於此錯誤的內容：
```
MysqlStatement::Error Value for field `value` cannot be NULL INSERT INTO custom_value ...
```
轉到管理面板中的自定義值，再次編輯並保存它們以解決問題。

如何建立SSL證書？

須要OpenSSL才能建立SSL證書。而後能夠將證書請求發送到證書頒發機構（CA）以使其簽名爲證書，或者若是您擁有本身的證書頒發機構，則能夠自行簽名，或者您可使用自簽名證書（由於您只是想要測試證書，或者由於您正在設置本身的CA）。

按照如下步驟操做您的平臺。

Linux和Mac OS X.

注意：OpenSSL一般已安裝在Linux和Mac OS X上。若是未安裝，請使用操做系統的軟件包管理器手動安裝。

請按照如下步驟操做：

生成新的私鑰：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo openssl genrsa -out installdir/apache2/conf/server.key 2048
```
建立證書：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo openssl req -new -key installdir/apache2/conf/server.key -out installdir/apache2/conf/cert.csr
```
重要信息：當上述命令要求輸入「公用名」時，請輸入服務器域名。
將cert.csr發送到證書頒發機構。當證書頒發機構完成檢查（並可能收到您的付款）時，他們會將您的新證書交給您。
在收到證書以前，請建立一個臨時自簽名證書：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo openssl x509 -in installdir/apache2/conf/cert.csr -out installdir/apache2/conf/server.crt -req -signkey installdir/apache2/conf/server.key -days 365
```
生成受密碼保護的版本後，將您的私鑰備份到安全位置，以下所示：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo openssl rsa -des3 -in installdir/apache2/conf/server.key -out privkey.pem
```
請注意，若是在Apache配置文件中使用此加密密鑰，則每次Apache啓動時都須要手動輸入密碼。從該文件從新生成沒有密碼保護的密鑰，以下所示：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo openssl rsa -in privkey.pem -out installdir/apache2/conf/server.key
```

視窗

注意：Windows上一般不安裝OpenSSL。在執行如下步驟以前，請下載並安裝OpenSSL的二進制分發版。

安裝OpenSSL後，請按照如下步驟操做：

將OPENSSL_CONF環境變量設置爲OpenSSL配置文件的位置。一般，此文件位於OpenSSL安裝目錄的bin /子目錄中。使用正確的位置替換下面命令中的OPENSSL-DIRECTORY佔位符。
```
set OPENSSL_CONF=C:\OPENSSL-DIRECTORY\bin\openssl.cfg
```
切換到OpenSSL安裝目錄的bin /子目錄。使用正確的位置替換下面命令中的OPENSSL-DIRECTORY佔位符。
```
cd C:\OPENSSL-DIRECTORY\bin
```

生成新的私鑰：

openssl genrsa -out installdir/apache2/conf/server.key 2048

建立證書：
```
openssl req -new -key installdir/apache2/conf/server.key -out installdir/apache2/conf/cert.csr
```
重要信息：當上述命令要求輸入「公用名」時，請輸入服務器域名。
將cert.csr發送到證書頒發機構。當證書頒發機構完成檢查（並可能收到您的付款）時，他們會將您的新證書交給您。

在收到證書以前，請建立一個臨時自簽名證書：

openssl x509 -in installdir/apache2/conf/cert.csr -out installdir/apache2/conf/server.crt -req -signkey installdir/apache2/conf/server.key -days 365

生成受密碼保護的版本後，將您的私鑰備份到安全位置，以下所示：
```
openssl rsa -des3 -in installdir/apache2/conf/server.key -out privkey.pem
```
請注意，若是在Apache配置文件中使用此加密密鑰，則每次Apache啓動時都須要手動輸入密碼。從該文件從新生成沒有密碼保護的密鑰，以下所示：
```
openssl rsa -in privkey.pem -out installdir/apache2/conf/server.key
```

有關證書的更多信息，請訪問http://www.openssl.org。

如何使用SSL證書啓用HTTPS支持？

提示：若是您但願使用Let的加密證書，您能夠在咱們的Let's Encrypt指南中找到使用Let的加密SSL證書啓用HTTPS支持的具體說明。

注意：如下步驟假定您使用的是自定義域名，而且您已將自定義域名配置爲指向雲服務器。

Bitnami圖像已經預先配置了SSL支持而且具備僞證書。雖然此僞證書適用於測試和開發目的，但您一般須要使用有效的SSL證書進行生產。您能夠本身生成（在此處說明），也能夠從商業證書頒發機構購買。

獲取證書和證書密鑰文件後，您須要更新服務器以使用它們。請按照如下步驟激活SSL支持：

使用下表肯定證書和配置文件的正確位置。

變量	值
當前應用程序URL	HTTPS：// [定製域] /
	示例：https：//my-domain.com/或https://my-domain.com/appname
Apache配置文件	INSTALLDIR / apache2的/ conf目錄/ bitnami / bitnami.conf
證書文件	INSTALLDIR / apache2的/ CONF / server.crt這
證書密鑰文件	INSTALLDIR / apache2的/ CONF / server.key
CA證書包文件（若是存在）	INSTALLDIR / apache2的/ conf目錄/服務器ca.crt

將SSL證書和證書密鑰文件複製到指定位置。

注意：若是對證書和密鑰文件使用不一樣的名稱，則應在相應的Apache配置文件中從新配置SSLCertificateFile和SSLCertificateKeyFile指令以反映正確的文件名。

若是您的證書頒發機構還爲您提供了PEM編碼的證書頒發機構（CA）捆綁包，則必須將其複製到上一個表中的正確位置。而後，修改Apache配置文件以包含SSLCertificateKeyFile指令下面的如下行。根據您的方案和Apache版本選擇正確的指令：

變量	值
Apache配置文件	INSTALLDIR / apache2的/ conf目錄/ bitnami / bitnami.conf
指令包括（Apache v2.4.8 +）	SSLCACertificateFile「installdir / apache2 / conf / server-ca.crt」
包含的指令（Apache <v2.4.8）	SSLCertificateChainFile「installdir / apache2 / conf / server-ca.crt」

注意：若是爲CA證書捆綁包使用其餘名稱，則應在相應的Apache配置文件中從新配置SSLCertificateChainFile或SSLCACertificateFile指令以反映正確的文件名。

複製完全部服務器證書文件後，只能使用如下命令使root用戶能夠讀取它們：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo chown root:root installdir/apache2/conf/server*
sudo chmod 600 installdir/apache2/conf/server*
```
在服務器防火牆中打開端口443。有關更多信息，請參閱常見問題。
從新啓動Apache服務器。

您如今應該可使用HTTPS URL訪問您的應用程序。

如何使用Apache強制進行HTTPS重定向？

在defaultldir / apache2 / conf / bitnami / bitnami.conf中的默認Apache虛擬主機配置文件中，在默認的VirtualHost指令中添加如下行，使其以下所示：

<VirtualHost _default_:80>
  DocumentRoot "installdir/apache2/htdocs"
  RewriteEngine On
  RewriteCond %{HTTPS} !=on
  RewriteRule ^/(.*) https://%{SERVER_NAME}/$1 [R,L]
  ...
</VirtualHost>

修改Apache配置文件後：

在服務器防火牆中打開端口443。有關更多信息，請參閱常見問題。
從新啓動Apache以應用更改。

如何調試Apache錯誤？

一旦Apache啓動，它將分別在installdir / apache2 / logs / access_log和installdir / apache2 / logs / error_log建立兩個日誌文件。

該訪問日誌文件是用來跟蹤客戶端請求。當客戶端從服務器請求文檔時，Apache會在此文件中記錄與請求關聯的多個參數，例如：客戶端的IP地址，請求的文檔，HTTP狀態代碼和當前時間。
在error_log中文件是用來記錄重要事件。此文件包含錯誤消息，啓動消息以及服務器生命週期中的任何其餘重要事件。當您在使用Apache時遇到問題時，這是第一個查看的地方。

若是未找到錯誤，您將看到相似於如下內容的消息：

Syntax OK

如何查找MySQL數據庫憑據？

數據庫用戶名：root。
數據庫密碼：與應用程序密碼相同。瞭解如何獲取應用程序憑據。

如何鏈接MySQL數據庫？

您可使用mysql客戶端工具從安裝它的同一臺計算機鏈接到MySQL數據庫。

mysql -u root -p

系統將提示您輸入root用戶密碼。這與應用程序密碼相同。

如何調試數據庫中的錯誤？

主日誌文件在MySQL數據庫服務器主機上的installdir / mysql / data / mysqld.log中建立。

如何更改MySQL Root密碼？

您能夠在shell提示符下使用如下命令修改MySQL密碼。將NEW_PASSWORD佔位符替換爲您要設置的實際密碼。

installdir/mysql/bin/mysqladmin -p -u root password NEW_PASSWORD

如何重置MySQL Root密碼？

若是您不記得MySQL root密碼，能夠按照如下步驟將其重置爲新值：

使用下面顯示的內容在/ home / bitnami / mysql-init中建立一個文件（將NEW_PASSWORD替換爲您要使用的密碼）：
```
UPDATE mysql.user SET Password=PASSWORD('NEW_PASSWORD') WHERE User='root';
 FLUSH PRIVILEGES;
```
若是您的堆棧是MySQL v5.7.x，請使用如下內容而不是上面顯示的內容：
```
UPDATE mysql.user SET authentication_string=PASSWORD('NEW_PASSWORD') WHERE User='root';
 FLUSH PRIVILEGES;
```
提示：使用命令installdir / mysql / bin / mysqladmin --version或installdir / mysql / bin / mysqld --version檢查MySQL版本。
中止MySQL服務器：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh stop mysql
```
使用如下命令啓動MySQL：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/mysql/bin/mysqld_safe --pid-file=installdir/mysql/data/mysqld.pid --datadir=installdir/mysql/data --init-file=/home/bitnami/mysql-init 2> /dev/null &
```
重啓MySQL服務器：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart mysql
```
刪除腳本：
```
rm /home/bitnami/mysql-init
```

如何在Windows中更改MySQL Root密碼？

您能夠在shell提示符下使用如下命令修改MySQL密碼。將NEW_PASSWORD佔位符替換爲您要設置的實際密碼。

installdir\mysql\bin\mysqladmin.exe -p -u root password NEW_PASSWORD

如何在Windows中重置MySQL Root密碼？

若是您不記得MySQL root密碼，能夠按照如下步驟將其重置爲新值：

使用圖形管理器工具中止MySQL服務器。請參閱如何啓動或中止服務部分。
檢查MySQL版本：

installdir \ mysql \ bin \ mysqladmin.exe -version
根據您的MySQL版本建立一個名爲mysql-init.txt的文件，其內容以下所示（將NEW_PASSWORD替換爲您要使用的密碼）：
- MySQL 5.6.x或更早版本：
```
UPDATE mysql.user SET Password=PASSWORD('NEW_PASSWORD') 
 WHERE User='root';
 FLUSH PRIVILEGES;
```
- MySQL 5.7.x或更高版本：
```
ALTER USER 'root'@'localhost' IDENTIFIED BY 'NEW_PASSWORD';
```
使用如下命令啓動MySQL服務器。請記住將PATH替換爲保存mysql-init.txt文件的位置：
```
installdir " installdir\mysql\bin\mysqld.exe" --defaults-file=" installdir\mysql\my.ini" --init-file="\PATH\mysql-init.txt" --console
```
- 該--init文件選項用於執行的內容所使用的服務器的mysql-init.txt在啓動文件，它會改變每一根賬戶密碼。
- 該--defaults文件選項指定既然你已經使用Bitnami安裝程序安裝了MySQL。
- 該--console選項（選裝），以顯示在控制檯窗口，而不是在日誌文件服務器輸出被添加。
幾分鐘後，按Ctrl-C強制關機。
從圖形管理器工具從新啓動MySQL服務器。
服務器成功重啓後，刪除mysql-init.txt文件。

如何訪問PhpMyAdmin？

Windows，Linux，Mac OS X.

您應該能夠經過瀏覽到http://127.0.0.1/phpmyadmin直接訪問phpMyAdmin 。

用戶名是phpMyAdmin的root，密碼是您在安裝過程當中指定的密碼。

Mac OS X-VM

要使用Mac OS X-VM訪問phpMyAdmin，您須要建立SSH隧道，以下所述：

在圖形管理器工具上，選擇「網絡」選項卡。
單擊「啓用」。這會自動建立轉發到端口8080的SSH隧道。

您應該能夠經過瀏覽到http://127.0.0.1:8080/phpmyadmin直接訪問phpMyAdmin 。

輸入如下憑據以訪問phpMyAdmin：
- 用戶名：root
- 密碼：bitnami1

如何修改Apache的PHP設置？

PHP配置文件容許您配置啓用的模塊，電子郵件設置或上載文件的大小。它位於installdir / php / etc / php.ini。

例如，要修改PHP的默認上載限制，請按照這些說明更新PHP配置文件。

修改PHP配置文件後，從新啓動Apache和PHP-FPM以使更改生效：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

sudo installdir/ctlscript.sh restart apache
sudo installdir/ctlscript.sh restart php-fpm

如何在Apache中修改上傳文件的容許限制？

修改installdir / php / etc / php.ini文件中的如下選項以增長上傳的容許大小：

; Maximum size of POST data that PHP will accept.
post_max_size = 16M

; Maximum allowed size for uploaded files.
upload_max_filesize = 16M

從新啓動PHP-FPM和Apache以使更改生效。

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

sudo installdir/ctlscript.sh restart apache
sudo installdir/ctlscript.sh restart php-fpm

如何配置Fail2ban以使用Redmine？

若是要限制登陸嘗試次數（並避免暴力攻擊），請安裝fail2ban並將其配置爲使用Bitnami Redmine Stack。

安裝fail2ban：
- Debian的：
  
  注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo apt-get update
sudo apt-get install fail2ban
```
- CentOS的：
  
  注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo yum install epel-release
sudo yum install fail2ban
sudo systemctl enable fail2ban
sudo systemctl start fail2ban
```
修改installdir / apps / redmine / htdocs / config / environment.rb文件以容許Redmine記錄器將時間戳添加到production.log文件。爲此，請添加如下行：
```
class Logger
  def format_message(severity, timestamp, progname, msg)
    "#{timestamp} (#{$$}) #{msg}\n"
  end
end
```
從新啓動Apache服務器。

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart apache
```

接下來，按照如下步驟配置fail2ban：

使用如下代碼建立/etc/fail2ban/filter.d/redmine.conf文件：

[Definition]

failregex = Failed [-/\w]+ for .* from <HOST>
ignoreregex =

建立/etc/fail2ban/jail.local文件並添加如下代碼：
```
[redmine]
enabled = true
filter = redmine
port = http,https
logpath = installdir/apps/redmine/htdocs/log/production.log
maxretry = 5
findtime = 600
bantime = 600
```
此fail2ban配置將禁止嘗試在10分鐘（查找時間）內訪問五個（maxretry）不一樣時間的任何用戶的IP，但不會成功。請注意，禁令僅影響端口80和443，具備禁用IP的用戶將沒法在10分鐘內聯繫Web服務器（bantime）。
在應用配置以前，請測試正則表達式配置是否正確。要對此進行測試，請瀏覽到您的Bitnami Redmine登陸頁面並使用不存在的用戶/密碼來獲取登陸錯誤。而後，運行如下命令：
```
fail2ban-regex installdir/apps/redmine/htdocs/log/production.log /etc/fail2ban/filter.d/redmine.conf
```
若是輸出的最後兩行顯示至少「1匹配」，則正確配置正則表達式：
```
Lines: 412 lines, 0 ignored, 1 matched, 397 missed
Missed line(s):: too many to print.  Use --print-all-missed to print all 397 lines
```
使用此命令應用配置
- Debian的：
  
  $ sudo /etc/init.d/fail2ban restart
- CentOS的：
  
  $ sudo systemctl restart fail2ban

要檢查一切是否正常，請嘗試使用錯誤的憑據登陸五次。在第五次嘗試不成功時，您將被禁止10分鐘。

如何將傳入的電子郵件轉換爲Redmine中的問題？

Redmine能夠配置爲自動處理傳入的電子郵件並將其轉換爲問題。爲此，須要將Redmine配置爲按期鏈接到IMAP或POP3賬戶，檢查傳入消息並將包含Redmine關鍵字的消息轉換爲問題。

爲此，請建立一個計劃任務，並在crontab文件中使用如下命令獲取POP3賬戶，並記住使用您的郵件提供商的正確信息替換HOST，PORT，USERNAME和PASSWORD：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

*/30 * * * * sudo bundle exec rake -f installdir/apps/redmine/htdocs/Rakefile redmine:email:receive_pop3 RAILS_ENV="production" host=HOST port=PORT ssl=1 username=USERNAME password=PASSWORD allow_override=project,tracker,priority

在crontab文件中使用如下命令獲取IMAP賬戶，記住使用正確的郵件提供者信息替換HOST，PORT，USERNAME和PASSWORD：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

*/30 * * * * sudo bundle exec rake -f installdir/apps/redmine/htdocs/Rakefile redmine:email:receive_imap RAILS_ENV="production" host=HOST port=PORT ssl=1 username=USERNAME password=PASSWORD allow_override=project,tracker,priority

注意：若是您的郵件提供商不支持SSL，請從先前的命令中刪除ssl選項。

以上命令將每30分鐘處理一次收到的電子郵件。

要容許未在Redmine中註冊的用戶經過電子郵件建立問題，請更新上面的命令以添加unknown_user和no_permission_check選項。例如：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

*/30 * * * * sudo bundle exec rake -f installdir/apps/redmine/htdocs/Rakefile redmine:email:receive_pop3 RAILS_ENV="production" host=HOST port=PORT ssl=1 username=USERNAME password=PASSWORD allow_override=project,tracker,priority unknown_user=accept no_permission_check=1

要自動爲特定項目和優先級註冊新問題，請刪除allow_override選項，而是指定項目和優先級選項。例如：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

*/30 * * * * sudo bundle exec rake -f installdir/apps/redmine/htdocs/Rakefile redmine:email:receive_pop3 RAILS_ENV="production" host=HOST port=PORT ssl=1 username=USERNAME password=PASSWORD project=myproject priority=immediate

有關可用選項的更多信息，請參閱Redmine文檔。

如何在Redmine中配置計劃任務？

要在Redmine中自動執行某些任務，必須設置計劃任務/計算機做業。

按着這些次序：

運行如下命令以編輯crontab文件：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo crontab -e
```
將如下行添加到該文件中。這將配置天天00:30執行的做業。您能夠根據須要修改時間，而且必須將COMMAND佔位符替換爲要執行的命令。
```
0 30 * * * COMMAND
```
保存文件。

如何配置Redmine發送提醒電子郵件？

要讓Redmine自動發送提醒電子郵件，請按照上一節中的說明建立計劃任務。在crontab文件中使用如下命令：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

0 30 * * * sudo installdir/ruby/bin/rake -f installdir/apps/redmine/htdocs/Rakefile redmine:send_reminders days=7 RAILS_ENV="production"

如何改變Redmine時區？

經過執行如下命令檢查全部可用的時區：

cd installdir/apps/redmine/htdocs/ 
bundle exec rake time:zones:all

肯定正確的文件後，編輯文件installdir / apps / redmine / htdocs / config / application.rb並替換該行
```
config.active_record.default_timezone = :local
```
同
```
config.active_record.default_timezone = 'your_timezone'
```
請注意，時區值附近的單引號是必要的。
重啓服務。

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart apache
```

如何在Windows上爲Redmine啓用SSL證書的HTTPS支持？

除了本節中描述的步驟以外，在Windows上使用本機安裝程序時，將RequestHeader選項添加到installdir / apps / redmine / conf / httpd-prefix.conf文件中：

<Proxy balancer://redminecluster
      RequestHeader set X_FORWARDED_PROTO 'https'
      BalancerMember http://127.0.0.1:3001/redmine
      BalancerMember http://127.0.0.1:3002/redmine
    </Proxy>

從新啓動Apache服務器以使更改生效：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

sudo installdir/ctlscript.sh restart apache

如何查找數據庫憑據？

Windows，Linux，Mac OS X：
- 數據庫用戶名：root。
- 數據庫密碼：安裝過程當中輸入的密碼。
Mac OS X-VM：
- 數據庫用戶名：root。
- 數據庫密碼：bitnami1

如何修改最大附件大小？

要更改最大附件大小和容許的文件擴展名，請導航到「管理 - >設置 - >文件」菜單選項：

如何直接從Redmine應用程序或Web瀏覽器中查看Git存儲庫？

Redmine容許用戶檢查存儲庫更改並連接到案例。請按照如下步驟操做：

克隆遠程Git存儲庫，或初始化新存儲庫。將REPO_URL佔位符替換爲正確的存儲庫URL，並使用正確的克隆存儲庫目錄名替換REPO佔位符。

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
cd $HOME
mkdir repos
cd repos
sudo git clone REPO_URL --bare
```

注意：不管您是克隆現有存儲庫仍是初始化新存儲庫，都應包括--bare選項。

建立一個新的Redmine項目。
從項目儀表板中，選擇「設置 - >存儲庫」選項卡，而後使用如下設置添加新存儲庫。將ID佔位符替換爲存儲庫的短標識符，帶有用戶名的USER佔位符，以及具備克隆存儲庫的正確目錄名稱的REPO佔位符。
```
SCM: Git
 Identifier: ID
 Path to repository: /home/USER/repos/REPO
```

如何配置Redmine與Git進行高級集成？

此Redmine配置使在Redmine應用程序中建立的用戶也可使用Git存儲庫。例如，Redmine應用程序中的新用戶也能夠「推送」對Git項目存儲庫的更改。本指南基於Redmine Wiki上發佈的Felix Schafer指南。

在開始本指南以前，若是您只想跟蹤Redmine應用程序中的存儲庫更改，請考慮這些步驟是沒必要要的。若是您只但願跟蹤存儲庫更改並連接到問題，則只需將項目配置爲指向存儲庫。爲此，請轉到項目儀表板，選擇「設置 - >存儲庫」選項卡，而後經過指定其URL和SCM添加新存儲庫。

建立一個Git存儲庫。本指南將在用戶主目錄的projects /目錄下建立一個名爲test的存儲庫。此目錄應具備安裝堆棧的用戶賬戶的寫權限。請注意存儲庫的名稱，由於您須要在稍後的步驟中使用與Redmine項目的標識符相同的名稱。

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
cd $HOME
mkdir projects
mkdir projects/test
cd projects/test
sudo git init --bare
```
從GitHub下載Grack項目：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
cd installdir/apache2/htdocs/
git clone http://github.com/schacon/grack.git
sudo chown USERNAME:USERNAME grack
```

編輯grack / config.ru文件以指定您的Git項目位置：

$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__) + '/lib')
 use Rack::ShowExceptions
 require 'git_http'
 config = {
   :project_root => "installdir/projects/",
   :adapter => Grack::GitAdapter,
   :git_path => 'installdir/git/bin/git',
   :upload_pack => true,
   :receive_pack => true,
 }
 run GitHttp::App.new(config)

測試基本行爲：啓動Grack服務器並嘗試克隆存儲庫並從其餘計算機推送更改。

cd installdir/apache2/htdocs/grack
rackup --host 0.0.0.0 -p 8080 config.ru &

若是一切順利，您應該看到瘦Web服務器正在運行並偵聽鏈接的消息，以下所示：

>> Thin web server (v1.5.1 codename Straight Razor)
 >> Maximum connections set to 1024
 >> Listening on 0.0.0.0:8080, CTRL+C to stop

重要信息：還要確保防火牆中的端口8080已打開，不然下一步將失敗。

接下來，克隆存儲庫，添加您的名稱和電子郵件地址，並從其餘計算機推送更改。請記住將下面的localhost佔位符替換爲Redmine服務器的實際IP地址，並將EMAIL_ADDRESS和NAME佔位符替換爲您的電子郵件地址和真實姓名。
```
cd /tmp/
git clone http://localhost:8080/test
cd test
git config user.email "EMAIL_ADDRESS"
git config user.name "NAME"
echo "test" > test_file
git add test_file
git commit -m "test" test_file
git push origin master
```

若是一切順利，你會看到這樣的事情：

Counting objects: 3, done.
    Writing objects: 100% (3/3), 200 bytes, done.
    Total 3 (delta 0), reused 0 (delta 0)
    To http://localhost:8080/test
    * [new branch]      master -> master

中止Grack服務器並配置Apache以使用Passenger。首先，在grack /文件夾中建立兩個目錄並安裝必要的依賴項：

mkdir installdir/apache2/htdocs/grack/public
mkdir installdir/apache2/htdocs/grack/tmp
cd installdir/apache2/htdocs/grack/
bundle install

編輯installdir / apache2 / conf / bitnami / bitnami.conf文件，並將代碼添加到文件末尾，將YOUR_DOMAIN_NAME替換爲您本身的域名或服務器的域名：

<VirtualHost *:80>
     ServerName git.YOUR_DOMAIN_NAME
     PassengerEnabled on
     PassengerAppRoot "installdir/apache2/htdocs/grack/"   
     DocumentRoot "installdir/apache2/htdocs/grack/public"
     <Directory "installdir/apache2/htdocs/grack/public">
         Options None
         AllowOverride None
         <IfVersion < 2.3 >
         Order allow,deny
         Allow from all
         </IfVersion>
         <IfVersion >= 2.3>
         Require all granted
         </IfVersion>   
     </Directory> 
 </VirtualHost>

重啓Apache服務器以下：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart apache
```
接下來，再次克隆存儲庫，添加您的名稱和電子郵件地址，並從其餘計算機推送更改。請務必使用您本身的域名或服務器的域名替換下面的YOUR_DOMAIN_NAME佔位符，並使用您的電子郵件地址和真實姓名替換EMAIL_ADDRESS和NAME佔位符。
```
cd /tmp/
rm -rf test/
git clone http://git.YOUR_DOMAIN_NAME/test
cd test
git config user.email "EMAIL_ADDRESS"
git config user.name "NAME"
echo "test 2" > test_file_2
git add test_file_2
git commit -m "test 2" test_file_2
git push origin master
```

若是一切順利，你會看到這樣的事情：

Counting objects: 3, done.
    Compressing objects: 100% (2/2), done.
    Writing objects: 100% (2/2), 234 bytes | 0 bytes/s, done.
    Total 2 (delta 0), reused 0 (delta 0)
    To http://git.YOUR_DOMAIN_NAME/test
       328f124..68d1bb4  master -> master

下一步是使用Redmine.pm模塊配置Git訪問控制。首先將Redmine.pm文件複製到相應的Perl文件夾：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。

sudo cp installdir/apps/redmine/htdocs/extra/svn/Redmine.pm installdir/perl/lib/site_perl/5.16.3/x86_64-linux-thread-multi/Apache/
sudo cp installdir/apps/redmine/htdocs/extra/svn/Redmine.pm installdir/perl/lib/site_perl/5.16.3/x86_64-linux-thread-multi/Apache2/

經過添加如下行在installdir / apache2 / conf / httpd.conf中啓用該模塊：
```
LoadModule perl_module modules/mod_perl.so
```

您還須要將以下行添加到installdir / apache2 / bin / envvars文件中。請注意，下面顯示的庫路徑（installdir / perl / lib / 5.16.3 / x86_64-linux-thread-multi / CORE /）因平臺而異，所以最好驗證它是否存在或根據須要進行修改。

LD_LIBRARY_PATH="installdir/perl/lib/5.16.3/x86_64-linux-thread-multi/CORE/:$LD_LIBRARY_PATH"
    export LD_LIBRARY_PATH

最後，在installdir / apache2 / conf / bitnami / bitnami.conf文件中更新之前建立的VirtualHost，以下所示。REDMINE_DB_USERNAME和REDMINE_DB_PASSWORD憑證能夠從installdir / apps / redmine / htdocs / config / database.yml文件中獲取，來自生產數據庫的用戶名和密碼字段：

<VirtualHost *:80>
      ServerName git.YOUR_DOMAIN_NAME
      PassengerEnabled on
      PassengerAppRoot "installdir/apache2/htdocs/grack/"  
      DocumentRoot "installdir/apache2/htdocs/grack/public"
      <Directory "installdir/apache2/htdocs/grack/public">
         Options None
         AllowOverride None
         <IfVersion < 2.3 >
         Order allow,deny
         Allow from all
         </IfVersion>
         <IfVersion >= 2.3>
         Require all granted
         </IfVersion>       
      </Directory>
        
      PerlLoadModule Apache::Redmine
        
      <Location "/">
        AuthType Basic
        AuthName "Redmine git repositories"
        Require valid-user
          
        PerlAccessHandler Apache::Authn::Redmine::access_handler
        PerlAuthenHandler Apache::Authn::Redmine::authen_handler
        RedmineDSN "DBI:mysql:database=bitnami_redmine;host=localhost;mysql_socket=installdir/mysql/tmp/mysql.sock"
        RedmineDbUser "REDMINE_DB_USERNAME"
        RedmineDbPass "REDMINE_DB_PASSWORD"
        RedmineGitSmartHttp yes
      </Location>
 </VirtualHost>

進行此更改後，從新啓動Apache服務器，以下所示：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart apache
```
登陸Redmine並建立一個新項目。請務必注意，此階段配置的項目標識符必須與先前建立的存儲庫名稱匹配。在此示例中，項目標識符是test。還要確保將項目配置爲私有。

請注意，因爲Redmine錯誤，必須將項目配置爲私有才能使此配置正常工做。單擊「建立」以保存更改並建立項目。

從Redmine中的項目儀表板中，單擊「設置 - >存儲庫」選項卡，而後單擊「新建存儲庫」連接。選擇「SCM」做爲「Git」並指定存儲庫的路徑。在此示例中，路徑將是installdir / projects / test。單擊「建立」以保存更改。

從Redmine中的項目儀表板中，單擊「設置 - >成員」選項卡，而後將一個或多個用戶添加到角色爲「Developer」的項目中。保存更改。

添加到存儲庫的用戶如今應該可以使用他們的Redmine應用程序密碼在測試存儲庫中進行開發。要對此進行測試，請嘗試克隆並將更改做爲指定用戶之一推送到存儲庫。若是您成功，您還能夠在Redmine項目的存儲庫視圖中看到更改，以下所示：

如何在Redmine中使用Mercurial？

Redmine僅適用於克隆在本地計算機中的Mercurial存儲庫，如官方指南中所述。

安裝Mercurial包：
- Debian的：
  
  注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo apt-get install mercurial
```
- CentOS的：
  
  注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo yum install mercurial
```
重啓服務：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
sudo installdir/ctlscript.sh restart
```
建立存儲庫目錄，克隆它併爲其提供適當的權限：

注意：若是以root身份安裝堆棧，則僅使用sudo。在運行如下命令以前，請記住加載Bitnami堆棧環境（說明）。
```
cd $HOME
mkdir mercurialRepo
cd mercurialRepo
sudo hg clone REPO_URL
```
經過在項目中導航到「設置 - >存儲庫 - >新存儲庫」菜單，將存儲庫添加到Redmine。將ID佔位符替換爲存儲庫的短標識符，帶有用戶名的USER佔位符，以及具備克隆存儲庫的正確目錄名稱的REPO佔位符。
```
SCM: Mercurial
 Identifier: ID
 Path to repository: /home/USER/mercurialRepo/REPO
```
檢查存儲庫並確認您能夠查看文件，提交，註釋等。

相關標籤/搜索

每日一句

每一个你不满意的现在，都有一个你没有努力的曾经。