FAQ » History » Version 37
Mischa The Evil, 2008-12-05 15:52
Added FAQ-item: "Wrong time calculations..."
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 | 30 | Jean-Philippe Lang | Redmine devel r1623 and above is compatible with Rails 2.1. |
10 | 30 | Jean-Philippe Lang | |
11 | 30 | Jean-Philippe Lang | 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 | 28 | Thomas Lecavelier | |
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 | 10 | Jean-Philippe Lang | Make sure "Ruby on Rails":http://rubyonrails.org/ is properly installed on your machine. |
17 | 10 | Jean-Philippe Lang | |
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 | 22 | Jean-Philippe Lang | |
20 | 22 | Jean-Philippe Lang | You have to specify the socket location in @config/database.yml@. |
21 | 22 | Jean-Philippe Lang | See http://dev.rubyonrails.org/ticket/200. |
22 | 22 | Jean-Philippe Lang | |
23 | 1 | Jean-Philippe Lang | h3. The application seems to work fine but some pages (eg. login form) have no content. |
24 | 1 | Jean-Philippe Lang | |
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 | 18 | Jean-Philippe Lang | |
37 | 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: |
38 | 15 | Thomas Lecavelier | |
39 | 15 | Thomas Lecavelier | rake rails:freeze:edge TAG=rel_1-2-6 |
40 | 15 | Thomas Lecavelier | |
41 | 15 | Thomas Lecavelier | Don't forget to restart your server. |
42 | 15 | Thomas Lecavelier | |
43 | 35 | Eric Davis | h3. Why does Redmine use http links when I want it to use https links in Apache? (SSL) |
44 | 35 | Eric Davis | |
45 | 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: |
46 | 35 | Eric Davis | |
47 | 35 | Eric Davis | RequestHeader set X_FORWARDED_PROTO 'https' |
48 | 35 | Eric Davis | |
49 | 7 | Jean-Philippe Lang | h2. Issue tracking |
50 | 7 | Jean-Philippe Lang | |
51 | 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. |
52 | 7 | Jean-Philippe Lang | |
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 | 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. |
62 | 36 | Mischa The Evil | |
63 | 36 | Mischa The Evil | Once you've created a new tracker, you need to "activate" it for a specific project. |
64 | 36 | Mischa The Evil | |
65 | 36 | Mischa The Evil | Say you have created a tracker named 'Task' and you want the new tracker to be used for your project; |
66 | 36 | Mischa The Evil | * go to "(Project-)Settings -> tab 'Information' -> fieldset 'Trackers'", |
67 | 36 | Mischa The Evil | * check the checkbox of the new tracker 'Task', |
68 | 36 | Mischa The Evil | * and then click save. |
69 | 36 | Mischa The Evil | |
70 | 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. |
71 | 11 | Thomas Lecavelier | |
72 | 20 | Eric Davis | h3. How does "Related issues" work? |
73 | 20 | Eric Davis | |
74 | 20 | Eric Davis | Using Issue #100 as the one you set the relationship and Issue #101 as the "related to" |
75 | 20 | Eric Davis | |
76 | 20 | Eric Davis | * 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 | 24 | Jean-Philippe Lang | * 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 | 37 | Mischa The Evil | |
83 | 37 | Mischa The Evil | h3. The time calculations in "Spent time Reports" are wrong. |
84 | 37 | Mischa The Evil | |
85 | 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]]. |
86 | 37 | Mischa The Evil | |
87 | 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...??? |
88 | 37 | Mischa The Evil | |
89 | 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: |
90 | 37 | Mischa The Evil | ** 1.00 decimal equals 60 minutes (1 hour) |
91 | 37 | Mischa The Evil | ** 0.10 decimal equals 6 minutes |
92 | 37 | Mischa The Evil | ** 0.15 decimal equals 9 minutes |
93 | 37 | Mischa The Evil | ** 0.40 decimal equals 24 minutes |
94 | 37 | Mischa The Evil | ** 1.65 decimal equals 99 minutes |
95 | 37 | Mischa The Evil | ** 2.05 hours (125 minutes) equals 2.0833333333333335 (est.) in decimal notation |
96 | 37 | Mischa The Evil | |
97 | 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. |
98 | 37 | Mischa The Evil | |
99 | 37 | Mischa The Evil | Some references: |
100 | 37 | Mischa The Evil | * http://en.wikipedia.org/wiki/Decimal_time |
101 | 37 | Mischa The Evil | * http://www.springfrog.com/converter/decimal-time.htm |
102 | 37 | Mischa The Evil | |
103 | 12 | Jean-Philippe Lang | h2. Repositories |
104 | 12 | Jean-Philippe Lang | |
105 | 12 | Jean-Philippe Lang | h3. Commits don't show up in the activity until I click on 'Repository' |
106 | 12 | Jean-Philippe Lang | |
107 | 12 | Jean-Philippe Lang | By default, Redmine fetches the new commits from the repository only when you browse it. |
108 | 12 | Jean-Philippe Lang | |
109 | 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): |
110 | 12 | Jean-Philippe Lang | |
111 | 12 | Jean-Philippe Lang | ruby script/runner "Repository.fetch_changesets" -e production |
112 | 12 | Jean-Philippe Lang | |
113 | 19 | Thomas Lecavelier | h3. I can't browse my svn repository through redmine |
114 | 19 | Thomas Lecavelier | |
115 | 25 | Jean-Philippe Lang | Check the following: |
116 | 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. |
117 | 25 | Jean-Philippe Lang | * Make sure that the web app is able to run the svn binary |
118 | 25 | Jean-Philippe Lang | |
119 | 25 | Jean-Philippe Lang | If you're accessing the repository over HTTPS: |
120 | 25 | Jean-Philippe Lang | |
121 | 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. |
122 | 25 | Jean-Philippe Lang | |
123 | 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+. |
124 | 25 | Jean-Philippe Lang | Example: |
125 | 25 | Jean-Philippe Lang | |
126 | 25 | Jean-Philippe Lang | <pre> |
127 | 25 | Jean-Philippe Lang | $ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me |
128 | 25 | Jean-Philippe Lang | |
129 | 25 | Jean-Philippe Lang | Error validating server certificate for 'https://svn.mydomain.com:443': |
130 | 25 | Jean-Philippe Lang | - The certificate is not issued by a trusted authority. Use the |
131 | 25 | Jean-Philippe Lang | fingerprint to validate the certificate manually! |
132 | 25 | Jean-Philippe Lang | - The certificate hostname does not match. |
133 | 25 | Jean-Philippe Lang | - The certificate has expired. |
134 | 25 | Jean-Philippe Lang | Certificate information: |
135 | 25 | Jean-Philippe Lang | - Hostname: svn.mydomain.com |
136 | 25 | Jean-Philippe Lang | - Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT |
137 | 25 | Jean-Philippe Lang | - Issuer: mydomain.com, vrsource.org, Geneva, UN |
138 | 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 |
139 | 25 | Jean-Philippe Lang | (R)eject, accept (t)emporarily or accept (p)ermanently? p |
140 | 25 | Jean-Philippe Lang | </pre> |
141 | 19 | Thomas Lecavelier | |
142 | 26 | Jean-Philippe Lang | h3. Repository statistics doesn't show up |
143 | 26 | Jean-Philippe Lang | |
144 | 26 | Jean-Philippe Lang | There's a bug in rexml 3.1.7 provided with ruby 1.8.6. |
145 | 26 | Jean-Philippe Lang | In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app. |
146 | 26 | Jean-Philippe Lang | |
147 | 26 | Jean-Philippe Lang | See http://www.germane-software.com/projects/rexml/ticket/115 for details. |
148 | 26 | Jean-Philippe Lang | |
149 | 11 | Thomas Lecavelier | h2. Performance |
150 | 11 | Thomas Lecavelier | |
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 | 11 | Thomas Lecavelier | config.action_mailer.perform_deliveries = true |
156 | 11 | Thomas Lecavelier | |
157 | 11 | Thomas Lecavelier | to |
158 | 11 | Thomas Lecavelier | |
159 | 11 | Thomas Lecavelier | config.action_mailer.perform_deliveries = false |
160 | 11 | Thomas Lecavelier | |
161 | 11 | Thomas Lecavelier | and restart redmine. |
162 | 21 | Jean-Philippe Lang | |
163 | 29 | Thomas Lecavelier | h2. Miscellaneous |
164 | 21 | Jean-Philippe Lang | |
165 | 21 | Jean-Philippe Lang | h3. All times are off by 1 hour after the daylight savings switched |
166 | 21 | Jean-Philippe Lang | |
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 | 21 | Jean-Philippe Lang | |
170 | 1 | Jean-Philippe Lang | ruby script/plugin install tzinfo_timezone |
171 | 31 | Jean-Philippe Lang | |
172 | 31 | Jean-Philippe Lang | Do not install this plugin if you're using Rails 2.1. |
173 | 32 | Thomas Lecavelier | |
174 | 32 | Thomas Lecavelier | h3. What difference between Documents and Download? |
175 | 32 | Thomas Lecavelier | |
176 | 32 | Thomas Lecavelier | The "Documents" section is aimed to pusblish... documents as specification of the tracked project, or notice, or every documents that have not its place in a SCM. |
177 | 32 | Thomas Lecavelier | The "Download" section is aimed to publish... versions of the tracked project, as a bundle. |
178 | 33 | Jean-Philippe Lang | |
179 | 33 | Jean-Philippe Lang | h3. I get a 404 when I try to view or diff a php file |
180 | 33 | Jean-Philippe Lang | |
181 | 33 | Jean-Philippe Lang | It's because Apache is seeing .php and trying to run the php intreperter on the file. Since that url isn't a real file, it gets 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. |