FAQ » History » Version 54
Jean-Philippe Lang, 2009-11-05 21:05
Email notifications are not working
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 | 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 | 52 | George Montana Harkin | |
101 | 19 | Thomas Lecavelier | h3. I can't browse my svn repository through redmine |
102 | 19 | Thomas Lecavelier | |
103 | 25 | Jean-Philippe Lang | Check the following: |
104 | 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. |
105 | 53 | Jan from Planio www.plan.io | * Make sure that the web app is able to run the svn binary. |
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 | 25 | Jean-Philippe Lang | If you're accessing the repository over HTTPS: |
109 | 25 | Jean-Philippe Lang | |
110 | 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. |
111 | 25 | Jean-Philippe Lang | |
112 | 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+. |
113 | 25 | Jean-Philippe Lang | Example: |
114 | 25 | Jean-Philippe Lang | |
115 | 25 | Jean-Philippe Lang | <pre> |
116 | 25 | Jean-Philippe Lang | $ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me |
117 | 25 | Jean-Philippe Lang | |
118 | 25 | Jean-Philippe Lang | Error validating server certificate for 'https://svn.mydomain.com:443': |
119 | 25 | Jean-Philippe Lang | - The certificate is not issued by a trusted authority. Use the |
120 | 25 | Jean-Philippe Lang | fingerprint to validate the certificate manually! |
121 | 25 | Jean-Philippe Lang | - The certificate hostname does not match. |
122 | 25 | Jean-Philippe Lang | - The certificate has expired. |
123 | 25 | Jean-Philippe Lang | Certificate information: |
124 | 25 | Jean-Philippe Lang | - Hostname: svn.mydomain.com |
125 | 25 | Jean-Philippe Lang | - Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT |
126 | 25 | Jean-Philippe Lang | - Issuer: mydomain.com, vrsource.org, Geneva, UN |
127 | 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 |
128 | 25 | Jean-Philippe Lang | (R)eject, accept (t)emporarily or accept (p)ermanently? p |
129 | 25 | Jean-Philippe Lang | </pre> |
130 | 19 | Thomas Lecavelier | |
131 | 26 | Jean-Philippe Lang | h3. Repository statistics doesn't show up |
132 | 44 | Mischa The Evil | |
133 | 44 | Mischa The Evil | * If you are using ruby 1.8.6: |
134 | 44 | Mischa The Evil | There's a bug in rexml 3.1.7 provided with ruby 1.8.6. You can fix it yourself: |
135 | 1 | Jean-Philippe Lang | In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app. |
136 | 26 | Jean-Philippe Lang | See http://www.germane-software.com/projects/rexml/ticket/115 for details. |
137 | 44 | Mischa The Evil | * If you are using Internet Explorer: |
138 | 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. |
139 | 26 | Jean-Philippe Lang | |
140 | 42 | Mischa The Evil | h2. Wikis |
141 | 42 | Mischa The Evil | |
142 | 42 | Mischa The Evil | h3. How do I create sub-pages (parent/child relationships) in the wiki |
143 | 42 | Mischa The Evil | |
144 | 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: |
145 | 42 | Mischa The Evil | > * Guide |
146 | 42 | Mischa The Evil | > ** RedmineAccounts |
147 | 42 | Mischa The Evil | > ** RedmineCustomFields |
148 | 42 | Mischa The Evil | > ** RedmineInstall |
149 | 42 | Mischa The Evil | > ** RedmineIssueList |
150 | 42 | Mischa The Evil | > ** RedmineIssues |
151 | 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. |
152 | 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. |
153 | 42 | Mischa The Evil | |
154 | 11 | Thomas Lecavelier | h2. Performance |
155 | 11 | Thomas Lecavelier | |
156 | 49 | Greg Mefford | h3. When I create a new issue, Redmine freezes for one minute. |
157 | 11 | Thomas Lecavelier | |
158 | 49 | Greg Mefford | Make sure your SMTP server is properly configured or deactivate *email notifications* (remove @config/email.yml@) and restart Redmine. |
159 | 21 | Jean-Philippe Lang | |
160 | 1 | Jean-Philippe Lang | h2. Miscellaneous |
161 | 29 | Thomas Lecavelier | |
162 | 48 | Eric Davis | h3. Emails use the incorrect url |
163 | 48 | Eric Davis | |
164 | 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). |
165 | 48 | Eric Davis | |
166 | 21 | Jean-Philippe Lang | h3. All times are off by 1 hour after the daylight savings switched |
167 | 21 | Jean-Philippe Lang | |
168 | 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/. |
169 | 31 | Jean-Philippe Lang | To do so, run the following from your Redmine directory: |
170 | 21 | Jean-Philippe Lang | |
171 | 21 | Jean-Philippe Lang | ruby script/plugin install tzinfo_timezone |
172 | 31 | Jean-Philippe Lang | |
173 | 40 | Jean-Philippe Lang | Do not install this plugin if you're using Redmine 0.8. |
174 | 32 | Thomas Lecavelier | |
175 | 38 | Mischa The Evil | h3. What is the difference between Documents and Files? |
176 | 32 | Thomas Lecavelier | |
177 | 50 | Greg Mefford | The "Documents" section is for publishing specifications, notices, or other documents that do not belong in a SCM. |
178 | 50 | Greg Mefford | The "Files" section is for publishing versions of the tracked project, as a bundle (release). |
179 | 33 | Jean-Philippe Lang | |
180 | 38 | Mischa The Evil | h3. I get a 404-error when I try to view or diff a PHP-file |
181 | 33 | Jean-Philippe Lang | |
182 | 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. |
183 | 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. |
184 | 51 | Eric Davis | To do so, add the following lines to your virtual host configuration: |
185 | 1 | Jean-Philippe Lang | |
186 | 51 | Eric Davis | <pre><code>RemoveHandler .php |
187 | 51 | Eric Davis | php_flag engine off # Try without this line first |
188 | 51 | Eric Davis | </code></pre> |
189 | 54 | Jean-Philippe Lang | |
190 | 54 | Jean-Philippe Lang | h3. Email notifications are not working |
191 | 54 | Jean-Philippe Lang | |
192 | 54 | Jean-Philippe Lang | First, try to send a test email: go to _"Administration -> Settings -> Email notifications"_ and click _"Send a test email"_. |
193 | 54 | Jean-Philippe Lang | It will send an email to the email address of your Redmine account: |
194 | 54 | Jean-Philippe Lang | * If you get an error, check your configuration in @config/email.yml@. |
195 | 54 | Jean-Philippe Lang | * If you don't receive any email, check your SMTP server log to see if the email was properly relayed. |
196 | 54 | Jean-Philippe Lang | |
197 | 54 | Jean-Philippe Lang | 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@: |
198 | 54 | Jean-Philippe Lang | |
199 | 54 | Jean-Philippe Lang | <pre> |
200 | 54 | Jean-Philippe Lang | config.action_mailer.logger = nil |
201 | 54 | Jean-Philippe Lang | </pre> |
202 | 54 | Jean-Philippe Lang | |
203 | 54 | Jean-Philippe Lang | After restarting the application, every email sent will be dumped to your log file (@log/production.log@). |
204 | 54 | Jean-Philippe Lang | This way you can check the @To:@ field of emails to see if all the expected email addresses are present. |