Project

General

Profile

DeRedmineInstall » History » Version 48

C S, 2023-11-30 09:46
Translate upgrade to Rev 332

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