FAQ » History » Version 36

Mischa The Evil, 2008-12-01 00:35
Added FAQ item about "activation" of newly created trackers for projects

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