Project

General

Profile

DeRedmineInstall » History » Version 38

C S, 2021-11-29 10:53
Refined step 1 as suggested in https://www.redmine.org/boards/2/topics/66351 - Adaptation of the translation to the original Rev. 319

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