Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- howto:ubuntu:redmine [2013/05/19 16:51] – Externe Bearbeitung 127.0.0.1
+++ howto:ubuntu:redmine [2014/09/17 21:39] (aktuell) – gelöscht casper
@@ Zeile 1: / Zeile 1: @@
-====== Redmine unter Ubuntu 9.10 ======
-> Redmine is a flexible project management web application. Written using Ruby on Rails framework, it is cross-platform and cross-database.
-Es ist besonders für Programmentwicklungen geeignet, da es Schnittstellen zu SVN, Git und anderen Versionierungstools mitbringt. Der Unterschied zu Wikis oder Foren ist eben, dass es Projektbasierend ist. Das heißt soviel, dass man ein Projekt anlegen kann und darin ein Wiki, Foren und so weiter anlegen kann.
-Im Folgenden möchte ich erklären wie man es unter Ubuntu 9.10 installiert und mit einem Mongrel Cluster und Apache lauffähig und vor allem es performanter macht.
-===== Pakete installieren =====
-Im ersten Schritt installieren wir alle Pakete die benötigt werden. Ich benutze bspw. MySQL, es ist aber auch mit anderen Datenbanken möglich.
-<code>aptitude install mysql-server-5.0 libmysql-ruby subversion apache2-mpm-itk ruby rubygems irb ri rdoc ruby1.8-dev rake libapache2-mod-fastcgi libopenssl-ruby1.8</code>
-Anschließend installieren wir Ruby on Rails und Mongrel (Das kann ein wenig dauern)
-<code>gem install rails mongrel mongrel_cluster daemons --include-dependencies</code>
-Danach muss man noch ein paar Symlinks anlegen
-<code>ln -s /var/lib/gems/1.8/bin/mongrel_rails /usr/bin/mongrel_rails
-ln -s /var/lib/gems/1.8/bin/rails /usr/bin/rails
-ln -s /var/lib/gems/1.8/bin/mongrel_cluster_ctl /usr/bin/mongrel_cluster_ctl</code>
-===== Datenbank vorbereiten =====
-Für die Installation müssen wir nun noch einen Benutzer und eine Datenbank anlegen.
-<code>mysql -u root -p</code>
-<code sql>create user 'redmine'@'localhost';
-set password for 'redmine'@'localhost' = password('PASSWORT');
-create database redmine;
-grant all on redmine.* to 'redmine'@'localhost';
-quit</code>
-===== Redmine konfigurieren =====
-Nun können wir die aktuelle Version von Redmine via subversion runterladen. Dazu müssen wir in das Verzeichnis wechseln, in das wir Redmine installieren wollen. Ich habe es einfach in /var/www installiert (auf dem Server läuft nichts anderes)
-<code>cd /var/www
-svn co http://redmine.rubyforge.org/svn/trunk .</code>
-Anschließend müssen wir die Datenbankverbindung angeben und ein paar Sachen an der config/enviroment.rb ändern
-<code>cd config/
-cp database.yml.example database.yml
-nano -w database.yml</code>
-Gleich im ersten Block müssen wir etwas ändern. Es sollte so aussehen (natürlich müsst ihr eurer Passwort eintragen)
-<code yml>production:
-  adapter: mysql
-  database: redmine
-  host: localhost
-  username: redmine
-  password: PASSWORT
-  encoding: utf8</code>
-Danach müssen wir die Rails Version in der enviroment.rb auskommentieren (wir haben bei 9.10 eine aktuellere Version) und ein "Secret Word" für einen Cookie setzen.
-<code>nano -w enviroment.rb</code>
-Einfach eine Raute davor:
-<code ruby># Specifies gem version of Rails to use when vendor/rails is not present
-# RAILS_GEM_VERSION = '2.3.4' unless defined? RAILS_GEM_VERSION</code>
-In die vorletzte Zeile dann die Cookie Information (das :secret habe ich mittels pwgen erzeugt)
-<code ruby># [...]
-   config.action_controller.session = { :key => "_myapp_session", :secret => "FZRVfSdulCHtXfE1I1gGit49VVRM8gS2Pin9JlLA" }
-end</code>
-Nun können wir das Schema in die Datenbank schreiben
-<code shell>rake db:migrate RAILS_ENV="production"</code>
-===== Der erste Start =====
-<code shell>ruby /var/www/script/server -e production</code>
-Jetzt schauen wir ob wir Redmine sehen können:
-http://localhost:3000
-===== Konfiguration für Apache =====
-Nun können wir das Mongrel Cluster konfigurieren und starten. Der erste Befehl erstellt drei Instanzen auf den Ports 8000,8001,8002 und zwar mit dem Benutzer www-data
-<code shell>mongrel_rails cluster::configure -e production -p 8000 -N 3 -c /var/www --user www-data --group www-data
-mongrel_rails cluster::start</code>
-Anschließend weißen wir www-data alle Dateien und Ordner im /var/www zu
-<code shell>chown -R www-data:www-data /var/www/</code>
-Für Apache müssen ein paar Module nachgeladen werden:
-<code shell>a2enmod proxy_balancer
-a2enmod proxy
-a2enmod proxy_http
-a2enmod rewrite
-a2enmod ssl</code>
-Nun da wir die Module geladen haben, müssen wir noch erlauben, dass der Proxy benutzt werden darf. Dies steht in der proxy.conf unter /etc/apache2/mods-enabled/
-<code shell>nano -w /etc/apache2/mods-enabled/proxy.conf</code>
-So sollte es dann aussehen:
-<code>        <Proxy *>
-                AddDefaultCharset off
-                Order allow,deny
-                Allow from all
-                #Allow from .example.com
-        </Proxy></code>
-Da ich nur eine Website (eben das Redmine) laufen habe, musste ich keinen neuen vHost anlegen, sondern habe den existierenden geändert
-<code shell>nano -w /etc/apache2/sites-enabled/000-default</code>
-Noch dazu lasse ich das alles nur via https laufen, aber ohne sehe es nicht viel anders aus
-<code apache><VirtualHost *:80>
-        ServerAdmin postmaster@systemli.org
-        ServerName subdomain.systemli.org
-        RedirectMatch ^/(.*) https://subdomain.systemli.org/$1
-</VirtualHost>
-<VirtualHost *:443>
-        ServerAdmin postmaster@systemli.org
-        ServerName subdomain.systemli.org
-        SSLEngine On
-        SSLCipherSuite HIGH
-        SSLProtocol all -SSLv2
-        SSLCertificateFile /etc/ssl/subdomain.systemli.org.crt
-        SSLCertificateKeyFile /etc/ssl/subdomain.systemli.org.key
-        RewriteEngine On
-        # Redirect all non-static requests to cluster
-        RewriteCond %{DOCUMENT_ROOT}/%{REQUEST_FILENAME} !-f
-        RewriteRule ^/(.*)$ balancer://redminecluster%{REQUEST_URI} [P,QSA,L]
-</VirtualHost>
-<Proxy balancer://redminecluster>
-        BalancerMember http://127.0.0.1:8000
-        BalancerMember http://127.0.0.1:8001
-        BalancerMember http://127.0.0.1:8002
-</Proxy></code>
-Abschließend starten wir den Apache Server neu und können die Domain aufrufen
-<code shell>service apache2 restart</code>
-https://subdomain.systemli.org
-===== Links =====
-  * http://www.redmine.org/