Project

General

Profile

DeRedmineInstall » History » Version 36

C S, 2021-11-26 10:58
In relation to https://redmine.org/boards/2/topics/66351?r=66355#message-66355, the note about unpacking the package in step 1 added

1 1 Robert Schneider
{{>toc}}
2 14 Robert Schneider
3 35 C S
Übersetzung von "Rev. 318":http://www.redmine.org/projects/redmine/wiki/RedmineInstall/318
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 35 C S
|_. Redmine-Version|_. Unterstützte Ruby-Versionen                                   |_. Verwendete Rails-Version|
22
|trunk (>= "r20913":https://redmine.org/projects/redmine/repository/revisions/20913 )|Ruby 2.5, 2.6, 2.7[1]|Rails 6.1      |
23
|4.2               |Ruby 2.4, 2.5, 2.6                                               |Rails 5.2 |
24
|4.1               |Ruby 2.3, 2.4, 2.5, 2.6                                  |Rails 5.2 |
25 1 Robert Schneider
26 35 C S
fn1. Redmine 4.2 unterstützt kein Ruby 2.7.0 und 2.7.1. 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 35 C S
* %{color:red}Die Unterstützung von Ruby 2.5 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/, "2.5":https://www.ruby-lang.org/en/news/2021/04/05/ruby-2-5-9-released/.
33 32 C S
* *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 36 C S
Der Source-Code von Redmine kann entweder durch das Herunterladen eines gepackten Releases (welches dann zunächst in den Zielordner entpackt werden muss) 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
h3. Schritt 3 - Konfiguration der Datenbankverbindung
138 9 Robert Schneider
139
Um die Datenbankverbindung für den Produktiveinsatz zu konfigurieren wird @config/database.yml.example@ nach @config/database.yml@ kopiert und wie folgt bearbeitet.
140
141 34 C S
Beispiel für eine MySQL-Datenbank (Standardport):
142 9 Robert Schneider
143
<pre><code class="yml">
144
production:
145 34 C S
  adapter: mysql12
146 9 Robert Schneider
  database: redmine
147
  host: localhost
148
  username: redmine
149
  password: my_password
150
</code></pre>
151
152 34 C S
Wenn der Server nicht unter dem Standardport (@3306@) erreichbar ist (sondern zum Beispiel unter @3307@):
153 9 Robert Schneider
154
<pre><code class="yml">
155
production:
156
  adapter: mysql2
157 1 Robert Schneider
  database: redmine
158
  host: localhost
159
  port: 3307
160
  username: redmine
161
  password: my_password
162
</code></pre>
163
164
Beispiel für eine PostgreSQL-Datenbank (mit dem Standardport):
165 9 Robert Schneider
166
<pre><code class="yml">
167
production:
168
  adapter: postgresql
169
  database: <your_database_name>
170
  host: <postgres_host>
171
  username: <postgres_user>
172
  password: <postgres_user_password>
173
  encoding: utf8
174 1 Robert Schneider
  schema_search_path: <database_schema> (default - public)
175 9 Robert Schneider
</code></pre>
176 1 Robert Schneider
177 34 C S
Beispiel für eine SQLite Datenbank
178 9 Robert Schneider
179
<pre><code class="yml">
180 1 Robert Schneider
production:
181 34 C S
  adapter: sqlite3
182
  database: db/redmine.sqlite3
183
</code></pre>
184
185
Beispiel für eine SQL-Server-Datenbank (mit Standard-Host @localhost@ und Standardport @1433@):
186
187
<pre><code class="yml">
188
production:
189 9 Robert Schneider
  adapter: sqlserver
190 1 Robert Schneider
  database: redmine
191 9 Robert Schneider
  username: redmine # sollte dem Datenbankbenutzer entsprechen
192
  password: redminepassword # sollte dem Login-Passwort entsprechen
193 1 Robert Schneider
</code></pre>
194 9 Robert Schneider
195
h3. Schritt 4 - Installation der Abhängigkeiten
196
197 10 Robert Schneider
Um die gem-Abhängigkeiten zu verwalten, verwendet Redmine "Bundler":http://gembundler.com/.
198
199 34 C S
Wenn Sie Ruby in der Version 2.5 oder früher benutzen, muss der Bundler erst installiert werden 	
200 10 Robert Schneider
201 34 C S
<pre>gem install bundler</pre>
202 10 Robert Schneider
203
Dann können alle von Redmine benötigten gems mit folgenden Kommando installiert werden:
204
205 34 C S
  <pre>bundle install --without development test</pre>
206 10 Robert Schneider
207
h4. Optionale Abhängigkeiten
208 1 Robert Schneider
209 10 Robert Schneider
h5. RMagick 
210
211 34 C S
RMagick ist eine Schnittstelle zwischen der Programmiersprache Ruby und der ImageMagick-Bildverarbeitungsbibliothek. Die Bibliothek ist erforderlich, damit Redmine vor 4.1.0 Gantt-Diagramme in PNG oder PDF exportieren kann.
212 31 Robert Schneider
213 34 C S
Wenn ImageMagick (6.4.9 - 6.9.10) nicht auf Ihrem System installiert ist und Sie Redmine 4.0 oder früher installieren, sollten Sie die Installation des rmagick-Gems überspringen mit:
214 31 Robert Schneider
215 34 C S
  <pre>bundle install --without development test rmagick</pre>
216 11 Robert Schneider
217 34 C S
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.
218 11 Robert Schneider
219
h5. Datenbankadapter
220
221 34 C S
Redmine installiert automatisch die Adapter-Gems, die von Datenbankkonfiguration benötigt werden, in dem es die Datei @config/database.yml@ ausliest (Wenn Sie nur eine Verbindung mit dem @mysql2@-Adapter konfiguriert haben, wird nur das @mysql2@-Gem installiert).
222 15 Robert Schneider
223
@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.
224
225
h4. Weitere Abhängigkeiten (Gemfile.local)
226 12 Robert Schneider
227 16 Robert Schneider
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.
228
229
Beispiel:
230
231
<pre>
232
# Gemfile.local
233
gem 'puma'
234 1 Robert Schneider
</pre>
235 16 Robert Schneider
236
h3. Schritt 5 - Erzeugen des Session Store Secrets
237
238
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.
239 1 Robert Schneider
Das Erzeugen eines neuen Secret Tokens macht nach einem Neustart alle bestehenden Sesssions ungültig.
240 16 Robert Schneider
241 34 C S
<pre>bundle exec rake generate_secret_token</pre>
242 16 Robert Schneider
243
Alternativ kann das Secret auch in @config/secrets.yml@ gespeichert werden:
244
http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
245
246
h3. Schritt 6 - Anlegen der Datenbankstruktur und -daten
247
248 34 C S
Mit dem Ausführen der folgenden Anweisung im Root-Verzeichnis von Redmine wird die Datenbankstruktur angelegt:
249 16 Robert Schneider
250
  RAILS_ENV=production bundle exec rake db:migrate
251
252
Syntax unter Windows:
253
254
  set RAILS_ENV=production
255
bundle exec rake db:migrate
256
257 34 C S
Damit werden nacheinander alle Migrationen durchgeführt - was die Tabellen, eine Reihe von Berechtigungen und das Administrator-Konto mit dem Namen @admin@ erzeugt.
258 16 Robert Schneider
259
+Problemlösung für Ubuntu+
260
261 1 Robert Schneider
Falls unter Ubuntu dieser Fehler entsteht:
262
263
<pre>
264 16 Robert Schneider
Rake aborted!
265
no such file to load -- net/https
266
</pre>
267
268
dann ist es erforderlich @libopenssl-ruby1.8@ mittels @apt-get install libopenssl-ruby1.8@ zu installieren.
269
270 1 Robert Schneider
h3. Schritt 7 - Grunddaten in die Datenbank einfügen
271 16 Robert Schneider
272 1 Robert Schneider
Mit folgender Anweisung werden die Daten der Grundkonfiguration in die Datenbank hinzugefügt:
273 16 Robert Schneider
274
  RAILS_ENV=production bundle exec rake redmine:load_default_data
275
276 17 Robert Schneider
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.
277
278
Beispiel für unixoide Systeme:
279
280 34 C S
  RAILS_ENV=production REDMINE_LANG=de bundle exec rake redmine:load_default_data
281 17 Robert Schneider
282
Beispiel für Windows:
283
284
<pre>
285
set RAILS_ENV=production
286 34 C S
set REDMINE_LANG=de
287 17 Robert Schneider
bundle exec rake redmine:load_default_data
288 18 Robert Schneider
</pre>
289
290 1 Robert Schneider
h3. Schritt 8 - Berechtigungen im Dateisystem
291 18 Robert Schneider
292
_Hinweis: Windows-Benutzer können diesen Abschnitt überspringen._
293
294
Der Benutzer, mit dem die Anwendung ausgeführt wird, muss die Berechtigung zum Schreiben in folgende Subverzeichnisse haben:
295
296
# @files@ (Speicherort für Anhänge)
297
# @log@ (Log-Datei der Anwendung @production.log@)
298
# @tmp@ and @tmp/pdf@ (Verzeichnisse sind anzulegen, falls sie noch nicht existieren; wird unter anderem auch für das Erstellen von PDFs verwendet)
299
# @public/plugin_assets@ (Assets der Plugins)
300
301
Beispiel - davon ausgehend, die Anwendung wird mit einem Benutzer @redmine@ betrieben:
302
303
<pre>
304
mkdir -p tmp tmp/pdf public/plugin_assets
305
sudo chown -R redmine:redmine files log tmp public/plugin_assets
306 19 Robert Schneider
sudo chmod -R 755 files log tmp public/plugin_assets
307 18 Robert Schneider
</pre>
308
309 34 C S
Hinweis: Wenn Sie Dateien in diesen Verzeichnissen haben (z. B. Dateien aus dem Backup wiederherstellen), stellen Sie sicher, dass diese Dateien nicht ausführbar sind.
310
311
<pre>sudo find files log tmp public/plugin_assets -type f -exec chmod -x {} +</pre>
312
313 18 Robert Schneider
h3. Schritt 9 - Die Installation testen
314 1 Robert Schneider
315 18 Robert Schneider
Die Installation kann mit dem Ausführen des WEBrick-Webserver ausprobiert werden:
316 1 Robert Schneider
317 18 Robert Schneider
<pre>bundle exec rails server webrick -e production</pre>
318
319 34 C S
Wenn WEBrick gestartet wurde, kann im Browser http://localhost:3000/ aufgerufen werden. Es sollte dann die Willkommensseite von Redmine erscheinen.
320 18 Robert Schneider
321 34 C S
> 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.
322 18 Robert Schneider
323
h3. Schritt 10 - In die Anwendung einloggen
324 19 Robert Schneider
325 18 Robert Schneider
Zum Einloggen wird der Administrator-Zugang verwendet:
326
327
* Mitgliedsname: admin
328
* Passwort: admin
329
330 1 Robert Schneider
Die meisten Einstellungen können nun vorgenommen werden indem man im Menü zur @Administration@ und dort in den Bereich @Konfiguration@ geht.
331 18 Robert Schneider
332
h2. Konfiguration
333
334 1 Robert Schneider
Die Redmine-Einstellungen werden in einer Datei namens @config/configuration.yml@ gespeichert.
335 20 Robert Schneider
336
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.
337
338 21 Robert Schneider
Diese Einstellungen können auch durch die Umgebungsvariablen für Rails vorgenommen werden (@production/development/test@).
339 20 Robert Schneider
340
+Wichtig+: die Anwendung muss nach jeder Änderung neu gestartet werden.
341
342 21 Robert Schneider
h3. Email/SMTP-Servereinstellungen
343
344
Die Email-Konfiguration wird auf einer [[EmailConfiguration|separaten Seite]] erklärt.
345
346
h3. SCM-Einstellungen
347
348
Dieser Abschnitt ermöglicht:
349
350 34 C S
* das Überschreiben der Standardanweisungsnamen, falls die SCM-Binärdateien in der PATH-Variablen nicht die üblichen Namen verwenden ((Windows .bat/.cmd Namen funktionieren nicht)
351 21 Robert Schneider
* das Festlegen des kompletten Pfads zu den SCM-Binärdateien
352
353 1 Robert Schneider
Beispiele (mit Subversion):
354 21 Robert Schneider
355
Überschreiben des Anweisungsnamen:
356
357
  scm_subversion_command: "svn_replacement.exe"
358 1 Robert Schneider
359 21 Robert Schneider
Setzen des Pfades:
360
361
  scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"
362
363
h3. Speichereinstellungen für Anhänge
364
365
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. 
366 1 Robert Schneider
367 21 Robert Schneider
Beispiele:
368 1 Robert Schneider
369 21 Robert Schneider
  attachments_storage_path: /var/redmine/files
370 1 Robert Schneider
371 22 Robert Schneider
  attachments_storage_path: D:/redmine/files
372
373 34 C S
h2. Konfiguration des Protokollierung 
374 22 Robert Schneider
375 34 C S
Redmine verwendet standardmäßig die Protokollebene @:info@ und schreibt in das Protokollunterverzeichnis. Abhängig von der SeitenNutzung können dies viele Daten sein. Um zu vermeiden, dass der Inhalt der Protokolldatei ungebremst wächst, sollten Sie sie dies entweder über ein Systemdienstprogramm wie @logrotate@ oder über die Datei @config/additional_environment.rb@ regulieren.
376 22 Robert Schneider
377 34 C S
Um letzteres zu verwenden, kopieren Sie @config/additional_environment.rb.example@ nach @config/additional_environment.rb@ und fügen Sie die folgenden Zeilen hinzu. Beachten Sie, dass der neue Logger standardmäßig eine hohe Log-Ebene verwendet und daher explizit auf @info@ gesetzt werden sollte.
378 22 Robert Schneider
379
<pre><code class="ruby">
380
#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
381
config.logger = Logger.new('/path/to/logfile.log', 2, 1000000)
382
config.logger.level = Logger::INFO
383
</code></pre>
384
385
h2. Sicherungen
386
387
Redmine-Sicherungen sollten enthalten:
388
389
* Daten (in der Redmine-Datenbank gespeichert)
390 26 Robert Schneider
* Anhänge (standardmäßig im @files@-Verzeichnis des Redmine-Installationsverzeichnisses enthalten)
391 22 Robert Schneider
392 34 C S
Weitere Informationen hierzu finden sie unter [[DeRedmineBackupRestore|Sichern und Wiederherstellen von Redmine]]
393 22 Robert Schneider
394
h2. Hinweise zur Installation unter Linux/Unix
395 26 Robert Schneider
396 22 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.
397
398
h2. Hinweise zur Installation unter Windows
399 23 Robert Schneider
400 22 Robert Schneider
Unter http://rubyinstaller.org gibt es einen vorgefertigtes Installationsprogramm für den Ruby-MRI (Matz' Ruby-Interpreter).
401
Nach dessen Installation ist _Start Command Prompt with Ruby_ im Startmenü auszuwählen.
402 24 Robert Schneider
403
+Setzen der @RAILS_ENV@-Variable:+
404
405
Beim Ausführen von Anweisungen, wie sie in dieser Anleitung beschrieben sind, muss die @RAILS_ENV@-Variable mit einer anderen Anweisung zuvor gesetzt werden.
406
407
D.h. Anweisungen mit der Syntax folgender Art:
408
409
<pre>
410
RAILS_ENV=production <irgendeine Anweisung>
411
<irgendeine Anweisung> RAILS_ENV=production
412
</pre>
413
414
müssen in zwei aufeinanderfolgende Anweisungen zerlegt werden:
415
416
<pre>
417
set RAILS_ENV=production
418 34 C S
<irgendeine Anweisung>
419 24 Robert Schneider
</pre>
420
421
+Probleme bei der Installation des MySQL-Gem+
422
423
Es kann nötig sein, das MySQL-Gem manuell mit folgender Anweisung zu installieren:
424
425
  gem install mysql
426
427
Und in manchen Fällen ist es erforderlich @libmysql.dll@ in das @ruby/bin@-Verzeichnis zu kopieren.
428
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.
429
430 25 Robert Schneider
*Wichtiger Hinweis für Windows 7 und höher*
431
432 34 C S
Unter Windows 7 und höher ist @localhost@ in der hosts-Datei auskommentiert[5] und es wird standardmäßig IPv6 verwendet[6]. Da das mysql2-Gem IPv6-Adressen nicht unterstützt[7], kann keine Verbindung aufgebaut werden und es tritt der Fehler @"Can't connect to MySQL server on 'localhost' (10061)"@ auf.
433 25 Robert Schneider
434
Dies lässt sich überprüfen indem @localhost@ gepingt wird: wenn @"::1:"@ gepingt wird, so ist IPv6 in Verwendung.
435
436
+Workaround:+
437
438
@localhost@ mit @127.0.0.1@ in @database.yml@ ersetzen.
439
440 34 C S
fn5. http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why
441 25 Robert Schneider
442 34 C S
fn6. http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx
443 25 Robert Schneider
444 34 C S
fn7. https://github.com/brianmario/mysql2/issues/279
445 22 Robert Schneider
446
h2. Alternative zur manuellen Installation
447
448
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.