Project

General

Profile

DeRedmineInstall » History » Version 43

C S, 2023-03-23 13:57
Updated to original Rev. 326

1 1 Robert Schneider
{{>toc}}
2 14 Robert Schneider
3 43 C S
Übersetzung von "Rev. 326":http://www.redmine.org/projects/redmine/wiki/RedmineInstall/326
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 43 C S
|trunk (>= r22053) |Ruby 2.7, 3.0, 3.1, 3.2 |Rails 6.1              | 
23
 |5.0 |Ruby 2.5[1], 2.6[1], 2.7, 3.0, 3.1|Rails 6.1 | 
24
 |4.2 |Ruby 2.4[1], 2.5[1], 2.6, 2.7[2]|Rails 5.2              | 
25 1 Robert Schneider
26 43 C S
fn1. Die Unterstützung von Ruby 2.6 und früher wurde von der Ruby-Community eingestellt. Weitere Informationen 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/, "2.6":https://www.ruby-lang.org/en/news/2022/04/12/ruby-2-6-10-released/ .
27 41 C S
28 42 C S
fn2. 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). Alle Versionen vor Redmine 4.2.4 haben in Verbindung mit Ruby 2.7 ein bekanntes Problem mit benutzerdefinierten Feldern (siehe #36584), alternativ bitte Ruby bis Version 2.6.9 benutzen
29 32 C S
30 39 C S
31
32 2 Robert Schneider
*Wichtige Hinweise:*
33 35 C S
34 40 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
35 2 Robert Schneider
36 1 Robert Schneider
h3. Unterstützte Datenbanken
37
38 33 C S
* MySQL 5.5 - 5.7
39
** *MySQL 5.6 und höher* sowie *MariaDB* haben bekannte Probleme (#19344, #19395, #17460).
40 3 Robert Schneider
41 33 C S
* PostgreSQL 9.2 oder höher
42
** 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.
43 3 Robert Schneider
44 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
45
** Redmine 4.0.0 bis 4.0.6 sowie 4.1.0 unterstützen kein SQL Server (#30285, #32737)
46 3 Robert Schneider
47
* SQLite 3 (nicht für den Produktiveinsatz mit mehreren Benutzern gedacht!)
48 1 Robert Schneider
49 3 Robert Schneider
h3. Optionale Komponenten
50 4 Robert Schneider
51
* SCM-Programme (z.B. @svn@) für das Browsen in Projektarchiven. [[RedmineRepositories]] enthält Informationen zu Kompatibilitäten und Anforderungen.
52
* "ImageMagick":http://www.imagemagick.org/ (um den Gantt-Export zu PNG-Bildern und die Generierung von Vorschaubildern zu ermöglichen).
53 33 C S
* "Ghostscript":https://www.ghostscript.com/ (Ermöglicht die Generierung von Minaturansichten für PDF Anhänge ab Redmine 4.1)
54 4 Robert Schneider
55 6 Robert Schneider
h2. Redmine-Version
56
57 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.
58
59
h2. Ablauf der Installation
60
61 33 C S
h3. Schritt 1 - Redmine beziehen
62 1 Robert Schneider
63 38 C S
Der Source-Code von Redmine kann entweder durch das Herunterladen oder Auschecken eines gepackten Releases bezogen werden. Gepackte Dateien müssen erst in ein geeignetes Ziel extrahiert/entpackt werden. 
64
Alternativ kann man die Dateien direkt aus dem Versionskontrollsystem auschecken(Code-Repository).
65 1 Robert Schneider
66 6 Robert Schneider
Mehr Informationen auf der [[Download|Download-Seite]].
67 7 Robert Schneider
68
h3. Schritt 2 - Eine leere Datenbank erstellen und einen Benutzer zuweisen
69
70
Nach den folgenden Anweisungen heißt der Datenbankbenutzer von Redmine @redmine@, jedoch kann der Name auch geändert werden.
71
72
h4. MySQL
73 1 Robert Schneider
74 7 Robert Schneider
<pre><code class="sql">
75 33 C S
CREATE DATABASE redmine CHARACTER SET utf8mb4;
76
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
77
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
78
</code></pre>
79
80
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:
81
82
<pre><code class="sql">
83 7 Robert Schneider
CREATE DATABASE redmine CHARACTER SET utf8;
84 1 Robert Schneider
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
85
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
86
</code></pre>
87
88 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:
89 7 Robert Schneider
90
<pre><code class="sql">
91 33 C S
CREATE DATABASE redmine CHARACTER SET utf8;
92 7 Robert Schneider
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password';
93
</code></pre>
94
95
h4. PostgreSQL
96
97
<pre><code class="sql">
98
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
99
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
100
</code></pre>
101
102 33 C S
h4. SQLite
103
104
Überspringen Sie diesen Schritt. Die Datenbank wird in diesem Fall in [[DeRedmineInstall#Schritt 6 - Anlegen der Datenbankstruktur und -daten|Schritt 6]] erstellt.
105
106 7 Robert Schneider
h4. SQL Server
107
108
Die Datenbank, das Login und der Benutzer können im _SQL Server Management Studio_ mit ein paar Klicks erstellt werden.
109
110
Hier aber auch ein Beispiel auf der der Kommandozeile mit @SQLCMD@:
111
112 8 Robert Schneider
{{collapse(Zeige SQL,Verberge SQL)
113 7 Robert Schneider
<pre><code class="sql">
114
USE [master]
115
GO
116
117 8 Robert Schneider
-- Simples Erzeugen einer DB
118 7 Robert Schneider
CREATE DATABASE [REDMINE]
119
GO
120 1 Robert Schneider
121
-- Anlegen eines Logins mit Benutzer/Passwort-Authentifizierung, ohne Ablauf des Passworts
122
CREATE LOGIN [REDMINE] WITH PASSWORD=N'redminepassword', DEFAULT_DATABASE=[REDMINE], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF
123
GO
124
125
-- Erzeugung des Benutzers für das zuvor angelegte Login
126
USE [REDMINE]
127
GO
128
CREATE USER [REDMINE] FOR LOGIN [REDMINE]
129
GO
130 7 Robert Schneider
131
-- Benutzerberechtigungen mit Rollen
132
EXEC sp_addrolemember N'db_datareader', N'REDMINE'
133
GO
134
EXEC sp_addrolemember N'db_datawriter', N'REDMINE'
135
GO
136
</code></pre>
137
}}
138 33 C S
139
h3. Schritt 3 - Konfiguration der Datenbankverbindung
140 9 Robert Schneider
141
Um die Datenbankverbindung für den Produktiveinsatz zu konfigurieren wird @config/database.yml.example@ nach @config/database.yml@ kopiert und wie folgt bearbeitet.
142
143 34 C S
Beispiel für eine MySQL-Datenbank (Standardport):
144 9 Robert Schneider
145
<pre><code class="yml">
146
production:
147 34 C S
  adapter: mysql12
148 9 Robert Schneider
  database: redmine
149
  host: localhost
150
  username: redmine
151
  password: my_password
152
</code></pre>
153
154 34 C S
Wenn der Server nicht unter dem Standardport (@3306@) erreichbar ist (sondern zum Beispiel unter @3307@):
155 9 Robert Schneider
156
<pre><code class="yml">
157
production:
158
  adapter: mysql2
159 1 Robert Schneider
  database: redmine
160
  host: localhost
161
  port: 3307
162
  username: redmine
163
  password: my_password
164
</code></pre>
165
166
Beispiel für eine PostgreSQL-Datenbank (mit dem Standardport):
167 9 Robert Schneider
168
<pre><code class="yml">
169
production:
170
  adapter: postgresql
171
  database: <your_database_name>
172
  host: <postgres_host>
173
  username: <postgres_user>
174
  password: <postgres_user_password>
175
  encoding: utf8
176 1 Robert Schneider
  schema_search_path: <database_schema> (default - public)
177 9 Robert Schneider
</code></pre>
178 1 Robert Schneider
179 34 C S
Beispiel für eine SQLite Datenbank
180 9 Robert Schneider
181
<pre><code class="yml">
182 1 Robert Schneider
production:
183 34 C S
  adapter: sqlite3
184
  database: db/redmine.sqlite3
185
</code></pre>
186
187
Beispiel für eine SQL-Server-Datenbank (mit Standard-Host @localhost@ und Standardport @1433@):
188
189
<pre><code class="yml">
190
production:
191 9 Robert Schneider
  adapter: sqlserver
192 1 Robert Schneider
  database: redmine
193 9 Robert Schneider
  username: redmine # sollte dem Datenbankbenutzer entsprechen
194
  password: redminepassword # sollte dem Login-Passwort entsprechen
195 1 Robert Schneider
</code></pre>
196 9 Robert Schneider
197
h3. Schritt 4 - Installation der Abhängigkeiten
198
199 10 Robert Schneider
Um die gem-Abhängigkeiten zu verwalten, verwendet Redmine "Bundler":http://gembundler.com/.
200
201 34 C S
Wenn Sie Ruby in der Version 2.5 oder früher benutzen, muss der Bundler erst installiert werden 	
202 1 Robert Schneider
203 10 Robert Schneider
<pre>gem install bundler</pre>
204 34 C S
205 10 Robert Schneider
Dann können alle von Redmine benötigten gems mit folgenden Kommando installiert werden:
206
207 43 C S
  <pre>bundle config set --local without 'development test' 
208
bundle install</pre>
209 10 Robert Schneider
210
h4. Optionale Abhängigkeiten
211 1 Robert Schneider
212
h5. RMagick 
213 10 Robert Schneider
214
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.
215 34 C S
216 31 Robert Schneider
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:
217 34 C S
218 43 C S
  <pre>bundle config set --local without 'development test rmagick' 
219
bundle install</pre>
220 11 Robert Schneider
221 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.
222 11 Robert Schneider
223
h5. Datenbankadapter
224
225 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).
226 15 Robert Schneider
227
@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.
228
229
h4. Weitere Abhängigkeiten (Gemfile.local)
230 12 Robert Schneider
231 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.
232
233
Beispiel:
234
235
<pre>
236
# Gemfile.local
237
gem 'puma'
238 1 Robert Schneider
</pre>
239 16 Robert Schneider
240
h3. Schritt 5 - Erzeugen des Session Store Secrets
241
242
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.
243 1 Robert Schneider
Das Erzeugen eines neuen Secret Tokens macht nach einem Neustart alle bestehenden Sesssions ungültig.
244 16 Robert Schneider
245 34 C S
<pre>bundle exec rake generate_secret_token</pre>
246 16 Robert Schneider
247
Alternativ kann das Secret auch in @config/secrets.yml@ gespeichert werden:
248
http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
249
250
h3. Schritt 6 - Anlegen der Datenbankstruktur und -daten
251
252 34 C S
Mit dem Ausführen der folgenden Anweisung im Root-Verzeichnis von Redmine wird die Datenbankstruktur angelegt:
253 16 Robert Schneider
254 1 Robert Schneider
  RAILS_ENV=production bundle exec rake db:migrate
255
256
Syntax unter Windows:
257 16 Robert Schneider
258
  set RAILS_ENV=production
259
bundle exec rake db:migrate
260
261
Damit werden nacheinander alle Migrationen durchgeführt - was die Tabellen, eine Reihe von Berechtigungen und das Administrator-Konto mit dem Namen @admin@ erzeugt.
262
263 1 Robert Schneider
h3. Schritt 7 - Grunddaten in die Datenbank einfügen
264 16 Robert Schneider
265 1 Robert Schneider
Mit folgender Anweisung werden die Daten der Grundkonfiguration in die Datenbank hinzugefügt:
266 16 Robert Schneider
267
  RAILS_ENV=production bundle exec rake redmine:load_default_data
268
269 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.
270
271
Beispiel für unixoide Systeme:
272
273 34 C S
  RAILS_ENV=production REDMINE_LANG=de bundle exec rake redmine:load_default_data
274 17 Robert Schneider
275
Beispiel für Windows:
276
277
<pre>
278
set RAILS_ENV=production
279 34 C S
set REDMINE_LANG=de
280 17 Robert Schneider
bundle exec rake redmine:load_default_data
281 18 Robert Schneider
</pre>
282
283 1 Robert Schneider
h3. Schritt 8 - Berechtigungen im Dateisystem
284 18 Robert Schneider
285
_Hinweis: Windows-Benutzer können diesen Abschnitt überspringen._
286
287
Der Benutzer, mit dem die Anwendung ausgeführt wird, muss die Berechtigung zum Schreiben in folgende Subverzeichnisse haben:
288
289
# @files@ (Speicherort für Anhänge)
290
# @log@ (Log-Datei der Anwendung @production.log@)
291
# @tmp@ and @tmp/pdf@ (Verzeichnisse sind anzulegen, falls sie noch nicht existieren; wird unter anderem auch für das Erstellen von PDFs verwendet)
292
# @public/plugin_assets@ (Assets der Plugins)
293
294
Beispiel - davon ausgehend, die Anwendung wird mit einem Benutzer @redmine@ betrieben:
295
296
<pre>
297
mkdir -p tmp tmp/pdf public/plugin_assets
298
sudo chown -R redmine:redmine files log tmp public/plugin_assets
299 19 Robert Schneider
sudo chmod -R 755 files log tmp public/plugin_assets
300 18 Robert Schneider
</pre>
301
302 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.
303
304
<pre>sudo find files log tmp public/plugin_assets -type f -exec chmod -x {} +</pre>
305
306 18 Robert Schneider
h3. Schritt 9 - Die Installation testen
307 1 Robert Schneider
308 18 Robert Schneider
Die Installation kann mit dem Ausführen des WEBrick-Webserver ausprobiert werden:
309 1 Robert Schneider
310 18 Robert Schneider
<pre>bundle exec rails server webrick -e production</pre>
311
312 34 C S
Wenn WEBrick gestartet wurde, kann im Browser http://localhost:3000/ aufgerufen werden. Es sollte dann die Willkommensseite von Redmine erscheinen.
313 18 Robert Schneider
314 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.
315 18 Robert Schneider
316
h3. Schritt 10 - In die Anwendung einloggen
317 19 Robert Schneider
318 18 Robert Schneider
Zum Einloggen wird der Administrator-Zugang verwendet:
319
320
* Mitgliedsname: admin
321
* Passwort: admin
322
323 1 Robert Schneider
Die meisten Einstellungen können nun vorgenommen werden indem man im Menü zur @Administration@ und dort in den Bereich @Konfiguration@ geht.
324 18 Robert Schneider
325
h2. Konfiguration
326
327 1 Robert Schneider
Die Redmine-Einstellungen werden in einer Datei namens @config/configuration.yml@ gespeichert.
328 20 Robert Schneider
329
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.
330
331 21 Robert Schneider
Diese Einstellungen können auch durch die Umgebungsvariablen für Rails vorgenommen werden (@production/development/test@).
332 20 Robert Schneider
333
+Wichtig+: die Anwendung muss nach jeder Änderung neu gestartet werden.
334
335 21 Robert Schneider
h3. Email/SMTP-Servereinstellungen
336
337 37 C S
Die Email-Konfiguration wird auf einer [[DeEmailConfiguration|separaten Seite]] erklärt.
338 21 Robert Schneider
339
h3. SCM-Einstellungen
340
341
Dieser Abschnitt ermöglicht:
342
343 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)
344 21 Robert Schneider
* das Festlegen des kompletten Pfads zu den SCM-Binärdateien
345
346 1 Robert Schneider
Beispiele (mit Subversion):
347 21 Robert Schneider
348
Überschreiben des Anweisungsnamen:
349
350
  scm_subversion_command: "svn_replacement.exe"
351 1 Robert Schneider
352 21 Robert Schneider
Setzen des Pfades:
353
354
  scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"
355
356
h3. Speichereinstellungen für Anhänge
357
358
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. 
359 1 Robert Schneider
360 21 Robert Schneider
Beispiele:
361 1 Robert Schneider
362 21 Robert Schneider
  attachments_storage_path: /var/redmine/files
363 1 Robert Schneider
364 22 Robert Schneider
  attachments_storage_path: D:/redmine/files
365
366 34 C S
h2. Konfiguration des Protokollierung 
367 22 Robert Schneider
368 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.
369 22 Robert Schneider
370 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.
371 22 Robert Schneider
372
<pre><code class="ruby">
373
#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
374
config.logger = Logger.new('/path/to/logfile.log', 2, 1000000)
375
config.logger.level = Logger::INFO
376
</code></pre>
377
378
h2. Sicherungen
379
380
Redmine-Sicherungen sollten enthalten:
381
382
* Daten (in der Redmine-Datenbank gespeichert)
383 26 Robert Schneider
* Anhänge (standardmäßig im @files@-Verzeichnis des Redmine-Installationsverzeichnisses enthalten)
384 22 Robert Schneider
385 34 C S
Weitere Informationen hierzu finden sie unter [[DeRedmineBackupRestore|Sichern und Wiederherstellen von Redmine]]
386 22 Robert Schneider
387
h2. Hinweise zur Installation unter Linux/Unix
388 26 Robert Schneider
389 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.
390
391
h2. Hinweise zur Installation unter Windows
392 23 Robert Schneider
393 22 Robert Schneider
Unter http://rubyinstaller.org gibt es einen vorgefertigtes Installationsprogramm für den Ruby-MRI (Matz' Ruby-Interpreter).
394
Nach dessen Installation ist _Start Command Prompt with Ruby_ im Startmenü auszuwählen.
395 24 Robert Schneider
396
+Setzen der @RAILS_ENV@-Variable:+
397
398
Beim Ausführen von Anweisungen, wie sie in dieser Anleitung beschrieben sind, muss die @RAILS_ENV@-Variable mit einer anderen Anweisung zuvor gesetzt werden.
399
400
D.h. Anweisungen mit der Syntax folgender Art:
401
402
<pre>
403
RAILS_ENV=production <irgendeine Anweisung>
404
<irgendeine Anweisung> RAILS_ENV=production
405
</pre>
406
407
müssen in zwei aufeinanderfolgende Anweisungen zerlegt werden:
408
409
<pre>
410
set RAILS_ENV=production
411 34 C S
<irgendeine Anweisung>
412 24 Robert Schneider
</pre>
413
414
+Probleme bei der Installation des MySQL-Gem+
415
416
Es kann nötig sein, das MySQL-Gem manuell mit folgender Anweisung zu installieren:
417
418
  gem install mysql
419
420
Und in manchen Fällen ist es erforderlich @libmysql.dll@ in das @ruby/bin@-Verzeichnis zu kopieren.
421
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.
422
423 25 Robert Schneider
*Wichtiger Hinweis für Windows 7 und höher*
424
425 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.
426 25 Robert Schneider
427
Dies lässt sich überprüfen indem @localhost@ gepingt wird: wenn @"::1:"@ gepingt wird, so ist IPv6 in Verwendung.
428
429
+Workaround:+
430
431
@localhost@ mit @127.0.0.1@ in @database.yml@ ersetzen.
432
433 34 C S
fn5. http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why
434 25 Robert Schneider
435 34 C S
fn6. http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx
436 25 Robert Schneider
437 34 C S
fn7. https://github.com/brianmario/mysql2/issues/279
438 22 Robert Schneider
439
h2. Alternative zur manuellen Installation
440
441
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.