Project

General

Profile

DeRedmineInstall » History » Version 39

C S, 2021-12-29 08:14

1 1 Robert Schneider
{{>toc}}
2 14 Robert Schneider
3 39 C S
Übersetzung von "Rev. 320":http://www.redmine.org/projects/redmine/wiki/RedmineInstall/320
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 39 C S
|trunk (>= "r21329":https://redmine.org/projects/redmine/repository/revisions/21329 )|Ruby 2.5[1], 2.6, 2.7, 3.0, 3.1|Rails 6.1      |
23
|4.2               |Ruby 2.4[1], 2.5[1], 2.6, 2.7[2]                                               |Rails 5.2 |
24
|4.1               |Ruby 2.3[1], 2.4[1], 2.5[1], 2.6                                  |Rails 5.2 |
25 1 Robert Schneider
26 39 C S
fn1. Die Unterstützung von Ruby 2.5 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/.
27 35 C S
28 39 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)
29 32 C S
30 39 C S
31
32 2 Robert Schneider
*Wichtige Hinweise:*
33 35 C S
34 39 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 10 Robert Schneider
203 34 C S
<pre>gem install bundler</pre>
204 10 Robert Schneider
205
Dann können alle von Redmine benötigten gems mit folgenden Kommando installiert werden:
206
207 34 C S
  <pre>bundle install --without development test</pre>
208 10 Robert Schneider
209
h4. Optionale Abhängigkeiten
210 1 Robert Schneider
211 10 Robert Schneider
h5. RMagick 
212
213 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.
214 31 Robert Schneider
215 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:
216 31 Robert Schneider
217 34 C S
  <pre>bundle install --without development test rmagick</pre>
218 11 Robert Schneider
219 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.
220 11 Robert Schneider
221
h5. Datenbankadapter
222
223 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).
224 15 Robert Schneider
225
@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.
226
227
h4. Weitere Abhängigkeiten (Gemfile.local)
228 12 Robert Schneider
229 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.
230
231
Beispiel:
232
233
<pre>
234
# Gemfile.local
235
gem 'puma'
236 1 Robert Schneider
</pre>
237 16 Robert Schneider
238
h3. Schritt 5 - Erzeugen des Session Store Secrets
239
240
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.
241 1 Robert Schneider
Das Erzeugen eines neuen Secret Tokens macht nach einem Neustart alle bestehenden Sesssions ungültig.
242 16 Robert Schneider
243 34 C S
<pre>bundle exec rake generate_secret_token</pre>
244 16 Robert Schneider
245
Alternativ kann das Secret auch in @config/secrets.yml@ gespeichert werden:
246
http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
247
248
h3. Schritt 6 - Anlegen der Datenbankstruktur und -daten
249
250 34 C S
Mit dem Ausführen der folgenden Anweisung im Root-Verzeichnis von Redmine wird die Datenbankstruktur angelegt:
251 16 Robert Schneider
252
  RAILS_ENV=production bundle exec rake db:migrate
253
254
Syntax unter Windows:
255
256
  set RAILS_ENV=production
257
bundle exec rake db:migrate
258
259 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.
260 16 Robert Schneider
261
+Problemlösung für Ubuntu+
262
263 1 Robert Schneider
Falls unter Ubuntu dieser Fehler entsteht:
264
265
<pre>
266 16 Robert Schneider
Rake aborted!
267
no such file to load -- net/https
268
</pre>
269
270
dann ist es erforderlich @libopenssl-ruby1.8@ mittels @apt-get install libopenssl-ruby1.8@ zu installieren.
271
272 1 Robert Schneider
h3. Schritt 7 - Grunddaten in die Datenbank einfügen
273 16 Robert Schneider
274 1 Robert Schneider
Mit folgender Anweisung werden die Daten der Grundkonfiguration in die Datenbank hinzugefügt:
275 16 Robert Schneider
276
  RAILS_ENV=production bundle exec rake redmine:load_default_data
277
278 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.
279
280
Beispiel für unixoide Systeme:
281
282 34 C S
  RAILS_ENV=production REDMINE_LANG=de bundle exec rake redmine:load_default_data
