Project

General

Profile

ItFAQ » History » Version 2

Lorenzo Meneghetti, 2023-08-01 22:24

1 1 Lorenzo Meneghetti
h1. Frequently Asked Questions
2
3
{{TOC}}
4
5
h2. Installazione ed avvio di Redmine
6
7
8
h3. Dove posso trovare la tabella di compatibilità di Redmine con le varie versioni di Ruby e RubyOnRails?
9
10
Nella [[RedmineInstall|Installation]] sono riportate nei requirements le varie versioni di Ruby e RubyOnRails supportate dalle varie versioni di Redmine.
11
Se si intende installare una verione precedente di Redmine la scelta del framework RoR sarà per lo piu' obbligata.
12
13
14
h3. Quando faccio partire l'applicazione ottengo un errore: "in 'gem_original_require': no such file to load -- initializer (LoadError)"
15
16
Assicurarsi che "Ruby on Rails":http://rubyonrails.org/ sia correttamente installato nel proprio sistema.
17
18
19
h3. Quando faccio partire l'applicazione ottengo un errore: "cannot connect to mysql: No such file or directory - /tmp/mysql.sock"
20
21
occorre specificare i puntamenti del socket verso il DB in @config/database.yml@.
22
Vedi http://dev.rubyonrails.org/ticket/200.
23
24
25
h3. L'applicazione si congela dopo un lungo periodo di inattività
26
27
C'è un bug in ruby/mysql adapter < 2.7.3 che porta a perdere la connessione con il DB. Si prega di aggiornare il proprio _adapter_.
28
Puoi vedere la discussione a: http://rubyforge.org/forum/message.php?msg_id=25951.
29
30
31
h3. Perchè Redmine usa i link HTTP quando io invece voglio che usi i link HTTPS in Apache? (SSL)
32
33
Questo accade quando Apache manda le richieste ad un server di backend, come _mongrel_ o _thin_. Apache non dice al backend server di utilizzare https quindi i link sono generati non corretti. Aggiungere la seguente direttiva ad Apache:
34
35
    RequestHeader set X_FORWARDED_PROTO 'https'
36
37
o
38
39
    RequestHeader set X-Forwarded-Proto 'https'
40
41
42
h3. In presenza di una installazione con Passenger ottengo il seguente errore: ActionController::RoutingError (No route matches "/index.html" with {:method=>:get})
43
44
Apache interpreta erroneamente il file @public/.htaccess@ che è necessario per le installazioni (f)cgi. Puoi evitarlo o rimuovendo completamente il file (visto che non è richiesto di Passenger) o inserendo la seguente direttiva nel file di configurazione di Apache.
45
46
    AllowOverride None
