Project

General

Profile

DeRedmineInstall » History » Version 8

Robert Schneider, 2015-06-16 00:26

1 1 Robert Schneider
h1. Installation von Redmine
2
3
{{>toc}}
4
5 2 Robert Schneider
Dies ist die Installationsanleitung für Redmine 1.4.0 und höher. Die Anleitung für 1.3.x findet sich "hier":/projects/redmine/wiki/RedmineInstall?version=146.
6
7
h2. Anforderungen
8
9
h3. Betriebssystem
10
11
Redmine sollte auf den meisten Unix-, Linux-, [[RedmineInstallOSX|Mac]]-, [[RedmineInstallOSXServer|Mac Server]]- und [[RedmineInstall#Notes-on-Windows-installation|Windows]]-Systemen laufen, sofern Ruby auf diesem System vorhanden ist. Weitere spezielle Installationsanleitungen finden sich  [[HowTos|hier]].
12
13
h3. Ruby-Interpreter
14
15
Die erforderliche Ruby-Version für die Redmine-Versionen sind:
16
17
|_. Redmine-Version|_. Unterstützte Ruby-Versionen                                |_. Verwendete Rails-Version|
18
|Aktueller Trunk     |ruby 1.9.3[3], 2.0.0[2], 2.1, 2.2[1]                      |Rails 4.2[0]      |
19
|3.0               |ruby 1.9.3[3], 2.0.0[2], 2.1, 2.2[1]                      |Rails 4.2[0]      |
20
|2.6               |ruby 1.8.7[4], 1.9.2, 1.9.3[3], 2.0.0[2], 2.1, jruby-1.7.6|Rails 3.2         |
21
22
*Redmine 2.x unterstützt kein Ruby 2.2* (#19652).
23
24
*Redmine 3.0 unterstützt kein JRuby* weil der activerecord-jdbc-adapter nicht "Rails 4.2":https://github.com/jruby/activerecord-jdbc-adapter/issues/599 unterstützt.
25
26 5 Robert Schneider
fn0. Rails 4.2.1 hat ein Problem mit Non-ASCII-URLs und MinGW-Ruby ("RubyInstaller für Windows":http://rubyinstaller.org/) thin und puma (#19321, #19374)
27 2 Robert Schneider
28
fn1. MinGW-Ruby 2.2 hat ein nokogiri-Problem (#19419).
29
30
fn2. Zum Zeitpunkt des Verfassens dieser Wiki-Seite (3/19/2013) war der SQL Server Support mit Ruby 2.0.0 unter Windows wegen einer "Datenbankadapter/Gem-Inkompatibilität":https://github.com/rails-sqlserver/tiny_tds/issues/110  als defekt gemeldet.
31
32
fn3. MRI 1.9.3p327 enthält "einen Bug":http://bugs.ruby-lang.org/issues/7374, der das Laden der Plugins verhindert - im Gegensatz zu 1.9.3p194 oder 1.9.3p392.
33
34
fn4. Ruby MRI 1.8.7 hat sein Lebenszyklusende erreicht - vom Gebrauch wird daher abgeraten. message#38518 and #14371 liefert dazu weitere Informationen.
35 3 Robert Schneider
36
h3. Unterstützte Datenbanken
37
38
* MySQL 5.0 oder höher
39
** C bindings sollten installiert sein, was die Geschwindigkeit wesentlich erhöht. Sie lassen sich mit @gem install mysql2@ installieren.
40
** Redmine 2.x ist nicht mit MySQL 5.7.3 (#17460) kompatibel. Diese Version wird erst mit Redmine 3.x unterstützt.
41
42
* PostgreSQL 8.2 oder höher
43
** Der Datenstyle der Datenbank sollte auf ISO gesetzt sein (Standardeinstellung bei PorgresSQL). Dies kann mit mit @"redmine_db" SET datestyle="ISO,MDY";@ erreicht werden.
44
** Einige Bugs in PostgreSQL 8.4.0 und 8.4.1 wirken sich auf das Verhalten von Redmine aus (#4259, #4314). Sie wurden jedoch in PostgreSQL 8.4.2 gefixt.
45
46
* Microsoft SQL Server
47
** Redmine 2.x: 2008 oder höher (seit Redmine 2.3.0)
48
** Redmine 3.x: "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
49
50
* SQLite 3 (nicht für den Produktiveinsatz mit mehreren Benutzern gedacht!)
51 4 Robert Schneider
52
h3. Optionale Komponenten
53
54
* SCM-Programme (z.B. @svn@) für das Browsen in Projektarchiven. [[RedmineRepositories]] enthält Informationen zu Kompatibilitäten und Anforderungen.
55
* "ImageMagick":http://www.imagemagick.org/ (um den Gantt-Export zu PNG-Bildern und die Generierung von Vorschaubildern zu ermöglichen).
56
* "Ruby-OpenID-Bibliothek":http://openidenabled.com/ruby-openid/ (um OpenID zu unterstützen). Es wird dazu Version 2 oder höher benötigt.
57 6 Robert Schneider
58
h2. Redmine-Version
59
60
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.
61 7 Robert Schneider
62
h2. Ablauf der Installation
63
64
h3. Schritt 1 - Redmine holen
65
66
Der Source-Code von Redmine kann entweder durch das Herunterladen eines gepackten Releases oder durch das Auschecken des Codes geholt werden.
67
68
Mehr Informationen auf der [[Download|Download-Seite]].
69
70
h3. Schritt 2 - Eine leere Datenbank erstellen und einen Benutzer zuweisen
71
72
Nach den folgenden Anweisungen heißt der Datenbankbenutzer von Redmine @redmine@, jedoch kann der Name auch geändert werden.
73
74
h4. MySQL
75
76
<pre><code class="sql">
77
CREATE DATABASE redmine CHARACTER SET utf8;
78
CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password';
79
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';
80
</code></pre>
81
82
Für MySQL-Versionen vor 5.0.2 die Anweisung 'CREATE USER' ersetzen durch:
83
84
<pre><code class="sql">
85
GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password';
86
</code></pre>
87
88
h4. PostgreSQL
89
90
<pre><code class="sql">
91
CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity';
92
CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine;
93
</code></pre>
94
95
h4. SQL Server
96
97
Die Datenbank, das Login und der Benutzer können im _SQL Server Management Studio_ mit ein paar Klicks erstellt werden.
98
99
Hier aber auch ein Beispiel auf der der Kommandozeile mit @SQLCMD@:
100
101 8 Robert Schneider
{{collapse(Zeige SQL,Verberge SQL)
102 7 Robert Schneider
<pre><code class="sql">
103
USE [master]
104
GO
105
106 8 Robert Schneider
-- Simples Erzeugen einer DB
107 7 Robert Schneider
CREATE DATABASE [REDMINE]
108
GO
109
110
-- Anlegen eines Logins mit Benutzer/Passwort-Authentifizierung, ohne Ablauf des Passworts
111
CREATE LOGIN [REDMINE] WITH PASSWORD=N'redminepassword', DEFAULT_DATABASE=[REDMINE], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF
112
GO
113
114
-- Erzeugung des Benutzers für das zuvor angelegte Login
115
USE [REDMINE]
116
GO
117
CREATE USER [REDMINE] FOR LOGIN [REDMINE]
118
GO
119
120
-- Benutzerberechtigungen mit Rollen
121
EXEC sp_addrolemember N'db_datareader', N'REDMINE'
122
GO
123
EXEC sp_addrolemember N'db_datawriter', N'REDMINE'
124
GO
125
</code></pre>
126
}}