Ein einfaches „apt-get install redmine“ reicht nicht mehr, um eine aktuelle Redmine-Installation auf Ubuntu zu installieren. Aus diesem Grund dokumentiere ich hier, wie ich bei mir Redmine installiert habe.
Orientiert an dieser Anleitung poste ich hier meine Arbeitsschritte:
Prequisits / Voraussetzungen für Redmine schaffen
Apache installieren
apt-get install --no-install-recommends apache2 libapache2-mod-passenger logrotate ssl-cert
Ruby, git und andere Redmine-Abhängigkeiten installieren:
apt-get install --no-install-recommends git ruby ruby-dev ruby-rmagick rake make gcc libmysqlclient-dev patch
Quelltext von RUBY mittels git herunterladen
Apache installieren
cd /var/www git clone https://github.com/redmine/redmine
Anschließend wird das redmine-repository geklont:
Anschließend wechselt ihr in das redmine-Verzeichnis und wechselt den Branch auf den aktuellen Stable:
cd redmine git checkout 3.1-stable
Als nächstes bedienen wir uns dem offiziellen „Ruby Paketsystem“, um die Abhängigkeiten für Ruby downzuloaden. Achtet darauf, bei dem Befehl die HTTPS-Verbindung zur Paketquelle anzugeben!
Dafür müssen wir als erstes die Paketquelle in eine Datei schreiben mit dem Befehl:
cat << EOF >> /etc/gemrc
In die Datei schreibt ihr die folgenden Zeilen:
:sources: - https://rubygems.org EOF
Anschließend wechselt ihr in das Verzeichnis /var/www/redmine und installiert die Pakete „bundler“ und „nokogiri“
cd /var/www/redmine gem install --no-ri --no-rdoc bundler nokogiri hash -r
An dieser Stelle weiche ich von der oben genannten englischen Anleitung ab und gebe meinen externen MySQL-Server an, indem ich die Config kopiere und editiere:
cd config sudo cp database.yml.example database.yml sudo vim database.yml
Kopiert noch diese Zeilen in die database.yml:
# Clean up the environment unset REDMINE_PASSWORD
Nutze Bundler zum installieren erforderlicher gems und deaktiviere nicht genutzte:
cd /var/www/redmine bundle install --without development test postgresql sqlite rmagick
Konfiguration
Um eine MySQL-Datenbank anzulegen, verbindet Euch mit dem MySQL-Server Eurer Wahl oder legt einen lokalen mittelt apt-get install mysql-server an.
Mit den folgenden Befehlen legt ihr eine mysql-Datenbank mit einem zufääligen Passwort an:
REDMINE_PASSWORD=$(openssl rand -base64 33) mysql -e "CREATE DATABASE redmine CHARACTER SET utf8;" mysql -e "CREATE USER 'redmine'@'localhost' IDENTIFIED BY '$REDMINE_PASSWORD';" mysql -e "GRANT ALL PRIVILEGES ON redmine.* TO 'redmine'@'localhost';"
Redmine
Als nächstes legt ihr einen User „redmine“ an:
adduser --quiet --system --group --gecos 'Passenger user for redmine' --shell /usr/sbin/nologin --home /nonexistent --no-create-home redmine
Korrigiert die Berechtigung für die Konfigurationsdatei:
touch /var/www/redmine/config/database.yml chmod 640 /var/www/redmine/config/database.yml chgrp redmine /var/www/redmine/config/database.yml
Als nächstes legt eine configuration.yml an und füllt sie mit den nachstehenden Inhalten:
touch /var/www/redmine/config/configuration.yml chmod 640 /var/www/redmine/config/configuration.yml chgrp redmine /var/www/redmine/config/configuration.yml cat << EOF > /var/www/redmine/config/database.yml
production: adapter: mysql2 database: redmine # XXX: Unix sockets are faster than loopback connections #host: 127.0.0.1 socket: /var/run/mysqld/mysqld.sock username: redmine password: "$REDMINE_PASSWORD" encoding: utf8 EOF
Solltet ihr an dieser Stelle Berechtigungsprobleme erhalten, versucht es nochmal mit sudo -i.
Als nächstes bereitet ihr die Datenbank vor inklusive Beispieldaten:
# Re-run Bundler to automatically install the right DB adapter now that database.yml is populated cd /var/www/redmine sudo bundle install --without development test postgresql sqlite rmagick # Generate a secret token and protect it sudo rake generate_secret_token sudo chmod 0640 config/initializers/secret_token.rb sudo chgrp redmine config/initializers/secret_token.rb sudo RAILS_ENV=production rake db:migrate sudo RAILS_ENV=production REDMINE_LANG=en rake redmine:load_default_data # Encrypt SCM and LDAP passwords sudo RAILS_ENV=production rake db:encrypt
Bereite ein paar Verzeichnisse vor:
cd /var/www/redmine
mkdir -p tmp tmp/pdf public/plugin_assets
sudo chown -R redmine: files log tmp public/plugin_assets
sudo chmod -R 0755 public/plugin_assets
sudo chmod -R 0750 files log tmp # can contain sensitive data
sudo find files log tmp public/plugin_assets -type f -exec chmod -x {} +
Konfiguriere die LOG-Rotation, damit die Log-Dateien nicht das Dateisystem vollschreiben:
sudo -i
cat << EOF > /etc/logrotate.d/redmine
/var/www/redmine/log/*.log {
daily
missingok
rotate 7
compress
notifempty
copytruncate
}
EOF
exit
Apache Konfiguration
Ich werde als Aufruf-URL ein https://host/pm konfigurieren. Dafür ergänze ich in der configuration.yml folgende Zeilen:
# Configuration of the autologin cookie. # autologin_cookie_name: the name of the cookie (default: autologin) # autologin_cookie_path: the cookie path (default: /) # autologin_cookie_secure: true sets the cookie secure flag (default: false) autologin_cookie_name: autologin_cookie_path: "/pm" autologin_cookie_secure: true
Anschließend lege ich einen symbolischen Link an:
ln -s public pm
Optional könnt ihr ungenutzte Module entfernen:
a2dismod access_compat alias authz_groupfile autoindex cgid deflate dir env filter negotiation status > /dev/null
Konfiguriert die SSL-Konfiguration des Apache
cat << EOF > /etc/apache2/sites-available/pm.svc.sdeziel.info-ssl.conf <VirtualHost _default_:443> ServerName EUER_SERVERNAME ServerAdmin webmaster@EUREDOMAIN.DE ErrorLog /var/log/apache2/redmine-error.log CustomLog /var/log/apache2/redmine.log combined SSLEngine On SSLCertificateFile /etc/ssl/certs/ssl-cert-snakeoil.pem SSLCertificateKeyFile /etc/ssl/private/ssl-cert-snakeoil.key # Passenger user PassengerUser redmine # XXX: If NOT using a sub-URI #DocumentRoot /var/www/redmine/public # XXX: If using a sub-URI (/pm) DocumentRoot /var/www/redmine/pm RailsBaseURI /pm PassengerAppRoot /var/www/redmine </VirtualHost> EOF
Den nachfolgenden Schritt in der Anleitung kann ich nicht nachvollziehen, habe ihn aber dennoch durchgeführt:
„Tweak Passenger performance:“
cat << EOF > /etc/apache2/conf-available/zz-passenger-performance.conf # Passenger tuning PassengerMaxPoolSize 2 PassengerMinInstances 1 # XXX: Pick one of those PassengerPreStart #PassengerPreStart https://pm.svc.sdeziel.info/ #PassengerPreStart https://pm.svc.sdeziel.info/pm PassengerMaxRequests 5000 PassengerUploadBufferDir /tmp/ # Breaks compatibility with mod_autoindex and mod_rewrite PassengerHighPerformance on # Do not reveal too much about the server ServerTokens Prod ServerSignature Off
Es empfiehlt sich, nur HTTPS-Verbindungen zuzulassen:
sudo a2dissite default 000-default default-ssl sudo a2ensite EUER_SERVERNAME.info-ssl sudo a2enmod ssl passenger sudo a2enconf zz-passenger-performance sudo apache2ctl -S && service apache2 restart
