Project

General

Profile

FAQ » History » Version 58

Michael Faille, 2010-03-12 04:08

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 39 Jean-Philippe Lang
h3. Does Redmine works with Rails 2.x.x?
8 28 Thomas Lecavelier
9 39 Jean-Philippe Lang
See compatibility in the [[RedmineInstall|Installation]] guide.
10 28 Thomas Lecavelier
11 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)"
12 10 Jean-Philippe Lang
13
Make sure "Ruby on Rails":http://rubyonrails.org/ is properly installed on your machine.
14
15 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"
16
17
You have to specify the socket location in @config/database.yml@.
18 9 Jean-Philippe Lang
See http://dev.rubyonrails.org/ticket/200.
19 3 Thomas Lecavelier
20 9 Jean-Philippe Lang
h3. The application freeze after a long time of inactivity.
21 3 Thomas Lecavelier
22 45 Joe Stewart
There's a bug in ruby/mysql adapter < 2.7.3 that leads to lose the database connection. Please update your adapter.
23 15 Thomas Lecavelier
You can see thread at: http://rubyforge.org/forum/message.php?msg_id=25951.
24
25 35 Eric Davis
h3. Why does Redmine use http links when I want it to use https links in Apache? (SSL)
26
27
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:
28
29
    RequestHeader set X_FORWARDED_PROTO 'https'
30
31 7 Jean-Philippe Lang
h2. Issue tracking
32
33
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.
34
35 8 Jean-Philippe Lang
Once you've created a new issue status, you need to include it in the workflow.
36 7 Jean-Philippe Lang
37 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'.
38 36 Mischa The Evil
Go to "Administration -> Issue tracking -> Workflow", select 'Bug' and 'Developer' then click edit.
39 1 Jean-Philippe Lang
You now see all the transitions allowed for developers on bugs. Check the 'New' -> 'In progress' checkbox and save.
40 13 Jean-Philippe Lang
41 1 Jean-Philippe Lang
See [[RedmineIssueTrackingSetup|Workflow setup]].
42 36 Mischa The Evil
43
h3. I've created a new tracker but I can't use it, it doesn't show up in the trackers drop-down list.
44
45
Once you've created a new tracker, you need to "activate" it for a specific project.
46
47
Say you have created a tracker named 'Task' and you want the new tracker to be used for your project;
48
* go to "(Project-)Settings -> tab 'Information' -> fieldset 'Trackers'",
49
* check the checkbox of the new tracker 'Task',
50
* and then click save.
51
52
You can now start using the new tracker 'Task' in the project for which you've just activated the new tracker.
53 11 Thomas Lecavelier
54 20 Eric Davis
h3. How does "Related issues" work?
55
56
Using Issue #100 as the one you set the relationship and Issue #101 as the "related to"
57
58
* Related - Just adds a link to the other issue
59 24 Jean-Philippe Lang
* Duplicates - Links issues so that closing one, will close the other (e.g. closing #100 will close #101)
60
* Blocks - Indicates that an issue need to be completed before working on the next.
61 27 Thomas Lecavelier
* Precedes - Defines an "order", where issue #100 needs to be completed x days before #101 can be started on.
62 20 Eric Davis
63 37 Mischa The Evil
h2. Time tracking
64
65
h3. The time calculations in "Spent time Reports" are wrong.
66
67
You can enter spent-time values in Redmine using "decimal time format":http://en.wikipedia.org/wiki/Decimal_time. See [[Time_tracking]].
68
69
* _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...???
70
71
* _Explanation_: this "behaviour" is normal and intended since you enter those four spent-time values using decimal time format. This means that: 
72
** 1.00 decimal equals 60 minutes (1 hour)
73
** 0.10 decimal equals 6 minutes
74
** 0.15 decimal equals 9 minutes
75
** 0.40 decimal equals 24 minutes
76
** 1.65 decimal equals 99 minutes
77
** 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation
78
79
Offcourse there can possibly be a very tiny difference (as you can see) due to the rounding to two decimals done by Redmine.
80
81
Some references:
82
* http://en.wikipedia.org/wiki/Decimal_time
83
* http://www.springfrog.com/converter/decimal-time.htm
84
85 12 Jean-Philippe Lang
h2. Repositories
86
87
h3. Commits don't show up in the activity until I click on 'Repository'
88
89
By default, Redmine fetches the new commits from the repository only when you browse it.
90
91
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):
92
93 46 Ethan Fremen
  rake -f /path/to/redmine/Rakefile redmine:fetch_changesets
94 12 Jean-Philippe Lang
95 47 Marco Bernasocchi
For SVN repositories you can also add the following command to a post-commit hook:
96
97
  ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production
