常見問題¶

• 目錄
• 常見問題
  • 安裝和執行 Redmine
    • Redmine 可以和 Rails 2.x.x 一起使用嗎？
    • 當我啟動應用程式時，出現錯誤訊息："in 'gem_original_require': no such file to load -- initializer (LoadError)"
    • 當我啟動應用程式時，出現錯誤訊息："cannot connect to mysql: No such file or directory - /tmp/mysql.sock"
    • 應用程式在長時間閒置後凍結。
    • 為什麼 Redmine 在我希望它在 Apache 中使用 https 連結時使用 http 連結？ (SSL)
    • 我在 Passenger 部署時收到此錯誤訊息：ActionController::RoutingError (No route matches "/index.html" with {:method=>:get})
  • 問題追蹤
    • 我建立了一個新的問題狀態，但我無法使用它，它沒有出現在狀態下拉式清單中。
    • 我建立了一個新的追蹤器，但我無法使用它，它沒有出現在追蹤器下拉式清單中。
    • 「相關問題」是如何運作的？
  • 時間追蹤
    • 「花費時間報告」中的時間計算錯誤。
  • 版本庫
    • 在我點選「版本庫」之前，提交不會顯示在活動中
    • 我無法透過 Redmine 瀏覽我的 svn 版本庫
    • 版本庫統計資訊未顯示
  • Wiki
    • 如何在 Wiki 中建立子頁面（父/子關係）
    • 全域 Wiki
  • 效能
    • 當我建立新問題時，Redmine 會凍結一分鐘。
  • 其他
    • 電子郵件使用錯誤的網址
    • 電子郵件通知無法運作
    • 在日光節約時間切換後，所有時間都偏差 1 小時
    • 文件和檔案有什麼區別？
    • 當我嘗試檢視或比較 PHP 檔案時，出現 404 錯誤
    • 為什麼 Textile 行內樣式無法運作？
    • 沒有 Redmine 管理員帳戶但有 Redmine 資料庫管理員帳戶的情況下遺失重設密碼
    • 使用 FireFox >= 28 時，編輯某些內容（例如版本）後的重新導向不正確

安裝和執行 Redmine¶

Redmine 可以和 Rails 2.x.x 一起使用嗎？¶

請參閱安裝指南中的相容性。

當我啟動應用程式時，出現錯誤訊息："in 'gem_original_require': no such file to load -- initializer (LoadError)"¶

請確認您的機器上已正確安裝Ruby on Rails。

當我啟動應用程式時，出現錯誤訊息："cannot connect to mysql: No such file or directory - /tmp/mysql.sock"¶

您必須在 config/database.yml 中指定通訊端位置。
請參閱 http://dev.rubyonrails.org/ticket/200。

應用程式在長時間閒置後凍結。¶

ruby/mysql 配接器 2.7.3 之前版本存在錯誤，可能導致資料庫連線中斷。請更新您的配接器。
您可以在以下網址查看相關討論串：http://rubyforge.org/forum/message.php?msg_id=25951。

為什麼當我想在 Apache 中使用 https 連結時，Redmine 卻使用 http 連結？ (SSL)¶

當 Apache 將請求發送到後端伺服器（如 mongrel 或 thin）時，就會發生這種情況。Apache 並沒有告訴後端伺服器要使用 https，因此連結產生錯誤。請將以下設定新增至 Apache

RequestHeader set X_FORWARDED_PROTO 'https'

或

RequestHeader set X-Forwarded-Proto 'https'

我在 Passenger 部署中收到以下錯誤訊息：ActionController::RoutingError (No route matches "/index.html" with {:method=>:get})¶

您的 Apache 錯誤地解譯了 (f)cgi 部署所需的 public/.htaccess 檔案。您可以透過完全移除該檔案（因為 Passenger 不需要它）或將以下設定指令插入 Apache 來解決此問題。

AllowOverride None

問題追蹤¶

