Redmine im Webspace

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen

Redmine ist eine umfangreiche Projektmanagement-Software. Die Software ist multiprojektfähig und legt für jedes Projekt mehrere Werkzeuge an:

  • Wiki
  • Vorgangsverfolgung (Ticketsystem, Issue Tracker)
  • Zeiterfassung
  • Dokument- und Dateiverwaltung
  • Foren
  • Kalender, Gantt-Charts
  • Schnittstelle zur Versionverwaltung (Git, Mercurial und weitere)

Diese Anleitung beschreibt, wie man Redmine auf der Managed Hosting Plattform von Hostsharing installieren kann. Redmine lässt sich in jedem Managed Webspace betreiben.

Vorbereitungen

Mit Hilfe von HSAdmin wird angelegt:

  1. Ein User als Service-User mit /bin/bash als Shell, zum Beispiel Beispiel: xyz00-redmine
  2. Eine Domain mit xyz00-redmine als Domain-Administrator, zum Beispiel prj.example.com
  3. Die Domain muss aktualisiert werden: Domainoption passenger einschalten, fastcgi ausschalten
  4. Einen Postgresql-User xyz00_dbuser mit Passwort meinPasswort
  5. Eine Postgresql-Datenbank xyz00_prjdb mit Datenbank-Owner xyz00_dbuser

Ruby installieren

Unter Debian Bookworm kann das systemseitig installierte Ruby benutzt werden.

Sonst: siehe Seite RubyRBEnv, aktuell wird Ruby 3.1.3 für Redmine 5.0.4 benutzt

Download, Entpacken, Konfiguration

Anmeldung per ssh als User xyz00-redmine":

   ssh xyz00-redmine@xyz00.hostsharing.net

Auf dem Hostsharing-Server:

   cd ~
   mkdir data
   chmod 700 data
   wget http://www.redmine.org/releases/redmine-5.1.1.tar.gz
   tar xzf redmine-5.1.1.tar.gz 
   cd ~/redmine-5.1.1/config

Anlegen der beiden Dateien "database.yml" und "configuration.yml" mit folgendem Inhalt:

database.yml:

   production:
     adapter: postgresql
     database: xyz00_prjdb
     host: localhost
     username: xyz00_dbuser
     password: "meinPasswort"

configuration.yml:

   default:
     email_delivery:
       delivery_method: :smtp
       smtp_settings:
         address: "127.0.0.1"
         port: 4025
         enable_starttls_auto: false
     attachments_storage_path: "/home/pacs/xyz00/users/redmine/data"
     autologin_cookie_name:
     autologin_cookie_path:
     autologin_cookie_secure:
     scm_subversion_command:
     scm_mercurial_command:
     scm_git_command:
     scm_cvs_command:
     scm_bazaar_command:
     scm_darcs_command:
     scm_subversion_path_regexp:
     scm_mercurial_path_regexp:
     scm_git_path_regexp:
     scm_cvs_path_regexp:
     scm_bazaar_path_regexp:
     scm_darcs_path_regexp:
     scm_filesystem_path_regexp:
     scm_stderr_log_file:
     database_cipher_key:

Achtung: Die Einrückung muss immer genau um zwei Leerzeichen erfolgen!

Der "attachments_storage_path" muss angepasst werden ("xyz00" und "redmine" durch den eigenen Webspace bzw. das eigene User-Postfix ersetzen). Wenn für den Webspace "Storage" gebucht ist, kann der Speicher nach "/home/storage/..." gelegt werden.

Redmine-Installation

Weiterhin als "xyz00-redmine" auf dem Hostsharing-Server:

   cd ~/redmine-5.1.1
   bundle config set --local path 'vendor/bundle'
   bundle config set --local without 'development:test'
   bundle install
   bundle exec rake generate_secret_token
   RAILS_ENV=production bundle exec rake db:migrate
   RAILS_ENV=production bundle exec rake redmine:load_default_data

Weiter in der Shell:

   cd ~/doms/prj.example.com/
   rm -rf htdocs-ssl/ app-ssl/ subs/www/ subs-ssl/www/
   ln -s $HOME/redmine-5.1.1 app-ssl
   ln -s $HOME/redmine-5.1.1/public htdocs-ssl

Wenn alles gut gegangen ist, ist die Redmine-Installation unter https://prj.example.com erreichbar. Beim ersten Login als User "admin" mit Passwort "admin" wird ein neues Passwort konfiguriert.

Nach der Änderung des Admin-Passwort sollten einige Einstellungen im Bereich Administration/Konfiguration durchgesehen werden:

  • im Bereich "Allgemein" der Applikationstitel, der Hostname und das Protokoll
  • im Bereich "Mailbenachrichtigung" der E-Mail-Absender und die E-Mail-Fußzeile

weitere Schritte

Redmine ist ein stabiles Projektmanagement-Werkzeug. Es ist freie Software und weiterhin gepflegt. Die Benutzeroberfläche ist funktional. Sie macht aber einen etwas veralteten Eindruck.

Es gibt einige Themes und Plugins, die diesen Nachteil teilweise kompensieren können:

  • Das Theme "farend bleuclair" sorgt für einen frischeren Ersteindruck
  • Ein Kanban Board ist als Plugin verfügbar
  • ebenso kann ein visueller Editor für das Wiki nachgerüstet werden

Weiterhin ist es möglich, das Anlegen von Tickets für eingehende E-Mail-Nachrichten zu konfigurieren.

eingehende E-Mails

Wenn für eingehende E-Mail-Nachrichten jeweils ein Ticket angelegt werden soll, ist das über die Datei .forward möglich.

 $ cat .forward 
 "| /home/pacs/xyz00/users/redmine/bin/email2ticket"
 
 $ cat bin/email2ticket 
 #!/bin/bash
 export PATH=/usr/local/bin:/usr/bin:/bin
 export RAILS_ENV=production
 cd /home/pacs/xyz00/users/redmine/redmine-5.1.1
 bundle exec rake redmine:email:read project=projekt-kurzname tracker=3 unknown_user=create

Links