47
48
49
50
h2. Gestione delle segnalazioni
51
52
h3. Ho creato un nuovo stato di una segnalazione ma non riesco ad utilizzarla, non viene mostrata nel corrispondente menu' a discesa.
53
54
Dopo aver creato un nuovo stato di una segnalazione devi includerlo nel workflow e metterlo a disposizione per il ruolo e per il tracker.
55
56
Supponiamo tu abbia creato un nuovo stato detto 'In esecuzione' e che tu voglia che i tuoi sviluppatori siano in grado di utilizzarlo quando devono far avanzare una segnalazione di un 'difetto' da 'Nuovo' ad 'In esecuzione'.
57
Vai in "Amministrazione -> Workflow", seleziona 'Difetto' e 'Sviluppatore', deseleziona 'Only display statuses that are used by this tracker' box poi clicca su 'modifica'.
58 2 Lorenzo Meneghetti
Ora vedrai tutte le transizioni di stato permesse per gli sviluppatori sulle segnalazioni con tyracker difetto. Nella riga in corrispondenza di 'Nuovo', clicca sul checkbox in corrispondenza della colonna 'In esecuzione' e salva.
59 1 Lorenzo Meneghetti
60
See [[RedmineIssueTrackingSetup|Workflow setup]].
61
62
h3. I've created a new tracker but I can't use it, it doesn't show up in the trackers drop-down list.
63
64
Once you've created a new tracker, you need to "activate" it for a specific project.
65
66
Say you have created a tracker named 'Task' and you want the new tracker to be used for your project;
67
* go to "(Project-)Settings -> tab 'Information' -> fieldset 'Trackers'",
68
* check the checkbox of the new tracker 'Task',
69
* and then click save.
70
71
You can now start using the new tracker 'Task' in the project for which you've just activated the new tracker.
72
73
h3. How does "Related issues" work?
74
75
See [[RedmineIssues#Related-issues]] for an in-depth explanation.
76
77
h2. Time tracking
78
79
h3. The time calculations in "Spent time Reports" are wrong.
80
81
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.
82
83
h2. Repositories
84
85
h3. Commits don't show up in the activity until I click on 'Repository'
86
87
By default, Redmine fetches the new commits from the repository only when you browse it.
88
89
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):
90
91
  rake -f /path/to/redmine/Rakefile RAILS_ENV=production redmine:fetch_changesets
92
93
For SVN repositories you can also add the following command to a post-commit hook:
94
95
  ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production
96
97
*Note, the second method of post-commit hook will slow down commits and could possibly cause commits to fail if Redmine is not functioning. 
98
99
You can bypass these disadvantages by sending the ruby-command to background.
100
101
  ruby /path_to_redmine/redmine/script/runner "Repository.fetch_changesets" -e production > /dev/null 2>&1 &
102
103
h3. I can't browse my svn repository through redmine
104
105
Check the following:
106
* 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.
107
* 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)
108
* 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.)
109
110
If you're accessing the repository over HTTPS:
111
112
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.
113
114
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+.
115
Example:
116
117
<pre>
118
$ svn --config-dir ./svn/.subversion co https://svn.mydomain.com/project/trunk delete-me
119
120
Error validating server certificate for 'https://svn.mydomain.com:443':
121
- The certificate is not issued by a trusted authority. Use the
122
fingerprint to validate the certificate manually!
123
- The certificate hostname does not match.
124
- The certificate has expired.
125
Certificate information:
126
- Hostname: svn.mydomain.com
127
- Valid: from Apr 8 12:00:00 2006 GMT until Sep 24 12:00:00 2010 GMT
128
- Issuer: mydomain.com, vrsource.org, Geneva, UN
129
- Fingerprint: 01:27:d9:6a:b8:db:63:f3:24:e3:41:c8:15:0a:f8:93:f6:7c:0f:11
130
(R)eject, accept (t)emporarily or accept (p)ermanently? p
131
</pre>
132
133
or modify subversion_adapter.rb in <redmine root>/lib/redmine/scm/adapters/subversion_adapter.rb
134
in credentials_string definition section chagne svn globaly options
135
from
136
<pre>
137
--no-auth-cache --non-interactive
138
</pre>
139
to
140
<pre>
141
--trust-server-cert --no-auth-cache --non-interactive
142
</pre>
143
For additional information on the problem, check your log file for problems encountered during the svn operation. (e.g. /log/production.log )
144
145
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.
146
147
h3. Repository statistics doesn't show up
148
149
* If you are using ruby 1.8.6:
150
There's a bug in rexml 3.1.7 provided with ruby 1.8.6. You can fix it yourself:
151
In @ruby/1.8/rexml/document.rb@ (line 186), change: @if transitive@ to @if trans@ then restart the app.
152
See http://www.germane-software.com/projects/rexml/ticket/115 for details.
153
* If you are using Internet Explorer:
154
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.
155
156
h2. Wikis
157
158
h3. How do I create sub-pages (parent/child relationships) in the wiki
159
160
See [[RedmineWikis#Creating-sub-pages-parentchild-relationships]] for an in-depth explanation.
161
162
h3. Global Wiki
163
164
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.
165
166
h2. Performance
167
168
h3. When I create a new issue, Redmine freezes for one minute.
169
170
Make sure your SMTP server is properly configured or deactivate *email notifications* (remove @config/email.yml@) and restart Redmine.
171
172
173
174
h2. Miscellanea
175
176
h3. Le emails usano un URL non corretto
177
178
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://").
179
180
h3. Email notifications are not working
181
182
First, try to send a test email: go to _"Administration -> Settings -> Email notifications"_ and click _"Send a test email"_.
183
It will send an email to the email address of your Redmine account:
184
* If you get an error, check your configuration in @config/configuration.yml@. See [[EmailConfiguration]].
185
* If you don't receive any email, check your SMTP server log to see if the email was properly relayed.
186
187
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@:
188
189
<pre>
190
config.action_mailer.logger = nil
191
</pre>
192
193
After restarting the application, every email sent will be dumped to your log file (@log/production.log@).
194
This way you can check the @To:@ field of emails to see if all the expected email addresses are present.
195
196
h3. All times are off by 1 hour after the daylight savings switched
197
198
Rails < 2.1 built-in time zone implementation doesn't handle DST. You have to install "TZInfo":http://tzinfo.rubyforge.org/.
199
To do so, run the following from your Redmine directory:
200
201
  ruby script/plugin install tzinfo_timezone
202
203
Do not install this plugin if you're using Redmine 0.8.
204
205
h3. What is the difference between Documents and Files?
206
207
The "Documents" section is for publishing specifications, notices, or other documents that do not belong in a SCM.
208
The "Files" section is for publishing versions of the tracked project, as a bundle (release).
209
210
h3. I get a 404-error when I try to view or diff a PHP-file
211
212
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.
213
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.
214
To do so, add the following lines to your virtual host configuration:
215
216
<pre><code>RemoveHandler .php
217
php_flag engine off    # Try without this line first
218
</code></pre>
219
220
h3. Why are Textile inline styles not working?
221
222
Textile inline styles were disabled starting from Redmine version#2 for security reasons (see #2416).
223
224
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 :
225
226
<pre>self.filter_styles=false</pre>
227
228
h3. Reset password lost without admin redmine account but with admin redmine database account
229
230
Found in file /app/models/user.rb: 'The hashed password is stored in the following form: SHA1\(salt + SHA1(password))'
231
So you can reset password in two steps:
232
- clear salt 
233
- calculate sha1(sha1(new_password))
234
For example for the password "password" (without quote) it will be "353e8061f2befecb6818ba0c034c632fb0bcae1b"
235
sah1(password)=0bd181063899c9239016320b50d3e896693a96df
236
sha1(0bd181063899c9239016320b50d3e896693a96df)=353e8061f2befecb6818ba0c034c632fb0bcae1b
237
238
You have to go to redmine database, find "users" table, find user to reset password, clear "salt" field's user and put "353e8061f2befecb6818ba0c034c632fb0bcae1b" in "hashed_password" field's user and log to redmine with new password 'password' (without quote). To do this redmine database changes, do the following from command line in the operating system where Redmine is working:
239
* note user and password from a file config/database.yml.
240
* For MySQL
241
** execute command: @mysql -u <db user from database.yml> -p@
242
** enter: <password from database.yml>
243
** execute: @UPDATE users SET hashed_password='353e8061f2befecb6818ba0c034c632fb0bcae1b' WHERE login='admin';@
244
** execute: @UPDATE users SET salt='' WHERE login='admin';@
245
** execute: @exit@ 
246
247
Now you can go to Redmine login web page to login as user admin with 'password' as password.
248
249
h3. Redirections after editing some content (e.g. versions) are incorrect when using FireFox >= 28
250
251
Redmine uses the HTTP referrer, specifically including the @path@ part of it, for correct redirection after editing some content (e.g. versions). Whenever the @path@ is not available, redirections will not work as expected (e.g. you are being redirected to the Home page instead of the Roadmap or project versions page); see #18058.
252
Mozilla Firefox 28 introduced a set of new settings (see changeset "e544d02(in Firefox SCM)":https://hg.mozilla.org/mozilla-central/rev/e544d028da74 and "this third-party summary":http://seenthis.net/sites/484641) to limit the default behavior for sending of HTTP referrers (see issue "822869(in Firefox bug tracker)":https://bugzilla.mozilla.org/show_bug.cgi?id=822869). At least one of them, namely @network.http.referer.trimmingPolicy@, is confirmed to break some redirections within Redmine after editing some content whenever its default value of '@0@' is changed and set to '@2@'. In that case the @path@ part is omitted in the HTTP referrers.
253
Changing this value to either '@0@' or '@1@' fixes the incorrect redirection behavior, as the @path@ part is included in the referrer with both those values.