我建立了一個新的問題狀態，但我無法使用它，它沒有出現在狀態下拉式選單中。¶

建立新的問題狀態後，您需要將其包含在工作流程中。

假設您建立了一個名為「進行中」的狀態，並且您希望開發人員能夠將錯誤從「新增」更改為「進行中」。
前往「管理 -> 工作流程」，選擇「錯誤」和「開發人員」，取消勾選「僅顯示此追蹤器使用的狀態」方塊，然後按一下編輯。
您現在可以看到開發人員在錯誤方面允許的所有轉換。在「新增」列中，按一下「進行中」欄中的核取方塊，然後儲存。

請參閱工作流程設定。

我建立了一個新的追蹤器，但我無法使用它，它沒有出現在追蹤器下拉式選單中。¶

建立新的追蹤器後，您需要為特定專案「啟用」它。

假設您建立了一個名為「任務」的追蹤器，並且您希望將新的追蹤器用於您的專案；

• 前往「（專案）設定 ->「資訊」索引標籤 ->「追蹤器」欄位集」，
• 勾選新追蹤器「任務」的核取方塊，
• 然後按一下儲存。

您現在可以在剛剛為其啟用新追蹤器的專案中開始使用新的追蹤器「任務」。

「相關問題」如何運作？¶

如需詳細說明，請參閱Redmine 問題。

時間追蹤¶

「已花費時間報表」中的時間計算錯誤。¶

您可能正在使用十進制時間格式在 Redmine 中輸入已花費時間值。如需詳細說明，請參閱Redmine 時間追蹤。

儲存庫¶

在我按一下「儲存庫」之前，提交不會顯示在活動中¶

根據預設，Redmine 只有在您瀏覽儲存庫時才會從儲存庫中擷取新的提交。

如果您希望 Redmine 在背景中定期為所有儲存庫擷取提交，請取消勾選「自動擷取提交」設定，並新增一個在（適當環境下）執行的 cron

rake -f /path/to/redmine/Rakefile RAILS_ENV=production redmine:fetch_changesets

對於 SVN 儲存庫，您也可以將以下指令新增至 post-commit hook

ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production

*注意，第二種 post-commit hook 的方法會降低 commit 的速度，並且如果 Redmine 無法正常運作，則可能會導致 commit 失敗。

您可以透過將 ruby 命令發送到背景來避免這些缺點。

ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production > /dev/null 2>&1 &

我無法透過 Redmine 瀏覽我的 SVN 儲存庫¶

檢查以下內容

• 請確保您使用的是 SVN 用戶端和伺服器版本 >= 1.3。Redmine 會解析來自 Subversion 的 -xml 輸出，這是 SVN 1.3 的功能。
• 請確保網路應用程式能夠執行 SVN 二進制檔案。(提示：檢查您的路徑並確保 SVN 二進制檔案位於其中)
• 當使用 file:/// 連結時，請確保執行 Redmine 的系統使用者有權訪問您本地檔案系統上 file:/// 指定的位置。(提示：根據預設，當使用 Passenger 時，Redmine 會以擁有您的 config/environment.rb 的使用者身份執行。)

如果您透過 HTTPS 訪問儲存庫

透過 https 對 Subversion 儲存庫進行初始匯入時，需要手動驗證 ssl 憑證指紋並將其儲存在執行網路伺服器的使用者可以訪問的 config-dir 中。建議提供 Redmine 應用程式根目錄下的本地目錄，作為預設目錄 (./svn/.subversion) 或作為 Subversion 儲存庫設定中的提供參數。

解決憑證接受問題的方法是從 SVN 伺服器手動簽出任何內容，指定本地 config-dir 並永久接受憑證。
範例

$ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me

