FAQ » History » Version 29

Thomas Lecavelier, 2008-06-08 14:15
Typos.

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 28 Thomas Lecavelier
Not at this time. Please freeze your rails to 2.0.2 version:
10 28 Thomas Lecavelier
<pre>$ rake rails:freeze:edge TAG=rel_2-0-2</pre>
11 28 Thomas Lecavelier
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 10 Jean-Philippe Lang
Make sure "Ruby on Rails":http://rubyonrails.org/ is properly installed on your machine.
15 10 Jean-Philippe Lang
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 22 Jean-Philippe Lang
18 22 Jean-Philippe Lang
You have to specify the socket location in @config/database.yml@.
19 22 Jean-Philippe Lang
See http://dev.rubyonrails.org/ticket/200.
20 22 Jean-Philippe Lang
21 1 Jean-Philippe Lang
h3. The application seems to work fine but some pages (eg. login form) have no content.
22 1 Jean-Philippe Lang
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 18 Jean-Philippe Lang
35 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:
36 15 Thomas Lecavelier
37 15 Thomas Lecavelier
  rake rails:freeze:edge TAG=rel_1-2-6
38 15 Thomas Lecavelier
39 15 Thomas Lecavelier
Don't forget to restart your server.
40 15 Thomas Lecavelier
41 7 Jean-Philippe Lang
h2. Issue tracking
42 7 Jean-Philippe Lang
43 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.
44 7 Jean-Philippe Lang
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 13 Jean-Philippe Lang
See [[RedmineIssueTrackingSetup|Workflow setup]].
52 11 Thomas Lecavelier
53 20 Eric Davis
h3. How does "Related issues" work?
54 20 Eric Davis
55 20 Eric Davis
Using Issue #100 as the one you set the relationship and Issue #101 as the "related to"
56 20 Eric Davis
57 20 Eric Davis
* 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 24 Jean-Philippe Lang
* 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 12 Jean-Philippe Lang
64 12 Jean-Philippe Lang
h3. Commits don't show up in the activity until I click on 'Repository'
65 12 Jean-Philippe Lang
66 12 Jean-Philippe Lang
By default, Redmine fetches the new commits from the repository only when you browse it.
67 12 Jean-Philippe Lang
68 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):
69 12 Jean-Philippe Lang
70 12 Jean-Philippe Lang
  ruby script/runner "Repository.fetch_changesets" -e production
71 12 Jean-Philippe Lang
72 19 Thomas Lecavelier
h3. I can't browse my svn repository through redmine
73 19 Thomas Lecavelier
74 25 Jean-Philippe Lang
Check the following:
75 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.
76 25 Jean-Philippe Lang
* Make sure that the web app is able to run the svn binary
77 25 Jean-Philippe Lang
78 25 Jean-Philippe Lang
If you're accessing the repository over HTTPS:
79 25 Jean-Philippe Lang
80 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.
81 25 Jean-Philippe Lang
82 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+.
83 25 Jean-Philippe Lang
Example:
84 25 Jean-Philippe Lang
85 25 Jean-Philippe Lang
<pre>
86 25 Jean-Philippe Lang
$ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me
87 25 Jean-Philippe Lang
88 25 Jean-Philippe Lang
Error validating server certificate for 'https://svn.mydomain.com:443':
89 25 Jean-Philippe Lang
- The certificate is not issued by a trusted authority. Use the
90 25 Jean-Philippe Lang
fingerprint to validate the certificate manually!
91 25 Jean-Philippe Lang
- The certificate hostname does not match.
92 25 Jean-Philippe Lang
- The certificate has expired.
93 25 Jean-Philippe Lang
Certificate information:
94 25 Jean-Philippe Lang
- Hostname: svn.mydomain.com
95 25 Jean-Philippe Lang
- Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT
96 25 Jean-Philippe Lang
- Issuer: mydomain.com, vrsource.org, Geneva, UN
97 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
98 25 Jean-Philippe Lang
(R)eject, accept (t)emporarily or accept (p)ermanently? p
99 25 Jean-Philippe Lang
</pre>
100 19 Thomas Lecavelier
101 26 Jean-Philippe Lang
h3. Repository statistics doesn't show up
102 26 Jean-Philippe Lang
103 26 Jean-Philippe Lang
There's a bug in rexml 3.1.7 provided with ruby 1.8.6.
104 26 Jean-Philippe Lang
In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app.
105 26 Jean-Philippe Lang
106 26 Jean-Philippe Lang
See http://www.germane-software.com/projects/rexml/ticket/115 for details.
107 26 Jean-Philippe Lang
108 11 Thomas Lecavelier
h2. Performance
109 11 Thomas Lecavelier
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 11 Thomas Lecavelier
  config.action_mailer.perform_deliveries = true
115 11 Thomas Lecavelier
116 11 Thomas Lecavelier
to
117 11 Thomas Lecavelier
118 11 Thomas Lecavelier
  config.action_mailer.perform_deliveries = false
119 11 Thomas Lecavelier
120 11 Thomas Lecavelier
and restart redmine.
121 21 Jean-Philippe Lang
122 29 Thomas Lecavelier
h2. Miscellaneous
123 21 Jean-Philippe Lang
124 21 Jean-Philippe Lang
h3. All times are off by 1 hour after the daylight savings switched
125 21 Jean-Philippe Lang
126 29 Thomas Lecavelier
Rails built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/.
127 21 Jean-Philippe Lang
To do so, run the following from your Redmine directory:
128 21 Jean-Philippe Lang
129 21 Jean-Philippe Lang
  ruby script/plugin install tzinfo_timezone