FAQ » History » Version 49

Greg Mefford, 2009-09-05 19:35
Fixed some grammar issues.

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 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 10 Jean-Philippe Lang
Make sure "Ruby on Rails":http://rubyonrails.org/ is properly installed on your machine.
14 10 Jean-Philippe Lang
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 22 Jean-Philippe Lang
17 22 Jean-Philippe Lang
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 15 Thomas Lecavelier
25 35 Eric Davis
h3. Why does Redmine use http links when I want it to use https links in Apache? (SSL)
26 35 Eric Davis
27 35 Eric Davis
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 35 Eric Davis
29 35 Eric Davis
    RequestHeader set X_FORWARDED_PROTO 'https'
30 35 Eric Davis
31 7 Jean-Philippe Lang
h2. Issue tracking
32 7 Jean-Philippe Lang
33 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.
34 7 Jean-Philippe Lang
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 36 Mischa The Evil
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 36 Mischa The Evil
45 36 Mischa The Evil
Once you've created a new tracker, you need to "activate" it for a specific project.
46 36 Mischa The Evil
47 36 Mischa The Evil
Say you have created a tracker named 'Task' and you want the new tracker to be used for your project;
48 36 Mischa The Evil
* go to "(Project-)Settings -> tab 'Information' -> fieldset 'Trackers'",
49 36 Mischa The Evil
* check the checkbox of the new tracker 'Task',
50 36 Mischa The Evil
* and then click save.
51 36 Mischa The Evil
52 36 Mischa The Evil
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 20 Eric Davis
56 20 Eric Davis
Using Issue #100 as the one you set the relationship and Issue #101 as the "related to"
57 20 Eric Davis
58 20 Eric Davis
* 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 24 Jean-Philippe Lang
* 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 37 Mischa The Evil
65 37 Mischa The Evil
h3. The time calculations in "Spent time Reports" are wrong.
66 37 Mischa The Evil
67 37 Mischa The Evil
You can enter spent-time values in Redmine using "decimal time format":http://en.wikipedia.org/wiki/Decimal_time. See [[Time_tracking]].
68 37 Mischa The Evil
69 37 Mischa The Evil
* _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 37 Mischa The Evil
71 37 Mischa The Evil
* _Explanation_: this "behaviour" is normal and intended since you enter those four spent-time values using decimal time format. This means that: 
72 37 Mischa The Evil
** 1.00 decimal equals 60 minutes (1 hour)
73 37 Mischa The Evil
** 0.10 decimal equals 6 minutes
74 37 Mischa The Evil
** 0.15 decimal equals 9 minutes
75 37 Mischa The Evil
** 0.40 decimal equals 24 minutes
76 37 Mischa The Evil
** 1.65 decimal equals 99 minutes
77 37 Mischa The Evil
** 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation
78 37 Mischa The Evil
79 37 Mischa The Evil
Offcourse there can possibly be a very tiny difference (as you can see) due to the rounding to two decimals done by Redmine.
80 37 Mischa The Evil
81 37 Mischa The Evil
Some references:
82 37 Mischa The Evil
* http://en.wikipedia.org/wiki/Decimal_time
83 37 Mischa The Evil
* http://www.springfrog.com/converter/decimal-time.htm
84 37 Mischa The Evil
85 12 Jean-Philippe Lang
h2. Repositories
86 12 Jean-Philippe Lang
87 12 Jean-Philippe Lang
h3. Commits don't show up in the activity until I click on 'Repository'
88 12 Jean-Philippe Lang
89 12 Jean-Philippe Lang
By default, Redmine fetches the new commits from the repository only when you browse it.
90 12 Jean-Philippe Lang
91 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):
92 12 Jean-Philippe Lang
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 47 Marco Bernasocchi
97 47 Marco Bernasocchi
  ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production