Error validating server certificate for 'https://svn.mydomain.com:443':
- The certificate is not issued by a trusted authority. Use the
fingerprint to validate the certificate manually!
- The certificate hostname does not match.
- The certificate has expired.
Certificate information:
- Hostname: svn.mydomain.com
- Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT
- Issuer: mydomain.com, vrsource.org, Geneva, UN
- Fingerprint: 01:27:d9:6a:b8:db:63:f3:24:e3:41:c8:15:0a:f8:93:f6:7c:0f:11
(R)eject, accept (t)emporarily or accept (p)ermanently? p

或修改 <redmine 根目錄>/lib/redmine/scm/adapters/subversion_adapter.rb 中的 subversion_adapter.rb
在 credentials_string 定義區段中變更 SVN 全域選項
從

--no-auth-cache --non-interactive

至

--trust-server-cert --no-auth-cache --non-interactive

有關此問題的其他資訊，請檢查您的日誌檔案以瞭解 SVN 操作期間遇到的問題。(例如 /log/production.log)

或在 /etc/subversion/servers 中列出憑證。有關詳細資訊，請參閱 http://www.geekforgod.com/2006/12/01/making-svn-trust-a-new-root-ca-certificate/。

儲存庫統計資訊未顯示¶

• 如果您使用的是 ruby 1.8.6
  ruby 1.8.6 提供的 rexml 3.1.7 中存在一個錯誤。您可以自行修復
  在 ruby/1.8/rexml/document.rb (第 186 行) 中，將：if transitive 更改為 if trans，然後重新啟動應用程式。
  有關詳細資訊，請參閱 http://www.germane-software.com/projects/rexml/ticket/115。
• 如果您使用的是 Internet Explorer
  您需要一個 SVG 外掛，例如 Adobe 提供的外掛，才能在 Internet Explorer 中正確顯示 SVG 圖像。

Wiki¶

如何在 Wiki 中建立子頁面（父子關係）¶

如需詳細說明，請參閱 Redmine Wiki。

全域 Wiki¶

目前沒有全域 Wiki，目前的權限系統不允許這樣做。一種解決方法是建立一個專案，如果只需要一個 Wiki，則將其用於所有全域需求。

效能¶

當我建立新的問題時，Redmine 會凍結一分鐘。¶

請確保您的 SMTP 伺服器已正確配置，或停用**電子郵件通知**(移除 config/email.yml) 並重新啟動 Redmine。

其他¶

電子郵件使用的網址不正確¶

電子郵件中使用的網址是透過管理> 設定> 常用選項卡中的**主機名稱和路徑**設定來配置的。它預設為 localhost:3000 (Ruby on Rails 預設值)。它不應包含通訊協定處理常式 ("http://")。

電子郵件通知無法運作¶

首先，嘗試發送一封測試電子郵件：前往「管理 -> 設定 -> 電子郵件通知」 並點擊 「發送測試電子郵件」。
這會發送一封電子郵件到您的 Redmine 帳戶的電子郵件地址

• 如果您收到錯誤訊息，請檢查您在 config/configuration.yml 中的設定。請參閱 EmailConfiguration。
• 如果您沒有收到任何電子郵件，請檢查您的 SMTP 伺服器日誌，查看電子郵件是否已正確轉發。

針對其他問題（例如，有些人收到通知，但其他人沒有），您可以透過將 config/environments/production.rb 中的這一行註解掉，在您的 Redmine 日誌檔案中啟用電子郵件偵錯輸出

config.action_mailer.logger = nil

重新啟動應用程式後，每封發送的電子郵件都會被傾印到您的日誌檔案 (log/production.log) 中。
透過這種方式，您可以檢查電子郵件的 收件者： 欄位，查看是否包含所有預期的電子郵件地址。

在日光節約時間切換後，所有時間都延遲了 1 小時¶

Rails < 2.1 內建的時區實作無法處理 DST。您必須安裝 TZInfo。
為此，請從您的 Redmine 目錄執行以下指令

ruby script/plugin install tzinfo_timezone

如果您使用的是 Redmine 0.8，請勿安裝此插件。

文件和檔案之間有什麼區別？¶