283 17 Robert Schneider
284
Beispiel für Windows:
285
286
<pre>
287
set RAILS_ENV=production
288 34 C S
set REDMINE_LANG=de
289 17 Robert Schneider
bundle exec rake redmine:load_default_data
290 18 Robert Schneider
</pre>
291
292 1 Robert Schneider
h3. Schritt 8 - Berechtigungen im Dateisystem
293 18 Robert Schneider
294
_Hinweis: Windows-Benutzer können diesen Abschnitt überspringen._
295
296
Der Benutzer, mit dem die Anwendung ausgeführt wird, muss die Berechtigung zum Schreiben in folgende Subverzeichnisse haben:
297
298
# @files@ (Speicherort für Anhänge)
299
# @log@ (Log-Datei der Anwendung @production.log@)
300
# @tmp@ and @tmp/pdf@ (Verzeichnisse sind anzulegen, falls sie noch nicht existieren; wird unter anderem auch für das Erstellen von PDFs verwendet)
301
# @public/plugin_assets@ (Assets der Plugins)
302
303
Beispiel - davon ausgehend, die Anwendung wird mit einem Benutzer @redmine@ betrieben:
304
305
<pre>
306
mkdir -p tmp tmp/pdf public/plugin_assets
307
sudo chown -R redmine:redmine files log tmp public/plugin_assets
308 19 Robert Schneider
sudo chmod -R 755 files log tmp public/plugin_assets
309 18 Robert Schneider
</pre>
310
311 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.
312
313
<pre>sudo find files log tmp public/plugin_assets -type f -exec chmod -x {} +</pre>
314
315 18 Robert Schneider
h3. Schritt 9 - Die Installation testen
316 1 Robert Schneider
317 18 Robert Schneider
Die Installation kann mit dem Ausführen des WEBrick-Webserver ausprobiert werden:
318 1 Robert Schneider
319 18 Robert Schneider
<pre>bundle exec rails server webrick -e production</pre>
320
321 34 C S
Wenn WEBrick gestartet wurde, kann im Browser http://localhost:3000/ aufgerufen werden. Es sollte dann die Willkommensseite von Redmine erscheinen.
322 18 Robert Schneider
323 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.
324 18 Robert Schneider
325
h3. Schritt 10 - In die Anwendung einloggen
326 19 Robert Schneider
327 18 Robert Schneider
Zum Einloggen wird der Administrator-Zugang verwendet:
328
329
* Mitgliedsname: admin
330
* Passwort: admin
331
332 1 Robert Schneider
Die meisten Einstellungen können nun vorgenommen werden indem man im Menü zur @Administration@ und dort in den Bereich @Konfiguration@ geht.
333 18 Robert Schneider
334
h2. Konfiguration
335
336 1 Robert Schneider
Die Redmine-Einstellungen werden in einer Datei namens @config/configuration.yml@ gespeichert.
337 20 Robert Schneider
338
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.
339
340 21 Robert Schneider
Diese Einstellungen können auch durch die Umgebungsvariablen für Rails vorgenommen werden (@production/development/test@).
341 20 Robert Schneider
342
+Wichtig+: die Anwendung muss nach jeder Änderung neu gestartet werden.
343
344 21 Robert Schneider
h3. Email/SMTP-Servereinstellungen
345
346 37 C S
Die Email-Konfiguration wird auf einer [[DeEmailConfiguration|separaten Seite]] erklärt.
347 21 Robert Schneider
348
h3. SCM-Einstellungen
349
350
Dieser Abschnitt ermöglicht:
351
352 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)
353 21 Robert Schneider
* das Festlegen des kompletten Pfads zu den SCM-Binärdateien
354
355 1 Robert Schneider
Beispiele (mit Subversion):
356 21 Robert Schneider
357
Überschreiben des Anweisungsnamen:
358
359
  scm_subversion_command: "svn_replacement.exe"
360 1 Robert Schneider
361 21 Robert Schneider
Setzen des Pfades:
362
363
  scm_subversion_command: "C:\Program Files\Subversion\bin\svn.exe"
