FAQ » History » Version 30

Jean-Philippe Lang, 2008-07-06 14:50
Rails 2.1 compatibility update

1 1 Jean-Philippe Lang
h1. Frequently Asked Questions
2 1 Jean-Philippe Lang
3 2 Jean-Philippe Lang
{{TOC}}
4 1 Jean-Philippe Lang
5 1 Jean-Philippe Lang
h2. Installing and Running Redmine
6 1 Jean-Philippe Lang
7 28 Thomas Lecavelier
h3. Does Redmine work with Rails 2.1.x?
8 28 Thomas Lecavelier
9 30 Jean-Philippe Lang
Redmine devel r1623 and above is compatible with Rails 2.1.
10 30 Jean-Philippe Lang
11 30 Jean-Philippe Lang
But Redmine 0.7.x releases are not. Please freeze your rails to 2.0.2 version:
12 28 Thomas Lecavelier
<pre>$ rake rails:freeze:edge TAG=rel_2-0-2</pre>
13 28 Thomas Lecavelier
14 18 Jean-Philippe Lang
h3. When I start the application, I get this error "in 'gem_original_require': no such file to load -- initializer (LoadError)"
15 10 Jean-Philippe Lang
16 10 Jean-Philippe Lang
Make sure "Ruby on Rails":http://rubyonrails.org/ is properly installed on your machine.
17 10 Jean-Philippe Lang
18 22 Jean-Philippe Lang
h3. When I start the application, I get this error message: "cannot connect to mysql: No such file or directory - /tmp/mysql.sock"
19 22 Jean-Philippe Lang
20 22 Jean-Philippe Lang
You have to specify the socket location in @config/database.yml@.
21 22 Jean-Philippe Lang
See http://dev.rubyonrails.org/ticket/200.
22 22 Jean-Philippe Lang
23 1 Jean-Philippe Lang
h3. The application seems to work fine but some pages (eg. login form) have no content.
24 1 Jean-Philippe Lang
25 23 Jean-Philippe Lang
You're running Rails 1.1.x but Redmine requires 1.2.6.
26 9 Jean-Philippe Lang
Upgrade Rails (if you're using gem package system, run the command @gem update@ as root/administrator).
27 3 Thomas Lecavelier
28 9 Jean-Philippe Lang
h3. The application freeze after a long time of inactivity.
29 3 Thomas Lecavelier
30 9 Jean-Philippe Lang
There's a bug in ruby/mysql adapter < 2.7.3 that leads to loose the database connection. Please update your adapter.
31 7 Jean-Philippe Lang
You can see thread at: http://rubyforge.org/forum/message.php?msg_id=25951.
32 1 Jean-Philippe Lang
33 18 Jean-Philippe Lang
h3. I upgraded Rails to 2.0, but Redmine doesn't work anymore!
34 17 Jean-Philippe Lang
35 18 Jean-Philippe Lang
Redmine 0.6.3 is Rails 2.0 compatible, but prior versions are not.
36 18 Jean-Philippe Lang
37 18 Jean-Philippe Lang
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:
38 15 Thomas Lecavelier
39 15 Thomas Lecavelier
  rake rails:freeze:edge TAG=rel_1-2-6
40 15 Thomas Lecavelier
41 15 Thomas Lecavelier
Don't forget to restart your server.
42 15 Thomas Lecavelier
43 7 Jean-Philippe Lang
h2. Issue tracking
44 7 Jean-Philippe Lang
45 7 Jean-Philippe Lang
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.
46 7 Jean-Philippe Lang
47 8 Jean-Philippe Lang
Once you've created a new issue status, you need to include it in the workflow.
48 7 Jean-Philippe Lang
49 13 Jean-Philippe Lang
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'.
50 7 Jean-Philippe Lang
Go to "Admin -> Issue tracking -> Workflow", select 'Bug' and 'Developer' then click edit.
51 1 Jean-Philippe Lang
You now see all the transitions allowed for developers on bugs. Check the 'New' -> 'In progress' checkbox and save.
52 13 Jean-Philippe Lang
53 13 Jean-Philippe Lang
See [[RedmineIssueTrackingSetup|Workflow setup]].
54 11 Thomas Lecavelier
55 20 Eric Davis
h3. How does "Related issues" work?
56 20 Eric Davis
57 20 Eric Davis
Using Issue #100 as the one you set the relationship and Issue #101 as the "related to"
58 20 Eric Davis
59 20 Eric Davis
* Related - Just adds a link to the other issue
60 24 Jean-Philippe Lang
* Duplicates - Links issues so that closing one, will close the other (e.g. closing #100 will close #101)
61 24 Jean-Philippe Lang
* Blocks - Indicates that an issue need to be completed before working on the next.
62 27 Thomas Lecavelier
* Precedes - Defines an "order", where issue #100 needs to be completed x days before #101 can be started on.
63 20 Eric Davis
64 12 Jean-Philippe Lang
h2. Repositories
65 12 Jean-Philippe Lang
66 12 Jean-Philippe Lang
h3. Commits don't show up in the activity until I click on 'Repository'
67 12 Jean-Philippe Lang
68 12 Jean-Philippe Lang
By default, Redmine fetches the new commits from the repository only when you browse it.
69 12 Jean-Philippe Lang
70 12 Jean-Philippe Lang
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):
71 12 Jean-Philippe Lang
72 12 Jean-Philippe Lang
  ruby script/runner "Repository.fetch_changesets" -e production
73 12 Jean-Philippe Lang
74 19 Thomas Lecavelier
h3. I can't browse my svn repository through redmine
75 19 Thomas Lecavelier
76 25 Jean-Philippe Lang
Check the following:
77 25 Jean-Philippe Lang
* 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.
78 25 Jean-Philippe Lang
* Make sure that the web app is able to run the svn binary
79 25 Jean-Philippe Lang
80 25 Jean-Philippe Lang
If you're accessing the repository over HTTPS:
81 25 Jean-Philippe Lang
82 25 Jean-Philippe Lang
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.
83 25 Jean-Philippe Lang
84 25 Jean-Philippe Lang
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+.
85 25 Jean-Philippe Lang
Example:
86 25 Jean-Philippe Lang
87 25 Jean-Philippe Lang
<pre>
88 25 Jean-Philippe Lang
$ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me
89 25 Jean-Philippe Lang
90 25 Jean-Philippe Lang
Error validating server certificate for 'https://svn.mydomain.com:443':
91 25 Jean-Philippe Lang
- The certificate is not issued by a trusted authority. Use the
92 25 Jean-Philippe Lang
fingerprint to validate the certificate manually!
93 25 Jean-Philippe Lang
- The certificate hostname does not match.
94 25 Jean-Philippe Lang
- The certificate has expired.
95 25 Jean-Philippe Lang
Certificate information:
96 25 Jean-Philippe Lang
- Hostname: svn.mydomain.com
97 25 Jean-Philippe Lang
- Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT
98 25 Jean-Philippe Lang
- Issuer: mydomain.com, vrsource.org, Geneva, UN
99 25 Jean-Philippe Lang
- Fingerprint: 01:27:d9:6a:b8:db:63:f3:24:e3:41:c8:15:0a:f8:93:f6:7c:0f:11
100 25 Jean-Philippe Lang
(R)eject, accept (t)emporarily or accept (p)ermanently? p
101 25 Jean-Philippe Lang
</pre>
102 19 Thomas Lecavelier
103 26 Jean-Philippe Lang
h3. Repository statistics doesn't show up
104 26 Jean-Philippe Lang
105 26 Jean-Philippe Lang
There's a bug in rexml 3.1.7 provided with ruby 1.8.6.
106 26 Jean-Philippe Lang
In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app.
107 26 Jean-Philippe Lang
108 26 Jean-Philippe Lang
See http://www.germane-software.com/projects/rexml/ticket/115 for details.
109 26 Jean-Philippe Lang
110 11 Thomas Lecavelier
h2. Performance
111 11 Thomas Lecavelier
112 14 Jean-Philippe Lang
h3. When I create a new issue, Redmine freeze during one minute.
113 11 Thomas Lecavelier
114 14 Jean-Philippe Lang
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
115 11 Thomas Lecavelier
116 11 Thomas Lecavelier
  config.action_mailer.perform_deliveries = true
117 11 Thomas Lecavelier
118 11 Thomas Lecavelier
to
119 11 Thomas Lecavelier
120 11 Thomas Lecavelier
  config.action_mailer.perform_deliveries = false
121 11 Thomas Lecavelier
122 11 Thomas Lecavelier
and restart redmine.
123 21 Jean-Philippe Lang
124 29 Thomas Lecavelier
h2. Miscellaneous
125 21 Jean-Philippe Lang
126 21 Jean-Philippe Lang
h3. All times are off by 1 hour after the daylight savings switched
127 21 Jean-Philippe Lang
128 29 Thomas Lecavelier
Rails built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/.
129 21 Jean-Philippe Lang
To do so, run the following from your Redmine directory:
130 21 Jean-Philippe Lang
131 21 Jean-Philippe Lang
  ruby script/plugin install tzinfo_timezone