Project

General

Profile

FAQ » History » Version 38

Mischa The Evil, 2008-12-07 05:12
Improved (difference Documents & Files) + (404-error when view/diff a PHP-file)

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 30 Jean-Philippe Lang
Redmine devel r1623 and above is compatible with Rails 2.1.
10
11
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
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
Make sure "Ruby on Rails":http://rubyonrails.org/ is properly installed on your machine.
17
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
20
You have to specify the socket location in @config/database.yml@.
21
See http://dev.rubyonrails.org/ticket/200.
22
23 1 Jean-Philippe Lang
h3. The application seems to work fine but some pages (eg. login form) have no content.
24
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
37
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
  rake rails:freeze:edge TAG=rel_1-2-6
40
41
Don't forget to restart your server.
42
43 35 Eric Davis
h3. Why does Redmine use http links when I want it to use https links in Apache? (SSL)
44
45
This happens when Apache sending requests to a backend server, like mongrel or thin.  Apache isn't telling the backend server to use https so the links are generated incorrectly.  Add the following configuration to Apache:
46
47
    RequestHeader set X_FORWARDED_PROTO 'https'
48
49 7 Jean-Philippe Lang
h2. Issue tracking
50
51
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.
52
53 8 Jean-Philippe Lang
Once you've created a new issue status, you need to include it in the workflow.
54 7 Jean-Philippe Lang
55 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'.
56 36 Mischa The Evil
Go to "Administration -> Issue tracking -> Workflow", select 'Bug' and 'Developer' then click edit.
57 1 Jean-Philippe Lang
You now see all the transitions allowed for developers on bugs. Check the 'New' -> 'In progress' checkbox and save.
58 13 Jean-Philippe Lang
59 1 Jean-Philippe Lang
See [[RedmineIssueTrackingSetup|Workflow setup]].
60 36 Mischa The Evil
61
h3. I've created a new tracker but I can't use it, it doesn't show up in the trackers drop-down list.
62
63
Once you've created a new tracker, you need to "activate" it for a specific project.
64
65
Say you have created a tracker named 'Task' and you want the new tracker to be used for your project;
66
* go to "(Project-)Settings -> tab 'Information' -> fieldset 'Trackers'",
67
* check the checkbox of the new tracker 'Task',
68
* and then click save.
69
70
You can now start using the new tracker 'Task' in the project for which you've just activated the new tracker.
71 11 Thomas Lecavelier
72 20 Eric Davis
h3. How does "Related issues" work?
73
74
Using Issue #100 as the one you set the relationship and Issue #101 as the "related to"
75
76
* Related - Just adds a link to the other issue
77 24 Jean-Philippe Lang
* Duplicates - Links issues so that closing one, will close the other (e.g. closing #100 will close #101)
78
* Blocks - Indicates that an issue need to be completed before working on the next.
79 27 Thomas Lecavelier
* Precedes - Defines an "order", where issue #100 needs to be completed x days before #101 can be started on.
80 20 Eric Davis
81 37 Mischa The Evil
h2. Time tracking
82
83
h3. The time calculations in "Spent time Reports" are wrong.
84
85
You can enter spent-time values in Redmine using "decimal time format":http://en.wikipedia.org/wiki/Decimal_time. See [[Time_tracking]].
86
87
* _Example_: you have 4 tasks with the following spent time values: 1.00, 0.10, 0.15, & 0.40. Now in the Spent-Time reports (Project overview -> Spent time -> [Details | Report]) you see a total of 1.65 hours instead of 2.05 hours...???
88
89
* _Explanation_: this "behaviour" is normal and intended since you enter those four spent-time values using decimal time format. This means that: 
90
** 1.00 decimal equals 60 minutes (1 hour)
91
** 0.10 decimal equals 6 minutes
92
** 0.15 decimal equals 9 minutes
93
** 0.40 decimal equals 24 minutes
94
** 1.65 decimal equals 99 minutes
95
** 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation
96
97
Offcourse there can possibly be a very tiny difference (as you can see) due to the rounding to two decimals done by Redmine.
98
99
Some references:
100
* http://en.wikipedia.org/wiki/Decimal_time
101
* http://www.springfrog.com/converter/decimal-time.htm
102
103 12 Jean-Philippe Lang
h2. Repositories
104
105
h3. Commits don't show up in the activity until I click on 'Repository'
106
107
By default, Redmine fetches the new commits from the repository only when you browse it.
108
109
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):
110
111
  ruby script/runner "Repository.fetch_changesets" -e production
112
113 19 Thomas Lecavelier
h3. I can't browse my svn repository through redmine
114
115 25 Jean-Philippe Lang
Check the following:
116
* 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.
117
* Make sure that the web app is able to run the svn binary
118
119
If you're accessing the repository over HTTPS:
120
121
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.
122
123
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+.
124
Example:
125
126
<pre>
127
$ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me
128
129
Error validating server certificate for 'https://svn.mydomain.com:443':
130
- The certificate is not issued by a trusted authority. Use the
131
fingerprint to validate the certificate manually!
132
- The certificate hostname does not match.
133
- The certificate has expired.
134
Certificate information:
135
- Hostname: svn.mydomain.com
136
- Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT
137
- Issuer: mydomain.com, vrsource.org, Geneva, UN
138
- Fingerprint: 01:27:d9:6a:b8:db:63:f3:24:e3:41:c8:15:0a:f8:93:f6:7c:0f:11
139
(R)eject, accept (t)emporarily or accept (p)ermanently? p
140
</pre>
141 19 Thomas Lecavelier
142 26 Jean-Philippe Lang
h3. Repository statistics doesn't show up
143
144
There's a bug in rexml 3.1.7 provided with ruby 1.8.6.
145
In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app.
146
147
See http://www.germane-software.com/projects/rexml/ticket/115 for details.
148
149 11 Thomas Lecavelier
h2. Performance
150
151 14 Jean-Philippe Lang
h3. When I create a new issue, Redmine freeze during one minute.
152 11 Thomas Lecavelier
153 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
154 11 Thomas Lecavelier
155
  config.action_mailer.perform_deliveries = true
156
157
to
158
159
  config.action_mailer.perform_deliveries = false
160
161
and restart redmine.
162 21 Jean-Philippe Lang
163 29 Thomas Lecavelier
h2. Miscellaneous
164 21 Jean-Philippe Lang
165
h3. All times are off by 1 hour after the daylight savings switched
166
167 31 Jean-Philippe Lang
Rails < 2.1 built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/.
168 21 Jean-Philippe Lang
To do so, run the following from your Redmine directory:
169
170 1 Jean-Philippe Lang
  ruby script/plugin install tzinfo_timezone
171 31 Jean-Philippe Lang
172
Do not install this plugin if you're using Rails 2.1.
173 32 Thomas Lecavelier
174 38 Mischa The Evil
h3. What is the difference between Documents and Files?
175 32 Thomas Lecavelier
176 38 Mischa The Evil
The "Documents" section is aimed to publish... documents as specification of the tracked project, or notice, or every other documents that have not it's place in a SCM.
177
The "Files" section is aimed to publish... versions of the tracked project, as a bundle (release).
178 33 Jean-Philippe Lang
179 38 Mischa The Evil
h3. I get a 404-error when I try to view or diff a PHP-file
180 33 Jean-Philippe Lang
181 38 Mischa The Evil
It's because Apache is seeing the extension @.php@ and tries to run the PHP-interpreter on the file. Since the requested URL isn't a real file, it returns a 404-error.
182 33 Jean-Philippe Lang
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.