FAQ » History » Version 40
Jean-Philippe Lang, 2008-12-30 12:14
email notifications
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 | 15 | Thomas Lecavelier | There's a bug in ruby/mysql adapter < 2.7.3 that leads to loose 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 | 12 | Jean-Philippe Lang | ruby script/runner "Repository.fetch_changesets" -e production |
94 | 12 | Jean-Philippe Lang | |
95 | 19 | Thomas Lecavelier | h3. I can't browse my svn repository through redmine |
96 | 19 | Thomas Lecavelier | |
97 | 25 | Jean-Philippe Lang | Check the following: |
98 | 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. |
99 | 25 | Jean-Philippe Lang | * Make sure that the web app is able to run the svn binary |
100 | 25 | Jean-Philippe Lang | |
101 | 25 | Jean-Philippe Lang | If you're accessing the repository over HTTPS: |
102 | 25 | Jean-Philippe Lang | |
103 | 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. |
104 | 25 | Jean-Philippe Lang | |
105 | 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+. |
106 | 25 | Jean-Philippe Lang | Example: |
107 | 25 | Jean-Philippe Lang | |
108 | 25 | Jean-Philippe Lang | <pre> |
109 | 25 | Jean-Philippe Lang | $ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me |
110 | 25 | Jean-Philippe Lang | |
111 | 25 | Jean-Philippe Lang | Error validating server certificate for 'https://svn.mydomain.com:443': |
112 | 25 | Jean-Philippe Lang | - The certificate is not issued by a trusted authority. Use the |
113 | 25 | Jean-Philippe Lang | fingerprint to validate the certificate manually! |
114 | 25 | Jean-Philippe Lang | - The certificate hostname does not match. |
115 | 25 | Jean-Philippe Lang | - The certificate has expired. |
116 | 25 | Jean-Philippe Lang | Certificate information: |
117 | 25 | Jean-Philippe Lang | - Hostname: svn.mydomain.com |
118 | 25 | Jean-Philippe Lang | - Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT |
119 | 25 | Jean-Philippe Lang | - Issuer: mydomain.com, vrsource.org, Geneva, UN |
120 | 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 |
121 | 25 | Jean-Philippe Lang | (R)eject, accept (t)emporarily or accept (p)ermanently? p |
122 | 25 | Jean-Philippe Lang | </pre> |
123 | 19 | Thomas Lecavelier | |
124 | 26 | Jean-Philippe Lang | h3. Repository statistics doesn't show up |
125 | 26 | Jean-Philippe Lang | |
126 | 26 | Jean-Philippe Lang | There's a bug in rexml 3.1.7 provided with ruby 1.8.6. |
127 | 26 | Jean-Philippe Lang | In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app. |
128 | 26 | Jean-Philippe Lang | |
129 | 26 | Jean-Philippe Lang | See http://www.germane-software.com/projects/rexml/ticket/115 for details. |
130 | 26 | Jean-Philippe Lang | |
131 | 11 | Thomas Lecavelier | h2. Performance |
132 | 11 | Thomas Lecavelier | |
133 | 14 | Jean-Philippe Lang | h3. When I create a new issue, Redmine freeze during one minute. |
134 | 11 | Thomas Lecavelier | |
135 | 40 | Jean-Philippe Lang | Make sure your SMTP server is properly configured or desactive *email notifications* (remove @config/email.yml@) and restart redmine. |
136 | 21 | Jean-Philippe Lang | |
137 | 1 | Jean-Philippe Lang | h2. Miscellaneous |
138 | 29 | Thomas Lecavelier | |
139 | 21 | Jean-Philippe Lang | h3. All times are off by 1 hour after the daylight savings switched |
140 | 21 | Jean-Philippe Lang | |
141 | 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/. |
142 | 31 | Jean-Philippe Lang | To do so, run the following from your Redmine directory: |
143 | 21 | Jean-Philippe Lang | |
144 | 21 | Jean-Philippe Lang | ruby script/plugin install tzinfo_timezone |
145 | 31 | Jean-Philippe Lang | |
146 | 40 | Jean-Philippe Lang | Do not install this plugin if you're using Redmine 0.8. |
147 | 32 | Thomas Lecavelier | |
148 | 38 | Mischa The Evil | h3. What is the difference between Documents and Files? |
149 | 32 | Thomas Lecavelier | |
150 | 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. |
151 | 38 | Mischa The Evil | The "Files" section is aimed to publish... versions of the tracked project, as a bundle (release). |
152 | 33 | Jean-Philippe Lang | |
153 | 38 | Mischa The Evil | h3. I get a 404-error when I try to view or diff a PHP-file |
154 | 33 | Jean-Philippe Lang | |
155 | 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. |
156 | 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. |