98
99 52 George Montana Harkin
*Note, the second method of post-commit hook will slow down commits and could possibly cause commits to fail if Redmine is not functioning. 
100
101 19 Thomas Lecavelier
h3. I can't browse my svn repository through redmine
102
103 25 Jean-Philippe Lang
Check the following:
104
* 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.
105 55 Alex Ford
* Make sure that the web app is able to run the svn binary. (hint: check your path and ensure the svn binary is on it)
106 53 Jan from Planio www.plan.io
* When using a file:/// link, make sure the system user under which Redmine runs has access to the location specified by file:/// on your local file system. (Hint: By default, when using passenger, Redmine runs as the user which owns your config/environment.rb.)
107 25 Jean-Philippe Lang
108
If you're accessing the repository over HTTPS:
109
110
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.
111
112
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+.
113
Example:
114
115
<pre>
116
$ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me
117
118
Error validating server certificate for 'https://svn.mydomain.com:443':
119
- The certificate is not issued by a trusted authority. Use the
120
fingerprint to validate the certificate manually!
121
- The certificate hostname does not match.
122
- The certificate has expired.
123
Certificate information:
124
- Hostname: svn.mydomain.com
125
- Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT
126
- Issuer: mydomain.com, vrsource.org, Geneva, UN
127
- Fingerprint: 01:27:d9:6a:b8:db:63:f3:24:e3:41:c8:15:0a:f8:93:f6:7c:0f:11
128
(R)eject, accept (t)emporarily or accept (p)ermanently? p
129 1 Jean-Philippe Lang
</pre>
130 55 Alex Ford
131 56 Ki Won Kim
or modify subversion_adapter.rb in <redmine root>/lib/redmine/scm/adapters/subversion_adapter.rb
132
in credentials_string definition section chagne svn globaly options
133
from
134
<pre>
135
--no-auth-cache --non-interactive
136
</pre>
137
to
138
<pre>
139
--trust-server-cert --no-auth-cache --non-interactive
140
</pre>
141 55 Alex Ford
For additional information on the problem, check your log file for problems encountered during the svn operation. (e.g. /log/production.log )
142 19 Thomas Lecavelier
143 26 Jean-Philippe Lang
h3. Repository statistics doesn't show up
144 44 Mischa The Evil
145
* If you are using ruby 1.8.6:
146
There's a bug in rexml 3.1.7 provided with ruby 1.8.6. You can fix it yourself:
147 1 Jean-Philippe Lang
In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app.
148 26 Jean-Philippe Lang
See http://www.germane-software.com/projects/rexml/ticket/115 for details.
149 44 Mischa The Evil
* If you are using Internet Explorer:
150
You'll need an SVG plugin like the one "Adobe provides":http://www.adobe.com/svg/viewer/install/beta.html to be able to display SVG-images properly within Internet Explorer.
151 26 Jean-Philippe Lang
152 42 Mischa The Evil
h2. Wikis
153
154
h3. How do I create sub-pages (parent/child relationships) in the wiki
155
156
Looking at http://www.redmine.org/wiki/redmine/Page_index/special it is possible to make use of some sort of sub-paging like:
157
> * Guide
158
> ** RedmineAccounts
159
> ** RedmineCustomFields
160
> ** RedmineInstall
161
> ** RedmineIssueList
162
> ** RedmineIssues
163
This can be accomplished by assigning a parent page to a to-be child-page. This assignment can be done via the @rename@ dialog.
164
Thus, create both the child- and parent-pages and then open the to-be child-page and click "rename", then enter the name of the parent page.
165
166 11 Thomas Lecavelier
h2. Performance
167
168 49 Greg Mefford
h3. When I create a new issue, Redmine freezes for one minute.
169 11 Thomas Lecavelier
170 49 Greg Mefford
Make sure your SMTP server is properly configured or deactivate *email notifications* (remove @config/email.yml@) and restart Redmine.
171 21 Jean-Philippe Lang
172 1 Jean-Philippe Lang
h2. Miscellaneous
173 29 Thomas Lecavelier
174 48 Eric Davis
h3. Emails use the incorrect url
175
176
The urls used in email is configured with the *Host Name* setting in Administration > Settings > General tab.  It defaults to localhost:3000 (Ruby on Rails default).
177
178 21 Jean-Philippe Lang
h3. All times are off by 1 hour after the daylight savings switched
179
180
Rails < 2.1 built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/.
181 31 Jean-Philippe Lang
To do so, run the following from your Redmine directory:
182 21 Jean-Philippe Lang
183
  ruby script/plugin install tzinfo_timezone
184 31 Jean-Philippe Lang
185 40 Jean-Philippe Lang
Do not install this plugin if you're using Redmine 0.8.
186 32 Thomas Lecavelier
187 38 Mischa The Evil
h3. What is the difference between Documents and Files?
188 32 Thomas Lecavelier
189 50 Greg Mefford
The "Documents" section is for publishing specifications, notices, or other documents that do not belong in a SCM.
190
The "Files" section is for publishing versions of the tracked project, as a bundle (release).
191 33 Jean-Philippe Lang
192 38 Mischa The Evil
h3. I get a 404-error when I try to view or diff a PHP-file
193 33 Jean-Philippe Lang
194 41 Jean-Philippe Lang
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.
195 1 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.
196 51 Eric Davis
To do so, add the following lines to your virtual host configuration:
197 1 Jean-Philippe Lang
198 51 Eric Davis
<pre><code>RemoveHandler .php
199
php_flag engine off    # Try without this line first
200
</code></pre>
201 54 Jean-Philippe Lang
202
h3. Email notifications are not working
203
204
First, try to send a test email: go to _"Administration -> Settings -> Email notifications"_ and click _"Send a test email"_.
205
It will send an email to the email address of your Redmine account:
206
* If you get an error, check your configuration in @config/email.yml@.
207
* If you don't receive any email, check your SMTP server log to see if the email was properly relayed.
208
209
For other problems (eg. some people receive notifications but others don't), you can enable email debug output in your Redmine log file by commenting out this line in @config/environments/production.rb@:
210
211
<pre>
212
config.action_mailer.logger = nil
213
</pre>
214
215 1 Jean-Philippe Lang
After restarting the application, every email sent will be dumped to your log file (@log/production.log@).
216
This way you can check the @To:@ field of emails to see if all the expected email addresses are present.
217 58 Michael Faille
218
h3. How can I change the default ACL for non-anonimous users?