Project

General

Profile

DeRedmineInstall » History » Revision 7

Revision 6 (Robert Schneider, 2015-06-15 23:58) → Revision 7/52 (Robert Schneider, 2015-06-16 00:24)

h1. Installation von Redmine 

 {{>toc}} 

 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. 

 h2. Anforderungen 

 h3. Betriebssystem 

 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]]. 

 h3. Ruby-Interpreter 

 Die erforderliche Ruby-Version für die Redmine-Versionen sind: 

 |_. Redmine-Version|_. Unterstützte Ruby-Versionen                                  |_. Verwendete Rails-Version| 
 |Aktueller Trunk       |ruby 1.9.3[3], 2.0.0[2], 2.1, 2.2[1]                        |Rails 4.2[0]        | 
 |3.0                 |ruby 1.9.3[3], 2.0.0[2], 2.1, 2.2[1]                        |Rails 4.2[0]        | 
 |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           | 

 *Redmine 2.x unterstützt kein Ruby 2.2* (#19652). 

 *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. 

 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) 

 fn1. MinGW-Ruby 2.2 hat ein nokogiri-Problem (#19419). 

 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. 

 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. 

 fn4. Ruby MRI 1.8.7 hat sein Lebenszyklusende erreicht - vom Gebrauch wird daher abgeraten. message#38518 and #14371 liefert dazu weitere Informationen. 

 h3. Unterstützte Datenbanken 

 * MySQL 5.0 oder höher 
 ** C bindings sollten installiert sein, was die Geschwindigkeit wesentlich erhöht. Sie lassen sich mit @gem install mysql2@ installieren. 
 ** Redmine 2.x ist nicht mit MySQL 5.7.3 (#17460) kompatibel. Diese Version wird erst mit Redmine 3.x unterstützt. 

 * PostgreSQL 8.2 oder höher 
 ** Der Datenstyle der Datenbank sollte auf ISO gesetzt sein (Standardeinstellung bei PorgresSQL). Dies kann mit mit @"redmine_db" SET datestyle="ISO,MDY";@ erreicht werden. 
 ** 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. 

 * Microsoft SQL Server 
 ** Redmine 2.x: 2008 oder höher (seit Redmine 2.3.0) 
 ** 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 

 * SQLite 3 (nicht für den Produktiveinsatz mit mehreren Benutzern gedacht!) 

 h3. Optionale Komponenten 

 * SCM-Programme (z.B. @svn@) für das Browsen in Projektarchiven. [[RedmineRepositories]] enthält Informationen zu Kompatibilitäten und Anforderungen. 
 * "ImageMagick":http://www.imagemagick.org/ (um den Gantt-Export zu PNG-Bildern und die Generierung von Vorschaubildern zu ermöglichen). 
 * "Ruby-OpenID-Bibliothek":http://openidenabled.com/ruby-openid/ (um OpenID zu unterstützen). Es wird dazu Version 2 oder höher benötigt. 

 

 h2. Redmine-Version 

 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. 

 h2. Ablauf der Installation 

 h3. Schritt 1 - Redmine holen 

 Der Source-Code von Redmine kann entweder durch das Herunterladen eines gepackten Releases oder durch das Auschecken des Codes geholt werden. 

 Mehr Informationen auf der [[Download|Download-Seite]]. 

 h3. Schritt 2 - Eine leere Datenbank erstellen und einen Benutzer zuweisen 

 Nach den folgenden Anweisungen heißt der Datenbankbenutzer von Redmine @redmine@, jedoch kann der Name auch geändert werden. 

 h4. MySQL 

 <pre><code class="sql"> 
 CREATE DATABASE redmine CHARACTER SET utf8; 
 CREATE USER 'redmine'@'localhost' IDENTIFIED BY 'my_password'; 
 GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost'; 
 </code></pre> 

 Für MySQL-Versionen vor 5.0.2 die Anweisung 'CREATE USER' ersetzen durch: 

 <pre><code class="sql"> 
 GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost' IDENTIFIED BY 'my_password'; 
 </code></pre> 

 h4. PostgreSQL 

 <pre><code class="sql"> 
 CREATE ROLE redmine LOGIN ENCRYPTED PASSWORD 'my_password' NOINHERIT VALID UNTIL 'infinity'; 
 CREATE DATABASE redmine WITH ENCODING='UTF8' OWNER=redmine; 
 </code></pre> 

 h4. SQL Server 

 Die Datenbank, das Login und der Benutzer können im _SQL Server Management Studio_ mit ein paar Klicks erstellt werden. 

 Hier aber auch ein Beispiel auf der der Kommandozeile mit @SQLCMD@: 

 {{collapse(Show SQL,Hide SQL) 
 <pre><code class="sql"> 
 USE [master] 
 GO 

 -- Simples Erzeugen der DB 
 CREATE DATABASE [REDMINE] 
 GO 

 -- Anlegen eines Logins mit Benutzer/Passwort-Authentifizierung, ohne Ablauf des Passworts 
 CREATE LOGIN [REDMINE] WITH PASSWORD=N'redminepassword', DEFAULT_DATABASE=[REDMINE], CHECK_EXPIRATION=OFF, CHECK_POLICY=OFF 
 GO 

 -- Erzeugung des Benutzers für das zuvor angelegte Login 
 USE [REDMINE] 
 GO 
 CREATE USER [REDMINE] FOR LOGIN [REDMINE] 
 GO 

 -- Benutzerberechtigungen mit Rollen 
 EXEC sp_addrolemember N'db_datareader', N'REDMINE' 
 GO 
 EXEC sp_addrolemember N'db_datawriter', N'REDMINE' 
 GO 
 </code></pre> 
 }}