98 47 Marco Bernasocchi
99 19 Thomas Lecavelier
h3. I can't browse my svn repository through redmine
100 19 Thomas Lecavelier
101 25 Jean-Philippe Lang
Check the following:
102 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.
103 25 Jean-Philippe Lang
* Make sure that the web app is able to run the svn binary
104 25 Jean-Philippe Lang
105 25 Jean-Philippe Lang
If you're accessing the repository over HTTPS:
106 25 Jean-Philippe Lang
107 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.
108 25 Jean-Philippe Lang
109 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+.
110 25 Jean-Philippe Lang
Example:
111 25 Jean-Philippe Lang
112 25 Jean-Philippe Lang
<pre>
113 25 Jean-Philippe Lang
$ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me
114 25 Jean-Philippe Lang
115 25 Jean-Philippe Lang
Error validating server certificate for 'https://svn.mydomain.com:443':
116 25 Jean-Philippe Lang
- The certificate is not issued by a trusted authority. Use the
117 25 Jean-Philippe Lang
fingerprint to validate the certificate manually!
118 25 Jean-Philippe Lang
- The certificate hostname does not match.
119 25 Jean-Philippe Lang
- The certificate has expired.
120 25 Jean-Philippe Lang
Certificate information:
121 25 Jean-Philippe Lang
- Hostname: svn.mydomain.com
122 25 Jean-Philippe Lang
- Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT
123 25 Jean-Philippe Lang
- Issuer: mydomain.com, vrsource.org, Geneva, UN
124 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
125 25 Jean-Philippe Lang
(R)eject, accept (t)emporarily or accept (p)ermanently? p
126 25 Jean-Philippe Lang
</pre>
127 19 Thomas Lecavelier
128 26 Jean-Philippe Lang
h3. Repository statistics doesn't show up
129 44 Mischa The Evil
130 44 Mischa The Evil
* If you are using ruby 1.8.6:
131 44 Mischa The Evil
There's a bug in rexml 3.1.7 provided with ruby 1.8.6. You can fix it yourself:
132 1 Jean-Philippe Lang
In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app.
133 26 Jean-Philippe Lang
See http://www.germane-software.com/projects/rexml/ticket/115 for details.
134 44 Mischa The Evil
* If you are using Internet Explorer:
135 44 Mischa The Evil
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.
136 26 Jean-Philippe Lang
137 42 Mischa The Evil
h2. Wikis
138 42 Mischa The Evil
139 42 Mischa The Evil
h3. How do I create sub-pages (parent/child relationships) in the wiki
140 42 Mischa The Evil
141 42 Mischa The Evil
Looking at http://www.redmine.org/wiki/redmine/Page_index/special it is possible to make use of some sort of sub-paging like:
142 42 Mischa The Evil
> * Guide
143 42 Mischa The Evil
> ** RedmineAccounts
144 42 Mischa The Evil
> ** RedmineCustomFields
145 42 Mischa The Evil
> ** RedmineInstall
146 42 Mischa The Evil
> ** RedmineIssueList
147 42 Mischa The Evil
> ** RedmineIssues
148 42 Mischa The Evil
This can be accomplished by assigning a parent page to a to-be child-page. This assignment can be done via the @rename@ dialog.
149 42 Mischa The Evil
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.
150 42 Mischa The Evil
151 11 Thomas Lecavelier
h2. Performance
152 11 Thomas Lecavelier
153 49 Greg Mefford
h3. When I create a new issue, Redmine freezes for one minute.
154 11 Thomas Lecavelier
155 49 Greg Mefford
Make sure your SMTP server is properly configured or deactivate *email notifications* (remove @config/email.yml@) and restart Redmine.
156 21 Jean-Philippe Lang
157 1 Jean-Philippe Lang
h2. Miscellaneous
158 29 Thomas Lecavelier
159 48 Eric Davis
h3. Emails use the incorrect url
160 48 Eric Davis
161 48 Eric Davis
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).
162 48 Eric Davis
163 21 Jean-Philippe Lang
h3. All times are off by 1 hour after the daylight savings switched
164 21 Jean-Philippe Lang
165 21 Jean-Philippe Lang
Rails < 2.1 built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/.
166 31 Jean-Philippe Lang
To do so, run the following from your Redmine directory:
167 21 Jean-Philippe Lang
168 21 Jean-Philippe Lang
  ruby script/plugin install tzinfo_timezone
169 31 Jean-Philippe Lang
170 40 Jean-Philippe Lang
Do not install this plugin if you're using Redmine 0.8.
171 32 Thomas Lecavelier
172 38 Mischa The Evil
h3. What is the difference between Documents and Files?
173 32 Thomas Lecavelier
174 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.
175 38 Mischa The Evil
The "Files" section is aimed to publish... versions of the tracked project, as a bundle (release).
176 33 Jean-Philippe Lang
177 38 Mischa The Evil
h3. I get a 404-error when I try to view or diff a PHP-file
178 33 Jean-Philippe Lang
179 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.
180 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.
181 41 Jean-Philippe Lang
To do so, add the following line to your virtual host configuration:
182 41 Jean-Philippe Lang
183 41 Jean-Philippe Lang
  RemoveHandler .php