Project

General

Profile

FAQ » History » Revision 34

Revision 33 (Jean-Philippe Lang, 2008-10-18 12:30) → Revision 34/115 (Jean-Philippe Lang, 2008-10-18 12:30)

h1. Frequently Asked Questions 

 {{TOC}} 

 h2. Installing and Running Redmine 

 h3. Does Redmine work with Rails 2.1.x? 

 Redmine devel r1623 and above is compatible with Rails 2.1. 

 But Redmine 0.7.x releases are not. Please freeze your rails to 2.0.2 version: 
 <pre>$ rake rails:freeze:edge TAG=rel_2-0-2</pre> 

 h3. When I start the application, I get this error "in 'gem_original_require': no such file to load -- initializer (LoadError)" 

 Make sure "Ruby on Rails":http://rubyonrails.org/ is properly installed on your machine. 

 h3. When I start the application, I get this error message: "cannot connect to mysql: No such file or directory - /tmp/mysql.sock" 

 You have to specify the socket location in @config/database.yml@. 
 See http://dev.rubyonrails.org/ticket/200. 

 h3. The application seems to work fine but some pages (eg. login form) have no content. 

 You're running Rails 1.1.x but Redmine requires 1.2.6. 
 Upgrade Rails (if you're using gem package system, run the command @gem update@ as root/administrator). 

 h3. The application freeze after a long time of inactivity. 

 There's a bug in ruby/mysql adapter < 2.7.3 that leads to loose the database connection. Please update your adapter. 
 You can see thread at: http://rubyforge.org/forum/message.php?msg_id=25951. 

 h3. I upgraded Rails to 2.0, but Redmine doesn't work anymore! 

 Redmine 0.6.3 is Rails 2.0 compatible, but prior versions are not. 

 The best solution is to upgrade Redmine to the latest version. But if you really want to use Redmine 0.6.0 on a box running Rails 2.0, please freeze your Rails version for Redmine (it won't affect your other Rails applications) by typing this command from your Redmine directory: 

   rake rails:freeze:edge TAG=rel_1-2-6 

 Don't forget to restart your server. 

 h2. Issue tracking 

 h3. I've created a new issue status but I can't use it, it doesn't show up in the status drop-down list. 

 Once you've created a new issue status, you need to include it in the workflow. 

 Say you have created a status named 'In progress' and you want the developers to be able to change bugs from 'New' to 'In progress'. 
 Go to "Admin -> Issue tracking -> Workflow", select 'Bug' and 'Developer' then click edit. 
 You now see all the transitions allowed for developers on bugs. Check the 'New' -> 'In progress' checkbox and save. 

 See [[RedmineIssueTrackingSetup|Workflow setup]]. 

 h3. How does "Related issues" work? 

 Using Issue #100 as the one you set the relationship and Issue #101 as the "related to" 

 * Related - Just adds a link to the other issue 
 * Duplicates - Links issues so that closing one, will close the other (e.g. closing #100 will close #101) 
 * Blocks - Indicates that an issue need to be completed before working on the next. 
 * Precedes - Defines an "order", where issue #100 needs to be completed x days before #101 can be started on. 

 h2. Repositories 

 h3. Commits don't show up in the activity until I click on 'Repository' 

 By default, Redmine fetches the new commits from the repository only when you browse it. 

 If you want the commits to be retrieved periodically by Redmine in the background for all your repositories, uncheck 'Autofetch commits' setting and add a cron that runs (with appropriate environment): 

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

 h3. I can't browse my svn repository through redmine 

 Check the following: 
 * Make sure you're using a svn client and server >= 1.3. Redmine parse the -xml output from subversion, which is a svn 1.3 feature. 
 * Make sure that the web app is able to run the svn binary 

 If you're accessing the repository over HTTPS: 

 The initial import of a subversion repository over https requires that the ssl certificate fingerprint be manually validated and stored in a config-dir accessible by the user running the web server. It is recommended that a directory local to the redmine application root be provided, either as a default (./svn/.subversion) or as a provided parameter in the repository settings for subversion. 

 The work around for the certificate acceptance issue is to manually checkout anything from the svn server specifying the local config-dir and accepting the certificate +permanently+. 
 Example: 

 <pre> 
 $ 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 
 </pre> 

 h3. Repository statistics doesn't show up 

 There's a bug in rexml 3.1.7 provided with ruby 1.8.6. 
 In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app. 

 See http://www.germane-software.com/projects/rexml/ticket/115 for details. 

 h2. Performance 

 h3. When I create a new issue, Redmine freeze during one minute. 

 You have to configure email notification, or desactivate it. Please turn off *email notification* feature if you don't use it. In config/environment.rb replace the line 

   config.action_mailer.perform_deliveries = true 

 to 

   config.action_mailer.perform_deliveries = false 

 and restart redmine. 

 h2. Miscellaneous 

 h3. All times are off by 1 hour after the daylight savings switched 

 Rails < 2.1 built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/. 
 To do so, run the following from your Redmine directory: 

   ruby script/plugin install tzinfo_timezone 

 Do not install this plugin if you're using Rails 2.1. 

 h3. What difference between Documents and Download? 

 The "Documents" section is aimed to pusblish... documents as specification of the tracked project, or notice, or every documents that have not its place in a SCM. 
 The "Download" section is aimed to publish... versions of the tracked project, as a bundle. 

 h3. I get a 404 when I try to view or diff a php file 

 It's because Apache is seeing .php and trying to run the php intreperter on the file. Since that url isn't a real file, it gets a 404 error. 
 

 The solution is to turn off mod_php for your Redmine virtual host. That will cause Apache to call Redmine to serve up the file.