FAQ » History » Version 102
Dieter Egert, 2012-03-25 20:17
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 | 84 | Holger Just | h3. I get this error message with a Passenger deployment: ActionController::RoutingError (No route matches "/index.html" with {:method=>:get}) |
32 | |||
33 | Your Apache erroneously interprets the @public/.htaccess@ file which is needed for (f)cgi deployments. You can stop that by eiter completely removing the file (as it is not needed by Passenger) or by inserting the following configuration directive to Apache. |
||
34 | |||
35 | AllowOverride None |
||
36 | |||
37 | 7 | Jean-Philippe Lang | h2. Issue tracking |
38 | |||
39 | 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. |
||
40 | |||
41 | 8 | Jean-Philippe Lang | Once you've created a new issue status, you need to include it in the workflow. |
42 | 7 | Jean-Philippe Lang | |
43 | 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'. |
44 | 85 | JC Wren | Go to "Administration -> Workflow", select 'Bug' and 'Developer', uncheck the 'Only display statuses that are used by this tracker' box then click edit. |
45 | 86 | JC Wren | You now see all the transitions allowed for developers on bugs. In the 'New' row, click the checkbox in the 'In progress' column and save. |
46 | 13 | Jean-Philippe Lang | |
47 | 1 | Jean-Philippe Lang | See [[RedmineIssueTrackingSetup|Workflow setup]]. |
48 | 36 | Mischa The Evil | |
49 | h3. I've created a new tracker but I can't use it, it doesn't show up in the trackers drop-down list. |
||
50 | |||
51 | Once you've created a new tracker, you need to "activate" it for a specific project. |
||
52 | |||
53 | Say you have created a tracker named 'Task' and you want the new tracker to be used for your project; |
||
54 | * go to "(Project-)Settings -> tab 'Information' -> fieldset 'Trackers'", |
||
55 | * check the checkbox of the new tracker 'Task', |
||
56 | * and then click save. |
||
57 | |||
58 | You can now start using the new tracker 'Task' in the project for which you've just activated the new tracker. |
||
59 | 11 | Thomas Lecavelier | |
60 | 20 | Eric Davis | h3. How does "Related issues" work? |
61 | |||
62 | 82 | Mischa The Evil | See [[RedmineIssues#Related-issues]] for an in-depth explanation. |
63 | 20 | Eric Davis | |
64 | 37 | Mischa The Evil | h2. Time tracking |
65 | |||
66 | h3. The time calculations in "Spent time Reports" are wrong. |
||
67 | |||
68 | 81 | Mischa The Evil | You are probably entering spent-time values in Redmine using "decimal time format":http://en.wikipedia.org/wiki/Decimal_time. See [[RedmineTimeTracking#Decimal-time-format]] for an in-depth explanation. |
69 | 37 | Mischa The Evil | |
70 | 12 | Jean-Philippe Lang | h2. Repositories |
71 | |||
72 | h3. Commits don't show up in the activity until I click on 'Repository' |
||
73 | |||
74 | By default, Redmine fetches the new commits from the repository only when you browse it. |
||
75 | |||
76 | 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): |
||
77 | |||
78 | 87 | Patrick Meidl | rake -f /path/to/redmine/Rakefile RAILS_ENV=production redmine:fetch_changesets |
79 | 12 | Jean-Philippe Lang | |
80 | 47 | Marco Bernasocchi | For SVN repositories you can also add the following command to a post-commit hook: |
81 | |||
82 | ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production |
||
83 | |||
84 | 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. |
85 | |||
86 | 80 | Daniel Widerin | You can bypass these disadvantages by sending the ruby-command to background. |
87 | 79 | Daniel Widerin | |
88 | ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production > /dev/null 2>&1 & |
||
89 | |||
90 | 19 | Thomas Lecavelier | h3. I can't browse my svn repository through redmine |
91 | |||
92 | 25 | Jean-Philippe Lang | Check the following: |
93 | * 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. |
||
94 | 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) |
95 | 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.) |
96 | 25 | Jean-Philippe Lang | |
97 | If you're accessing the repository over HTTPS: |
||
98 | |||
99 | 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. |
||
100 | |||
101 | 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+. |
||
102 | Example: |
||
103 | |||
104 | <pre> |
||
105 | $ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me |
||
106 | |||
107 | Error validating server certificate for 'https://svn.mydomain.com:443': |
||
108 | - The certificate is not issued by a trusted authority. Use the |
||
109 | fingerprint to validate the certificate manually! |
||
110 | - The certificate hostname does not match. |
||
111 | - The certificate has expired. |
||
112 | Certificate information: |
||
113 | - Hostname: svn.mydomain.com |
||
114 | - Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT |
||
115 | - Issuer: mydomain.com, vrsource.org, Geneva, UN |
||
116 | - Fingerprint: 01:27:d9:6a:b8:db:63:f3:24:e3:41:c8:15:0a:f8:93:f6:7c:0f:11 |
||
117 | (R)eject, accept (t)emporarily or accept (p)ermanently? p |
||
118 | 1 | Jean-Philippe Lang | </pre> |
119 | 55 | Alex Ford | |
120 | 56 | Ki Won Kim | or modify subversion_adapter.rb in <redmine root>/lib/redmine/scm/adapters/subversion_adapter.rb |
121 | in credentials_string definition section chagne svn globaly options |
||
122 | from |
||
123 | <pre> |
||
124 | --no-auth-cache --non-interactive |
||
125 | </pre> |
||
126 | to |
||
127 | <pre> |
||
128 | --trust-server-cert --no-auth-cache --non-interactive |
||
129 | </pre> |
||
130 | 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 ) |
131 | 19 | Thomas Lecavelier | |
132 | 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. |
133 | |||
134 | 26 | Jean-Philippe Lang | h3. Repository statistics doesn't show up |
135 | 44 | Mischa The Evil | |
136 | * If you are using ruby 1.8.6: |
||
137 | There's a bug in rexml 3.1.7 provided with ruby 1.8.6. You can fix it yourself: |
||
138 | 1 | Jean-Philippe Lang | In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app. |
139 | 26 | Jean-Philippe Lang | See http://www.germane-software.com/projects/rexml/ticket/115 for details. |
140 | 44 | Mischa The Evil | * If you are using Internet Explorer: |
141 | 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. |
||
142 | 26 | Jean-Philippe Lang | |
143 | 42 | Mischa The Evil | h2. Wikis |
144 | |||
145 | h3. How do I create sub-pages (parent/child relationships) in the wiki |
||
146 | |||
147 | 83 | Mischa The Evil | See [[RedmineWikis#Creating-sub-pages-parentchild-relationships]] for an in-depth explanation. |
148 | 42 | Mischa The Evil | |
149 | 78 | Felix Schäfer | h3. Global Wiki |
150 | |||
151 | 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. |
||
152 | |||
153 | 11 | Thomas Lecavelier | h2. Performance |
154 | |||
155 | 49 | Greg Mefford | h3. When I create a new issue, Redmine freezes for one minute. |
156 | 11 | Thomas Lecavelier | |
157 | 49 | Greg Mefford | Make sure your SMTP server is properly configured or deactivate *email notifications* (remove @config/email.yml@) and restart Redmine. |
158 | 21 | Jean-Philippe Lang | |
159 | 1 | Jean-Philippe Lang | h2. Miscellaneous |
160 | 29 | Thomas Lecavelier | |
161 | 48 | Eric Davis | h3. Emails use the incorrect url |
162 | |||
163 | 101 | Mischa The Evil | The urls used in email is configured with the *[[RedmineSettings#Host-name-and-path|Host name and path]]* setting in Administration > Settings > General tab. It defaults to localhost:3000 (Ruby on Rails default). It should not include the protocol handler ("http://"). |
164 | 48 | Eric Davis | |
165 | 62 | Mischa The Evil | h3. Email notifications are not working |
166 | |||
167 | First, try to send a test email: go to _"Administration -> Settings -> Email notifications"_ and click _"Send a test email"_. |
||
168 | It will send an email to the email address of your Redmine account: |
||
169 | 88 | Justin M | * If you get an error, check your configuration in @config/configuration.yml@. See [[EmailConfiguration]]. |
170 | 62 | Mischa The Evil | * If you don't receive any email, check your SMTP server log to see if the email was properly relayed. |
171 | |||
172 | 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@: |
||
173 | |||
174 | <pre> |
||
175 | config.action_mailer.logger = nil |
||
176 | </pre> |
||
177 | |||
178 | After restarting the application, every email sent will be dumped to your log file (@log/production.log@). |
||
179 | This way you can check the @To:@ field of emails to see if all the expected email addresses are present. |
||
180 | |||
181 | 21 | Jean-Philippe Lang | h3. All times are off by 1 hour after the daylight savings switched |
182 | |||
183 | Rails < 2.1 built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/. |
||
184 | 31 | Jean-Philippe Lang | To do so, run the following from your Redmine directory: |
185 | 21 | Jean-Philippe Lang | |
186 | ruby script/plugin install tzinfo_timezone |
||
187 | 31 | Jean-Philippe Lang | |
188 | 54 | Jean-Philippe Lang | Do not install this plugin if you're using Redmine 0.8. |
189 | |||
190 | h3. What is the difference between Documents and Files? |
||
191 | |||
192 | The "Documents" section is for publishing specifications, notices, or other documents that do not belong in a SCM. |
||
193 | The "Files" section is for publishing versions of the tracked project, as a bundle (release). |
||
194 | |||
195 | h3. I get a 404-error when I try to view or diff a PHP-file |
||
196 | |||
197 | 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. |
||
198 | 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. |
||
199 | To do so, add the following lines to your virtual host configuration: |
||
200 | |||
201 | <pre><code>RemoveHandler .php |
||
202 | 1 | Jean-Philippe Lang | php_flag engine off # Try without this line first |
203 | </code></pre> |
||
204 | 64 | Mischa The Evil | |
205 | h3. Why are Textile inline styles not working? |
||
206 | |||
207 | Textile inline styles were disabled starting from Redmine version#2 for security reasons (see #2416). |
||
208 | |||
209 | 102 | Dieter Egert | If you really need this feature and don't fear XSS attacks as you don't have projects with public write access, then you'll need to manually change the Redmine source (source:/trunk/lib/redmine/wiki_formatting/textile/formatter.rb@2192#L33), or you change this in /lib/redmine/wiki_formatting/textile/formatter.rb : |
210 | |||
211 | <pre>self.filter_styles=false</pre> |