Project

General

Profile

FAQ » History » Version 28

Thomas Lecavelier, 2008-06-08 14:13
Rails 2.1 incompatibility; freeze 2.0.2 instructions.

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