DeRedmineInstall » History » Revision 16
Revision 15 (Robert Schneider, 2015-06-16 10:24) → Revision 16/52 (Robert Schneider, 2015-06-16 10:49)
{{>toc}}
Übersetzung von "Revision 246":http://www.redmine.org/projects/redmine/wiki/RedmineInstall/246
h1. Installation von Redmine
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(Zeige SQL,Verberge SQL)
<pre><code class="sql">
USE [master]
GO
-- Simples Erzeugen einer 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>
}}
h3. Schritt 3 - Konfiguration der Datenbankverbindung
Um die Datenbankverbindung für den Produktiveinsatz zu konfigurieren wird @config/database.yml.example@ nach @config/database.yml@ kopiert und wie folgt bearbeitet.
Beispiel für eine MySQL-Datenbank unter Verwendung von Ruby 1.8 oder jRuby:
<pre><code class="yml">
production:
adapter: mysql
database: redmine
host: localhost
username: redmine
password: my_password
</code></pre>
Beispiel für eine MySQL-Datenbank unter Verwendung von Ruby 1.9 (@adapter@ muss auf @mysql2@ gesetzt werden):
<pre><code class="yml">
production:
adapter: mysql2
database: redmine
host: localhost
username: redmine
password: my_password
</code></pre>
Diese Konfiguration ist zu verwenden, falls der Server nicht auf dem Standardport (3306) horcht:
<pre><code class="yml">
production:
adapter: mysql
database: redmine
host: localhost
port: 3307
username: redmine
password: my_password
</code></pre>
Beispiel für eine PostgreSQL-Datenbank (mit dem Standardport):
<pre><code class="yml">
production:
adapter: postgresql
database: <your_database_name>
host: <postgres_host>
username: <postgres_user>
password: <postgres_user_password>
encoding: utf8
schema_search_path: <database_schema> (default - public)
</code></pre>
Beispiel für eine SQL-Server-Datenbank (mit Standard-Host @localhost@ und Standardport 1433):
<pre><code class="yml">
production:
adapter: sqlserver
database: redmine
username: redmine # sollte dem Datenbankbenutzer entsprechen
password: redminepassword # sollte dem Login-Passwort entsprechen
</code></pre>
h3. Schritt 4 - Installation der Abhängigkeiten
Um die gem-Abhängigkeiten zu verwalten, verwendet Redmine "Bundler":http://gembundler.com/.
Zuerst muss Bundler installiert werden:
gem install bundler
Dann können alle von Redmine benötigten gems mit folgenden Kommando installiert werden:
bundle install --without development test
h4. Optionale Abhängigkeiten
h5. RMagick
RMagick rrmöglicht die Verwendung von ImageMagick, welches wiederum erlaubt Bilder für die Erzeugung von PDFs und und für den PNG-Export generieren zu lassen.
Falls ImageMagick auf dem System nicht installiert ist, sollte die Installation des RMagick Gem ausgelassen werden:
bundle install --without development test rmagick
Falls es bei der Installation von RMagick unter Windows zu Problemen kommt, kann man in diesem [[HowTo_install_rmagick_gem_on_Windows|HowTo]] weitere Informationen finden.
h5. Datenbankadapter
Redmine installiert automatisch die Adapter-Gems, die von Datenbankkonfiguration benötigt werden, in dem es die Datei @config/database.yml@ ausliest.
@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.
h4. Weitere Abhängigkeiten (Gemfile.local)
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.
Beispiel:
<pre>
# Gemfile.local
gem 'puma'
</pre>
h3. Schritt 5 - Erzeugen des Session Store Secrets
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.
Das Erzeugen eines neuen Secret Tokens macht nach einem Neustart alle bestehenden Sesssions ungültig.
* mit Redmine 1.4.x:
<pre>
bundle exec rake generate_session_store
</pre>
* mit Redmine 2.x
<pre>
bundle exec rake generate_secret_token
</pre>
Alternativ kann das Secret auch in @config/secrets.yml@ gespeichert werden:
http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
h3. Schritt 6 - Anlegen der Datenbankstruktur und -daten
Mit dem Ausführen der folgende Anweisung im Root-Verzeichnis von Redmine wird die Datenbankstruktur angelegt:
RAILS_ENV=production bundle exec rake db:migrate
Syntax unter Windows:
set RAILS_ENV=production
bundle exec rake db:migrate
Damit werden nacheinander alle Migrationen durchgeführt - was die Tabellen, eine Reihe von Berechtigungen und das Administrator-Konto erzeugt.
+Problemlösung für Ubuntu+
Falls unter Ubuntu dieser Fehler entsteht:
<pre>
Rake aborted!
no such file to load -- net/https
</pre>
dann ist es erforderlich @libopenssl-ruby1.8@ mittels @apt-get install libopenssl-ruby1.8@ zu installieren.
h3. Grunddaten für die Datenbank