Bitnami Redmine安裝程序 --文檔原

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

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

描述

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

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

Bitnami Redmine Stack的第一步

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

系統要求是什麼?

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

如何安裝Bitnami Redmine Stack?

Windows,OS X和Linux安裝程序

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

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

該應用程序將安裝到以下默認目錄:

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

OS X VM

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

我需要什麼證件？

您需要應用程序憑據,包括用戶名和密碼.這些憑據允許您登錄到新的Bitnami應用程序.

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

對於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: "[email protected]"
    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: "[email protected]"
     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
```
檢查存儲庫並確認您可以查看文件，提交，註釋等。

Bitnami Redmine安裝程序 --文檔 原

描述

Bitnami Redmine Stack的第一步

系統要求是什麼?

如何安裝Bitnami Redmine Stack?

我需要什麼證件？

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

什麼是管理員密碼？

如何啓動或停止服務？

Linux的

Mac OS X.

Window

如何訪問管理面板？

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

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

排除郵件配置問題

如何在Redmine上安裝插件？

插件安裝疑難解答

如何安裝Redmine Agile插件？

如何安裝Redmine Custom Workflows插件？

如何創建Redmine的完整備份？

在Linux和Mac OS X上備份

在Windows上備份

在Linux和Mac OS X上還原

在Windows上還原

如何升級Redmine？

升級Redmine和所有堆棧組件（推薦）

升級故障排除

如何創建SSL證書？

Linux和Mac OS X.

視窗

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

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

如何調試Apache錯誤？

如何查找MySQL數據庫憑據？

如何連接MySQL數據庫？

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

如何更改MySQL Root密碼？

如何重置MySQL Root密碼？

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

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

如何訪問PhpMyAdmin？

Windows，Linux，Mac OS X.

Mac OS X-VM

如何修改Apache的PHP設置？

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

如何配置Fail2ban以使用Redmine？

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

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

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

如何改變Redmine時區？

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

如何查找數據庫憑據？

如何修改最大附件大小？

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

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

如何在Redmine中使用Mercurial？

Bitnami Redmine安裝程序 --文檔原