FAQ » History » Version 80
Daniel Widerin, 2010-09-10 11:05
bypass disadvantages of post-commit by sending ruby-command to background
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 | 60 | Daniel Jones | h3. Does Redmine work 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 | 80 | Daniel Widerin | You can bypass these disadvantages by sending the ruby-command to background. |
102 | 79 | Daniel Widerin | |
103 | ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production > /dev/null 2>&1 & |
||
104 | |||
105 | 19 | Thomas Lecavelier | h3. I can't browse my svn repository through redmine |
106 | |||
107 | 25 | Jean-Philippe Lang | Check the following: |
108 | * 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. |
||
109 | 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) |
110 | 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.) |
111 | 25 | Jean-Philippe Lang | |
112 | If you're accessing the repository over HTTPS: |
||
113 | |||
114 | 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. |
||
115 | |||
116 | 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+. |
||
117 | Example: |
||
118 | |||
119 | <pre> |
||
120 | $ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me |
||
121 | |||
122 | Error validating server certificate for 'https://svn.mydomain.com:443': |
||
123 | - The certificate is not issued by a trusted authority. Use the |
||
124 | fingerprint to validate the certificate manually! |
||
125 | - The certificate hostname does not match. |
||
126 | - The certificate has expired. |
||
127 | Certificate information: |
||
128 | - Hostname: svn.mydomain.com |
||
129 | - Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT |
||
130 | - Issuer: mydomain.com, vrsource.org, Geneva, UN |
||
131 | - Fingerprint: 01:27:d9:6a:b8:db:63:f3:24:e3:41:c8:15:0a:f8:93:f6:7c:0f:11 |
||
132 | (R)eject, accept (t)emporarily or accept (p)ermanently? p |
||
133 | 1 | Jean-Philippe Lang | </pre> |
134 | 55 | Alex Ford | |
135 | 56 | Ki Won Kim | or modify subversion_adapter.rb in <redmine root>/lib/redmine/scm/adapters/subversion_adapter.rb |
136 | in credentials_string definition section chagne svn globaly options |
||
137 | from |
||
138 | <pre> |
||
139 | --no-auth-cache --non-interactive |
||
140 | </pre> |
||
141 | to |
||
142 | <pre> |
||
143 | --trust-server-cert --no-auth-cache --non-interactive |
||
144 | </pre> |
||
145 | 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 ) |
146 | 19 | Thomas Lecavelier | |
147 | 71 | Roger Lipscombe | or list the certificate in @/etc/subversion/servers@. See http://www.geekforgod.com/2006/12/01/making-svn-trust-a-new-root-ca-certificate/ for details. |
148 | |||
149 | 26 | Jean-Philippe Lang | h3. Repository statistics doesn't show up |
150 | 44 | Mischa The Evil | |
151 | * If you are using ruby 1.8.6: |
||
152 | There's a bug in rexml 3.1.7 provided with ruby 1.8.6. You can fix it yourself: |
||
153 | 1 | Jean-Philippe Lang | In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app. |
154 | 26 | Jean-Philippe Lang | See http://www.germane-software.com/projects/rexml/ticket/115 for details. |
155 | 44 | Mischa The Evil | * If you are using Internet Explorer: |
156 | 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. |
||
157 | 26 | Jean-Philippe Lang | |
158 | 42 | Mischa The Evil | h2. Wikis |
159 | |||
160 | h3. How do I create sub-pages (parent/child relationships) in the wiki |
||
161 | |||
162 | Looking at http://www.redmine.org/wiki/redmine/Page_index/special it is possible to make use of some sort of sub-paging like: |
||
163 | > * Guide |
||
164 | > ** RedmineAccounts |
||
165 | > ** RedmineCustomFields |
||
166 | > ** RedmineInstall |
||
167 | > ** RedmineIssueList |
||
168 | > ** RedmineIssues |
||
169 | 63 | Mischa The Evil | |
170 | 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. |
171 | 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. |
||
172 | |||
173 | 78 | Felix Schäfer | h3. Global Wiki |
174 | |||
175 | There is currently no global wiki, and the current permission system won't allow one. A workaround is to create a project, if needed only with a wiki, and to use it for all global needs. |
||
176 | |||
177 | 11 | Thomas Lecavelier | h2. Performance |
178 | |||
179 | 49 | Greg Mefford | h3. When I create a new issue, Redmine freezes for one minute. |
180 | 11 | Thomas Lecavelier | |
181 | 49 | Greg Mefford | Make sure your SMTP server is properly configured or deactivate *email notifications* (remove @config/email.yml@) and restart Redmine. |
182 | 21 | Jean-Philippe Lang | |
183 | 1 | Jean-Philippe Lang | h2. Miscellaneous |
184 | 29 | Thomas Lecavelier | |
185 | 48 | Eric Davis | h3. Emails use the incorrect url |
186 | |||
187 | 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). |
||
188 | |||
189 | 62 | Mischa The Evil | h3. Email notifications are not working |
190 | |||
191 | First, try to send a test email: go to _"Administration -> Settings -> Email notifications"_ and click _"Send a test email"_. |
||
192 | It will send an email to the email address of your Redmine account: |
||
193 | * If you get an error, check your configuration in @config/email.yml@. |
||
194 | * If you don't receive any email, check your SMTP server log to see if the email was properly relayed. |
||
195 | |||
196 | 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@: |
||
197 | |||
198 | <pre> |
||
199 | config.action_mailer.logger = nil |
||
200 | </pre> |
||
201 | |||
202 | After restarting the application, every email sent will be dumped to your log file (@log/production.log@). |
||
203 | This way you can check the @To:@ field of emails to see if all the expected email addresses are present. |
||
204 | |||
205 | 21 | Jean-Philippe Lang | h3. All times are off by 1 hour after the daylight savings switched |
206 | |||
207 | Rails < 2.1 built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/. |
||
208 | 31 | Jean-Philippe Lang | To do so, run the following from your Redmine directory: |
209 | 21 | Jean-Philippe Lang | |
210 | ruby script/plugin install tzinfo_timezone |
||
211 | 31 | Jean-Philippe Lang | |
212 | 54 | Jean-Philippe Lang | Do not install this plugin if you're using Redmine 0.8. |
213 | |||
214 | h3. What is the difference between Documents and Files? |
||
215 | |||
216 | The "Documents" section is for publishing specifications, notices, or other documents that do not belong in a SCM. |
||
217 | The "Files" section is for publishing versions of the tracked project, as a bundle (release). |
||
218 | |||
219 | h3. I get a 404-error when I try to view or diff a PHP-file |
||
220 | |||
221 | 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. |
||
222 | 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. |
||
223 | To do so, add the following lines to your virtual host configuration: |
||
224 | |||
225 | <pre><code>RemoveHandler .php |
||
226 | 1 | Jean-Philippe Lang | php_flag engine off # Try without this line first |
227 | </code></pre> |
||
228 | 64 | Mischa The Evil | |
229 | h3. Why are Textile inline styles not working? |
||
230 | |||
231 | Textile inline styles were disabled starting from Redmine version#2 for security reasons (see #2416). |
||
232 | |||
233 | If you really need this feature and don't fear XSS attacks, then you'll need to manually change the Redmine source (source:/trunk/lib/redmine/wiki_formatting/textile/formatter.rb@2192#L33). |