364
365
h3. Speichereinstellungen für Anhänge
366
367
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. 
368 1 Robert Schneider
369 21 Robert Schneider
Beispiele:
370 1 Robert Schneider
371 21 Robert Schneider
  attachments_storage_path: /var/redmine/files
372 1 Robert Schneider
373 22 Robert Schneider
  attachments_storage_path: D:/redmine/files
374
375 34 C S
h2. Konfiguration des Protokollierung 
376 22 Robert Schneider
377 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.
378 22 Robert Schneider
379 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.
380 22 Robert Schneider
381
<pre><code class="ruby">
382
#Logger.new(PATH,NUM_FILES_TO_ROTATE,FILE_SIZE)
383
config.logger = Logger.new('/path/to/logfile.log', 2, 1000000)
384
config.logger.level = Logger::INFO
385
</code></pre>
386
387
h2. Sicherungen
388
389
Redmine-Sicherungen sollten enthalten:
390
391
* Daten (in der Redmine-Datenbank gespeichert)
392 26 Robert Schneider
* Anhänge (standardmäßig im @files@-Verzeichnis des Redmine-Installationsverzeichnisses enthalten)
393 22 Robert Schneider
394 34 C S
Weitere Informationen hierzu finden sie unter [[DeRedmineBackupRestore|Sichern und Wiederherstellen von Redmine]]
395 22 Robert Schneider
396
h2. Hinweise zur Installation unter Linux/Unix
397 26 Robert Schneider
398 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.
399
400
h2. Hinweise zur Installation unter Windows
401 23 Robert Schneider
402 22 Robert Schneider
Unter http://rubyinstaller.org gibt es einen vorgefertigtes Installationsprogramm für den Ruby-MRI (Matz' Ruby-Interpreter).
403
Nach dessen Installation ist _Start Command Prompt with Ruby_ im Startmenü auszuwählen.
404 24 Robert Schneider
405
+Setzen der @RAILS_ENV@-Variable:+
406
407
Beim Ausführen von Anweisungen, wie sie in dieser Anleitung beschrieben sind, muss die @RAILS_ENV@-Variable mit einer anderen Anweisung zuvor gesetzt werden.
408
409
D.h. Anweisungen mit der Syntax folgender Art:
410
411
<pre>
412
RAILS_ENV=production <irgendeine Anweisung>
413
<irgendeine Anweisung> RAILS_ENV=production
414
</pre>
415
416
müssen in zwei aufeinanderfolgende Anweisungen zerlegt werden:
417
418
<pre>
419
set RAILS_ENV=production
420 34 C S
<irgendeine Anweisung>
421 24 Robert Schneider
</pre>
422
423
+Probleme bei der Installation des MySQL-Gem+
424
425
Es kann nötig sein, das MySQL-Gem manuell mit folgender Anweisung zu installieren:
426
427
  gem install mysql
428
429
Und in manchen Fällen ist es erforderlich @libmysql.dll@ in das @ruby/bin@-Verzeichnis zu kopieren.
430
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.
431
432 25 Robert Schneider
*Wichtiger Hinweis für Windows 7 und höher*
433
434 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.
435 25 Robert Schneider
436
Dies lässt sich überprüfen indem @localhost@ gepingt wird: wenn @"::1:"@ gepingt wird, so ist IPv6 in Verwendung.
437
438
+Workaround:+
439
440
@localhost@ mit @127.0.0.1@ in @database.yml@ ersetzen.
441
442 34 C S
fn5. http://serverfault.com/questions/4689/windows-7-localhost-name-resolution-is-handled-within-dns-itself-why
443 25 Robert Schneider
444 34 C S
fn6. http://www.victor-ratajczyk.com/post/2012/02/25/mysql-fails-to-resolve-localhost-disable-ipv6-on-windows.aspx
445 25 Robert Schneider
446 34 C S
fn7. https://github.com/brianmario/mysql2/issues/279
447 22 Robert Schneider
448
h2. Alternative zur manuellen Installation
449
450
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.