Project

General

Profile

DeRedmineInstall » History » Version 33

C S, 2021-01-14 11:03
Übersetzung bis Schritt 2 auf Basis 314 fertig gestellt

1 1 Robert Schneider
{{>toc}}
2 14 Robert Schneider
3 32 C S
Übersetzung von "Rev. 314":http://www.redmine.org/projects/redmine/wiki/RedmineInstall/314
4 14 Robert Schneider
5
h1. Installation von Redmine
6 1 Robert Schneider
7 32 C S
Dies ist die Installationsanleitung für Redmine 4.0 und höher. 
8
* Ältere Anleitungen in Deutsch: "1.4.0":https://redmine.org/projects/redmine/wiki/DeRedmineInstall/31
9
* Originale Anleitungen in Englisch: "3.x":https://redmine.org/projects/redmine/wiki/RedmineInstall/308 , "1.4.x - 2.6.x":https://redmine.org/projects/redmine/wiki/RedmineInstall/263 , "1-3-x":https://redmine.org/projects/redmine/wiki/RedmineInstall?version=146 
10 2 Robert Schneider
11
h2. Anforderungen
12 1 Robert Schneider
13 2 Robert Schneider
h3. Betriebssystem
14
15 32 C S
Redmine sollte auf den meisten Unix-, Linux-, [[RedmineInstallOSX|Mac]]-, und [[RedmineInstall#Notes-on-Windows-installation|Windows]]-Systemen laufen, sofern Ruby auf diesem System vorhanden ist. Weitere spezielle Installationsanleitungen finden sich  [[HowTos|hier]].
16 2 Robert Schneider
17 1 Robert Schneider
h3. Ruby-Interpreter
18
19
Die erforderliche Ruby-Version für die Redmine-Versionen sind:
20 2 Robert Schneider
21 1 Robert Schneider
|_. Redmine-Version|_. Unterstützte Ruby-Versionen                                |_. Verwendete Rails-Version|
22 32 C S
|trunk (>= "r20154":https://redmine.org/projects/redmine/repository/revisions/20154 )   |Ruby 2.4, 2.5, 2.6, 2.7[1]                      |Rails 5.2      |
23
|4.1               |Ruby 2.3, 2.4, 2.5, 2.6                      |Rails 5.2      |
24
|4.0               |Ruby 2.2[2], 2.3, 2.4, 2.5, 2.6|Rails 5.2         |
25 1 Robert Schneider
26 32 C S
fn1. Ruby 2.7.0 und 2.7.1 werden nicht unterstützt. Bitte Ruby 2.7.2 oder höher benutzen (siehe auch #31500#note-13)
27 27 Robert Schneider
28 32 C S
fn2. Redmine Version vor 4.0.6 unterstützen Ruby 2.2.2, alle Versionen ab 4.0.6 unterstützen Ruby 2.2.x nicht mehr (Siehe #32787).
29 2 Robert Schneider
30 32 C S
*Wichtige Hinweise:*
31 2 Robert Schneider
32 32 C S
* %{color:red}Die Unterstützung von Ruby 2.4 und früheren Versionen wurde von der Ruby-Community beendet.% Einzelheiten finden Sie in den offiziellen Ankündigungen: "2.2":https://www.ruby-lang.org/en/news/2018/06/20/support-of-ruby-2-2-has-ended/ , "2.3":https://www.ruby-lang.org/en/news/2019/03/31/support-of-ruby-2-3-has-ended/ , "2.4":https://www.ruby-lang.org/en/news/2020/04/05/support-of-ruby-2-4-has-ended/ 
33
* *Redmine unterstützt kein JRuby* da @"activerecord-jdbc-adapter":https://github.com/jruby/activerecord-jdbc-adapter/issues/599 @ und @"loofah":https://github.com/flavorjones/loofah/issues/88 @ kein Rails 4.2 oder später unterstützen
34 2 Robert Schneider
35 1 Robert Schneider
h3. Unterstützte Datenbanken
36
37 33 C S
* MySQL 5.5 - 5.7
38
** *MySQL 5.6 und höher* sowie *MariaDB* haben bekannte Probleme (#19344, #19395, #17460).
39 3 Robert Schneider
40 33 C S
* PostgreSQL 9.2 oder höher
41
** Der Datenstyle der Datenbank sollte auf ISO gesetzt sein (Standardeinstellung bei PorgresSQL). Dies kann mit @ALTER DATABASE "redmine_db" SET datestyle="ISO,MDY";@ erreicht werden.
42 3 Robert Schneider
43 33 C S
* Microsoft SQL Server "2012 oder höher":https://github.com/rails-sqlserver/activerecord-sqlserver-adapter/blob/v4.2.3/README.md#activerecord-sql-server-adapter-for-sql-server-2012-and-higher
44
** Redmine 4.0.0 bis 4.0.6 sowie 4.1.0 unterstützen kein SQL Server (#30285, #32737)
45 3 Robert Schneider
46
* SQLite 3 (nicht für den Produktiveinsatz mit mehreren Benutzern gedacht!)
47 1 Robert Schneider
48 3 Robert Schneider
h3. Optionale Komponenten
49 4 Robert Schneider
50
* SCM-Programme (z.B. @svn@) für das Browsen in Projektarchiven. [[RedmineRepositories]] enthält Informationen zu Kompatibilitäten und Anforderungen.
51
* "ImageMagick":http://www.imagemagick.org/ (um den Gantt-Export zu PNG-Bildern und die Generierung von Vorschaubildern zu ermöglichen).
52 33 C S
* "Ghostscript":https://www.ghostscript.com/ (Ermöglicht die Generierung von Minaturansichten für PDF Anhänge ab Redmine 4.1)
53 4 Robert Schneider
54 6 Robert Schneider
h2. Redmine-Version
55
56 1 Robert Schneider
Dem Großteil der Benutzer wird im Allgemeinen empfohlen, die entsprechenden Point-Releases zu installieren. Derzeit veröffentlicht Redmine alle sechs Monate eine neue Version - diese Veröffentlichungen werden als relativ gut einsetzbar und als stabil erachtet. Es wird *nicht* empfohlen Redmine von Trunk zu installieren, außer man ist mit Ruby on Rails sehr vertraut und bleibt mit den Änderungen auf dem letzten Stand - der Trunk-Zweig _kann zuweilen_ auch Fehler enthalten.
57
58
h2. Ablauf der Installation
59
60 33 C S
h3. Schritt 1 - Redmine beziehen
61 1 Robert Schneider
62 33 C S
Der Source-Code von Redmine kann entweder durch das Herunterladen eines gepackten Releases oder durch das Auschecken des Codes bezogen werden.
63 1 Robert Schneider
64 6 Robert Schneider
Mehr Informationen auf der [[Download|Download-Seite]].
65 7 Robert Schneider
66
h3. Schritt 2 - Eine leere Datenbank erstellen und einen Benutzer zuweisen
67
68
Nach den folgenden Anweisungen heißt der Datenbankbenutzer von Redmine @redmine@, jedoch kann der Name auch geändert werden.
69
70
h4. MySQL
71 1 Robert Schneider
72 7 Robert Schneider
<pre><code class="sql">
73 33 C S
CREATE DATABASE redmine CHARACTER SET utf8mb4;
74
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
75
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
76
</code></pre>
77
78
Für die MySQL Versionen "5.5.2":https://docs.oracle.com/cd/E17952_01/mysql-5.0-en/grant.html und früher - Bitte *@utf8@* statt @utf8mb4@ nutzen:
79
80
<pre><code class="sql">
81 7 Robert Schneider
CREATE DATABASE redmine CHARACTER SET utf8;
82 1 Robert Schneider
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
83
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
84
</code></pre>
85
86 33 C S
Für die MySQL Versionen "5.0.2":https://docs.oracle.com/cd/E17952_01/mysql-5.0-en/grant.html und früher - Bitte *@'CREATE USER'@* überspringen:
87 7 Robert Schneider
88
<pre><code class="sql">
89 33 C S
CREATE DATABASE redmine CHARACTER SET utf8;
90 7 Robert Schneider
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password';
91
</code></pre>
92
93
h4. PostgreSQL
94
95
<pre><code class="sql">
96
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
97
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
98
</code></pre>
99
100 33 C S
h4. SQLite
101
102
Überspringen Sie diesen Schritt. Die Datenbank wird in diesem Fall in [[DeRedmineInstall#Schritt 6 - Anlegen der Datenbankstruktur und -daten|Schritt 6]] erstellt.
103
104 7 Robert Schneider
h4. SQL Server
105
106
Die Datenbank, das Login und der Benutzer können im _SQL Server Management Studio_ mit ein paar Klicks erstellt werden.
107
108
Hier aber auch ein Beispiel auf der der Kommandozeile mit @SQLCMD@:
109
110 8 Robert Schneider
{{collapse(Zeige SQL,Verberge SQL)
111 7 Robert Schneider
<pre><code class="sql">
112
USE [master]
113
GO
114
115 8 Robert Schneider
-- Simples Erzeugen einer DB
116 7 Robert Schneider
CREATE DATABASE [REDMINE]
117
GO
118 1 Robert Schneider
119
-- Anlegen eines Logins mit Benutzer/Passwort-Authentifizierung, ohne Ablauf des Passworts
120
CREATE LOGIN [REDMINE] WITH PASSWORD=N'redminepassword', DEFAULT_DATABASE=[REDMINE], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF
121
GO
122
123
-- Erzeugung des Benutzers für das zuvor angelegte Login
124
USE [REDMINE]
125
GO
126
CREATE USER [REDMINE] FOR LOGIN [REDMINE]
127
GO
128 7 Robert Schneider
129
-- Benutzerberechtigungen mit Rollen
130
EXEC sp_addrolemember N'db_datareader', N'REDMINE'
131
GO
132
EXEC sp_addrolemember N'db_datawriter', N'REDMINE'
133
GO
134
</code></pre>
135
}}
136 33 C S
137
138
139
h2. Ende der aktuellen Übersetzung, Rest Rev. 252
140
141
142
143
144
145
146 9 Robert Schneider
147
h3. Schritt 3 - Konfiguration der Datenbankverbindung
148
149
Um die Datenbankverbindung für den Produktiveinsatz zu konfigurieren wird @config/database.yml.example@ nach @config/database.yml@ kopiert und wie folgt bearbeitet.
150
151
Beispiel für eine MySQL-Datenbank unter Verwendung von Ruby 1.8 oder jRuby:
152
153
<pre><code class="yml">
154
production:
155
  adapter: mysql
156
  database: redmine
157
  host: localhost
158
  username: redmine
159
  password: my_password
160
</code></pre>
161
162
Beispiel für eine MySQL-Datenbank unter Verwendung von Ruby 1.9 (@adapter@ muss auf @mysql2@ gesetzt werden):
163
164
<pre><code class="yml">
165
production:
166
  adapter: mysql2
167
  database: redmine
168
  host: localhost
169
  username: redmine
170
  password: my_password
171
</code></pre>
172
173
Diese Konfiguration ist zu verwenden, falls der Server nicht auf dem Standardport (3306) horcht:
174
175
<pre><code class="yml">
176
production:
177
  adapter: mysql
178
  database: redmine
179
  host: localhost
180
  port: 3307
181
  username: redmine
182
  password: my_password
183
</code></pre>
184
185
Beispiel für eine PostgreSQL-Datenbank (mit dem Standardport):
186
187
<pre><code class="yml">
188
production:
189
  adapter: postgresql
190
  database: <your_database_name>
191
  host: <postgres_host>
192
  username: <postgres_user>
193
  password: <postgres_user_password>
194
  encoding: utf8
195
  schema_search_path: <database_schema> (default - public)
196
</code></pre>
197
198
Beispiel für eine SQL-Server-Datenbank (mit Standard-Host @localhost@ und Standardport 1433):
199
200
<pre><code class="yml">
201
production:
202
  adapter: sqlserver
203
  database: redmine
204
  username: redmine # sollte dem Datenbankbenutzer entsprechen
205
  password: redminepassword # sollte dem Login-Passwort entsprechen
206
</code></pre>
207 10 Robert Schneider
208 13 Robert Schneider
h3. Schritt 4 - Installation der Abhängigkeiten
209 10 Robert Schneider
210
Um die gem-Abhängigkeiten zu verwalten, verwendet Redmine "Bundler":http://gembundler.com/.
211
212
Zuerst muss Bundler installiert werden: 	
213
214
  gem install bundler
215
216
Dann können alle von Redmine benötigten gems mit folgenden Kommando installiert werden:
217
218
  bundle install --without development test
219
220
h4. Optionale Abhängigkeiten
221
222
h5. RMagick 
223
224 31 Robert Schneider
RMagick ermöglicht die Verwendung von ImageMagick, welches wiederum erlaubt Bilder für die Erzeugung von PDFs, und für den PNG-Export generieren zu lassen.
225 1 Robert Schneider
226 31 Robert Schneider
Falls ImageMagick auf dem System nicht installiert ist, so sollte die Installation des RMagick Gem ausgelassen werden:
227 11 Robert Schneider
228 1 Robert Schneider
  bundle install --without development test rmagick
229 11 Robert Schneider
230 31 Robert Schneider
Falls es bei der Installation von RMagick unter Windows zu Problemen kommt, sind weitere Informationen in diesem [[HowTo_install_rmagick_gem_on_Windows|HowTo]] zu finden.
231 11 Robert Schneider
232
h5. Datenbankadapter
233
234
Redmine installiert automatisch die Adapter-Gems, die von Datenbankkonfiguration benötigt werden, in dem es die Datei @config/database.yml@ ausliest.
235
236
@bundle install --without development test ...@ ist jedes Mal auszuführen, wenn in der Datei @config/database.yml@ Adapter hinzugefügt oder entfernt worden sind. Dies sollte nicht vergessen werden.
237 12 Robert Schneider
238
h4. Weitere Abhängigkeiten (Gemfile.local)
239
240
Wenn Gems geladen werden müssen, die nicht vom Redmine-Core benötigt werden (z.B. Puma, fcgi), so kann eine Datei @Gemfile.local@ im Root-Verzeichnis des Redmine-Verzeichnisses erstellt werden. Sie wird automatisch geladen, sobald @bundle install@ ausgeführt wird.
241
242
Beispiel:
243
244 15 Robert Schneider
<pre>
245
# Gemfile.local
246
gem 'puma'
247
</pre>
248 12 Robert Schneider
249
h3. Schritt 5 - Erzeugen des Session Store Secrets
250 16 Robert Schneider
251
Dieser Schritt erzeugt einen zufälligen Schlüssel, der von Rails verwendet wird, um Session-Daten zu verschlüsseln, die in einem Cookie gespeichert werden, sodass Manipulationen verhindert werden.
252
253
Das Erzeugen eines neuen Secret Tokens macht nach einem Neustart alle bestehenden Sesssions ungültig.
254
255
* mit Redmine 1.4.x:
256
257
<pre>
258
  bundle exec rake generate_session_store
259
</pre>
260
261
* mit Redmine 2.x
262
263
<pre>
264
bundle exec rake generate_secret_token
265
</pre>
266
267
Alternativ kann das Secret auch in @config/secrets.yml@ gespeichert werden:
268
http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
269
270
h3. Schritt 6 - Anlegen der Datenbankstruktur und -daten
271
272
Mit dem Ausführen der folgende Anweisung im Root-Verzeichnis von Redmine wird die Datenbankstruktur angelegt:
273
274
  RAILS_ENV=production bundle exec rake db:migrate
275
276
Syntax unter Windows:
277
278
  set RAILS_ENV=production
279
bundle exec rake db:migrate
280
281
Damit werden nacheinander alle Migrationen durchgeführt - was die Tabellen, eine Reihe von Berechtigungen und das Administrator-Konto erzeugt.
282
283
+Problemlösung für Ubuntu+
284
285
Falls unter Ubuntu dieser Fehler entsteht:
286
287
<pre>
288
Rake aborted!
289
no such file to load -- net/https
290
</pre>
291
292
dann ist es erforderlich @libopenssl-ruby1.8@ mittels @apt-get install libopenssl-ruby1.8@ zu installieren.
293
294 17 Robert Schneider
h3. Schritt 7 - Grunddaten in die Datenbank einfügen
295
296
Mit folgender Anweisung werden die Daten der Grundkonfiguration in die Datenbank hinzugefügt:
297
298
  RAILS_ENV=production bundle exec rake redmine:load_default_data
299
300
Redmine fragt dabei nach der Sprache für die Daten, die beim Hinzufügen verwendet werden soll. Das Setzen der Umgebungsvariable @REDMINE_LANG@ vor dem Ausführen der Anweisung ermöglicht hingegen den Silent-Modus, so dass keine Nachfrage mehr stattfindet, da die Sprache nun aus der Variablen gelesen wird.
301
302
Beispiel für unixoide Systeme:
303
304
  RAILS_ENV=production REDMINE_LANG=fr bundle exec rake redmine:load_default_data
305
306
Beispiel für Windows:
307
308
<pre>
309
set RAILS_ENV=production
310
set REDMINE_LANG=fr
311
bundle exec rake redmine:load_default_data
312
</pre>
313 18 Robert Schneider
314
h3. Schritt 8 - Berechtigungen im Dateisystem
315
316
_Hinweis: Windows-Benutzer können diesen Abschnitt überspringen._
317
318
Der Benutzer, mit dem die Anwendung ausgeführt wird, muss die Berechtigung zum Schreiben in folgende Subverzeichnisse haben:
319
320
# @files@ (Speicherort für Anhänge)
321
# @log@ (Log-Datei der Anwendung @production.log@)
322
# @tmp@ and @tmp/pdf@ (Verzeichnisse sind anzulegen, falls sie noch nicht existieren; wird unter anderem auch für das Erstellen von PDFs verwendet)
323
# @public/plugin_assets@ (Assets der Plugins)
324
325
Beispiel - davon ausgehend, die Anwendung wird mit einem Benutzer @redmine@ betrieben:
326
327
<pre>
328
mkdir -p tmp tmp/pdf public/plugin_assets
329
sudo chown -R redmine:redmine files log tmp public/plugin_assets
330
sudo chmod -R 755 files log tmp public/plugin_assets
331
</pre>
332
333
h3. Schritt 9 - Die Installation testen
334
335 19 Robert Schneider
Die Installation kann mit dem Ausführen des WEBrick-Webserver ausprobiert werden:
336 18 Robert Schneider
337
* mit Redmine 1.4.x:
338
339
<pre>bundle exec ruby script/server webrick -e production</pre>
340
341
* mit Redmine 2.x:
342
343
<pre>bundle exec ruby script/rails server webrick -e production</pre>
344
345
* mit Redmine 3.x:
346
347
<pre>bundle exec rails server webrick -e production</pre>
348
349
Wenn WEBrick gestartet wurde, kann im Browser http://localhost:3000/ (oder eine andere Domain, mit Port 3000) aufgerufen werden. Es sollte dann die Willkommensseite von Redmine erscheinen.
350
351 19 Robert Schneider
> Hinweis: WEBrick ist nicht für den Produktiveinsatz geeignet. WEBrick sollte nur zum Überprüfen der Installation verwendet werden, um zu sehen, ob soweit alles funktioniert. Es kann aber einer der zahlreichen Anleitungen in diesem Wiki verwendet werden, um Redmine mit Passenger (vormals @mod_rails@), FCGI oder einem Rack-Server (Unicorn, Thin, Puma, hellip) zu betreiben.
352 18 Robert Schneider
353
h3. Schritt 10 - In die Anwendung einloggen
354
355
Zum Einloggen wird der Administrator-Zugang verwendet:
356
357
* Mitgliedsname: admin
358
* Passwort: admin
359
360 1 Robert Schneider
Die meisten Einstellungen können nun vorgenommen werden indem man im Menü zur @Administration@ und dort in den Bereich @Konfiguration@ geht.
361 20 Robert Schneider
362
h2. Konfiguration
363
364 21 Robert Schneider
Die Redmine-Einstellungen werden in einer Datei namens @config/configuration.yml@ gespeichert.
365 20 Robert Schneider
366
Wenn andere Werte als die Standardeinstellungen verwendet werden sollen, so muss lediglich @config/configuration.yml.example@ nach @config/configuration.yml@ kopiert und angepasst werden. Die Datei enthält Dokumentation in Form von Kommentaren und ist daher selbsterklärend.
367
368
Diese Einstellungen können auch durch die Umgebungsvariablen für Rails vorgenommen werden (@production/development/test@).
369 1 Robert Schneider
370 21 Robert Schneider
+Wichtig+: die Anwendung muss nach jeder Änderung neu gestartet werden.
371
372
h3. Email/SMTP-Servereinstellungen
373
374
Die Email-Konfiguration wird auf einer [[EmailConfiguration|separaten Seite]] erklärt.
375
376
h3. SCM-Einstellungen
377
378
Dieser Abschnitt ermöglicht:
379
380
* das Überschreiben der Standardanweisungsnamen, falls die SCM-Binärdateien in der PATH-Variablen nicht die üblichen Namen verwenden
381
* das Festlegen des kompletten Pfads zu den SCM-Binärdateien
382
383
Beispiele (mit Subversion):
384
385
Überschreiben des Anweisungsnamen:
386
387
  scm_subversion_command: "svn_replacement.exe"
388
389
Setzen des Pfades:
390
391
  scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"
392
393
h3. Speichereinstellungen für Anhänge
394
395
Mit der Einstellung @attachments_storage_path@ kann das Verzeichnis für den Ort, wohin Anhänge gespeichert werden, vom Standard @files@ auf einen anderen geändert werden. 
396
397
Beispiele:
398
399
  attachments_storage_path: /var/redmine/files
400
401
  attachments_storage_path: D:/redmine/files
402
403
h2. Konfiguration des Loggings
404 22 Robert Schneider
405
Standardmäßig verwendet Redmine beim Schreiben in das @log@-Verzeichnis das Log-Level @:info@. Abhängig von der Verwendungsintensität der Anwendung kann dies eine umfangreiche Menge an Daten bedeuten. Um dabei ein uferloses Wachsen der Log-Datei zu vermeiden, sollte eine Rotation der Log-Datei erwogen werden - entweder durch System-Tools wie @logrotate@ oder durch Einstellungen in der Datei @config/additional_environment.rb@.
406
407
Um die zweite Möglichkeit zu verwenden, wird die @config/additional_environment.rb.example@ nach @config/additional_environment.rb@ kopiert und folgende Zeilen hinzugefügt. Zu beachten ist dabei, dass der nun verwendete Logger standardmäßig auf ein hohes Log-Level eingestellt ist, und dass daher dieser explizit auf @info@ gesetzt werden muss.
408
409
<pre><code class="ruby">
410
#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
411
config.logger = Logger.new('/path/to/logfile.log', 2, 1000000)
412
config.logger.level = Logger::INFO
413
</code></pre>
414
415
h2. Sicherungen
416
417
Redmine-Sicherungen sollten enthalten:
418
419
* Daten (in der Redmine-Datenbank gespeichert)
420
* Anhänge (standardmäßig im @files@-Verzeichnis des Redmine-Installationsverzeichnisses enthalten)
421
422
Im folgenden ist ein einfaches Shell-Skript, das für die tägliche Sicherung verwendet werden kann (mit der Annahmen, dass eine MySQL-Datenbank verwendet wird):
423
424 26 Robert Schneider
<pre>
425 22 Robert Schneider
# Datenbank
426
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz
427
428
# Anhänge
429
rsync -a /path/to/redmine/files /path/to/backup/files
430 26 Robert Schneider
</pre>
431 22 Robert Schneider
432
h2. Hinweise zur Installation unter Linux/Unix
433
434 23 Robert Schneider
Falls während der Installation seltsame Probleme auftreten, so sollte sichergestellt werden, dass sicherheitsüberwachende Tools ausgeschaltet sind. So etwas passiert häufig ohne Fehlermeldungen oder anderem Feedback und kann durch Tools wie Erweiterte ACLs, SELinux oder AppArmor verursacht werden. Jene Tools werden meistens in größeren Firmen mit strengen Sicherheitsrichtlinien verwendet. Die Einstellungen von Standard-Linux- oder Unix-Distributionen sollten aber keine Probleme verursachen.
435 22 Robert Schneider
436
h2. Hinweise zur Installation unter Windows
437
438 24 Robert Schneider
Unter http://rubyinstaller.org gibt es einen vorgefertigtes Installationsprogramm für den Ruby-MRI (Matz' Ruby-Interpreter).
439
Nach dessen Installation ist _Start Command Prompt with Ruby_ im Startmenü auszuwählen.
440
441
+Setzen der @RAILS_ENV@-Variable:+
442
443
Beim Ausführen von Anweisungen, wie sie in dieser Anleitung beschrieben sind, muss die @RAILS_ENV@-Variable mit einer anderen Anweisung zuvor gesetzt werden.
444
445
D.h. Anweisungen mit der Syntax folgender Art:
446
447
<pre>
448
RAILS_ENV=production <irgendeine Anweisung>
449
<irgendeine Anweisung> RAILS_ENV=production
450
</pre>
451
452
müssen in zwei aufeinanderfolgende Anweisungen zerlegt werden:
453
454
<pre>
455
set RAILS_ENV=production
456
<any commmand>
457
</pre>
458
459
+Probleme bei der Installation des MySQL-Gem+
460
461
Es kann nötig sein, das MySQL-Gem manuell mit folgender Anweisung zu installieren:
462
463
  gem install mysql
464
465
Und in manchen Fällen ist es erforderlich @libmysql.dll@ in das @ruby/bin@-Verzeichnis zu kopieren.
466
Nicht alle @libmysql.dll@-Dateien scheinen fehlerfrei zu sein, jedoch sollte diese Datei funktionieren: http://instantrails.rubyforge.org/svn/trunk/InstantRails-win/InstantRails/mysql/bin/libmySQL.dll.
467
468
*Wichtiger Hinweis für Windows 7 und höher*
469
470 25 Robert Schneider
Unter Window 7 und höher ist @localhost@ in der hosts-Datei auskommentiert[1] und es wird standardmäßig IPv6 verwendet[2]. Da das mysql2-Gem IPv6-Adressen nicht unterstützt[3], kann keine Verbindung aufgebaut werden und es tritt der Fehler @"Can't connect to MySQL server on 'localhost' (10061)"@ auf.
471
472
Dies lässt sich überprüfen indem @localhost@ gepingt wird: wenn @"::1:"@ gepingt wird, so ist IPv6 in Verwendung.
473
474
+Workaround:+
475
476
@localhost@ mit @127.0.0.1@ in @database.yml@ ersetzen.
477
478
fn1. http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why
479
480
fn2. http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx
481
482
fn3. https://github.com/brianmario/mysql2/issues/279
483
484 22 Robert Schneider
485
486
h2. Alternative zur manuellen Installation
487
488
Einige Nutzer verzichten lieber auf die manuelle Installation, indem sie einer der [[Download#Third-party-Redmine-bundles|Redmine-Pakete]] von Drittanbietern verwenden, die auf der Download-Seite aufgelistet sind.