「文件」區段用於發佈不屬於 SCM 的規格、公告或其他文件。
「檔案」區段用於以套件（發行版）的形式發佈已追蹤專案的版本。

當我嘗試查看或比較 PHP 檔案時，出現 404 錯誤¶

這是因為 Apache 看到 .php 副檔名，並嘗試在檔案上執行 PHP 直譯器。由於請求的 URL 不是真實檔案，因此會返回 404 錯誤。
解決方案是關閉 Redmine 虛擬主機的 mod_php。這將導致 Apache 呼叫 Redmine 來提供檔案。
為此，請將以下行添加到您的虛擬主機設定中

RemoveHandler .php
php_flag engine off    # Try without this line first

為什麼 Textile 內嵌樣式無法運作？¶

從 Redmine 0.8 開始，出於安全原因，Textile 內嵌樣式已被停用（請參閱 #2416）。

如果您真的需要此功能，並且不擔心 XSS 攻擊，因為您沒有具有公開寫入權限的專案，那麼您需要手動更改 Redmine 原始碼（source:/trunk/lib/redmine/wiki_formatting/textile/formatter.rb@2192#L33），或者您可以在 /lib/redmine/wiki_formatting/textile/formatter.rb 中更改此設定

self.filter_styles=false

在沒有 Redmine 管理員帳戶但有 Redmine 資料庫管理員帳戶的情況下遺失重設密碼¶

在檔案 /app/models/user.rb 中找到：「雜湊密碼以以下格式儲存：SHA1\(salt + SHA1)」
因此，您可以透過兩個步驟重設密碼
- 清除 salt
- 計算 sha1(sha1(新密碼))
例如，對於密碼「password」（不含引號），它將是「353e8061f2befecb6818ba0c034c632fb0bcae1b」
sah1(password)=0bd181063899c9239016320b50d3e896693a96df
sha1(0bd181063899c9239016320b50d3e896693a96df)=353e8061f2befecb6818ba0c034c632fb0bcae1b

您必須前往 Redmine 資料庫，找到「users」資料表，找到要重設密碼的使用者，清除「salt」欄位的使用者，並在「hashed_password」欄位的使用者中放入「353e8061f2befecb6818ba0c034c632fb0bcae1b」，然後使用新密碼「password」（不含引號）登入 Redmine。要進行這些 Redmine 資料庫變更，請在 Redmine 運作的作業系統的命令列中執行以下操作

• 從檔案 config/database.yml 中記下使用者和密碼。
• 適用於 MySQL
  • 執行命令：mysql -u <來自 database.yml 的資料庫使用者> -p
  • 輸入：<來自 database.yml 的密碼>
  • 執行：UPDATE users SET hashed_password='353e8061f2befecb6818ba0c034c632fb0bcae1b' WHERE login='admin';
  • 執行：UPDATE users SET salt='' WHERE login='admin';
  • 執行：exit

現在您可以前往 Redmine 登入網頁，使用「password」作為密碼以使用者 admin 身分登入。

使用 FireFox >= 28 時，編輯某些內容（例如版本）後的重新導向不正確¶

Redmine 使用 HTTP 參照位址，特別是其中的 path 部分，以便在編輯某些內容（例如版本）後進行正確的重新導向。只要 path 不可用，重新導向將無法按預期運作（例如，您會被重新導向至首頁，而不是路線圖或專案版本頁面）；請參閱 #18058。
Mozilla Firefox 28 引入了一組新的設定（請參閱變更集 e544d02 和 此第三方摘要），以限制傳送 HTTP 參照位址的預設行為（請參閱問題 822869）。已確認其中至少有一個設定，即 network.http.referer.trimmingPolicy，會在編輯某些內容後，只要將其預設值從「0」變更並設定為「2」，就會破壞 Redmine 中的某些重新導向。在這種情況下，HTTP 參照位址中會省略 path 部分。
將此值變更為「0」或「1」可以修正不正確的重新導向行為，因為這兩個值的參照位址中都包含 path 部分。