Redmine im Webspace: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
KKeine Bearbeitungszusammenfassung
 
(21 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 13: Zeile 13:


Mit Hilfe von HSAdmin wird angelegt:
Mit Hilfe von HSAdmin wird angelegt:
# Ein User als Service-User mit ''/bin/bash'' als Shell, zum Beispiel Beispiel: ''xyz00-redmine"
# Ein User als Service-User mit ''/bin/bash'' als Shell, zum Beispiel Beispiel: ''xyz00-redmine''
# Eine Domain mit ''xyz00-redmine'' als Domain-Administrator, zum Beispiel "prj.example.com"
# Eine Domain mit ''xyz00-redmine'' als Domain-Administrator, zum Beispiel ''prj.example.com''
# Die Domain muss aktualisiert werden: Domainoption ''passenger'' einschalten, ''fastcgi'' ausschalten
# Einen Postgresql-User ''xyz00_dbuser'' mit Passwort ''meinPasswort''
# Einen Postgresql-User ''xyz00_dbuser'' mit Passwort ''meinPasswort''
# Eine Postgresql-Datenbank ''xyz00_prjdb'' mit Datenbank-Owner ''xyz00_dbuser''
# Eine Postgresql-Datenbank ''xyz00_prjdb'' mit Datenbank-Owner ''xyz00_dbuser''
Zeile 20: Zeile 21:
== Ruby installieren ==
== Ruby installieren ==


siehe Seite [[RubyRBEnv]], aktuell wird Ruby 3.1.3 für Redmine 5.0.4 benutzt
Unter Debian Bookworm kann das systemseitig installierte Ruby benutzt werden.
 
Sonst: siehe Seite [[RubyRBEnv]]


== Download, Entpacken, Konfiguration ==
== Download, Entpacken, Konfiguration ==
Zeile 26: Zeile 29:
Anmeldung per ssh als User  ''xyz00-redmine":
Anmeldung per ssh als User  ''xyz00-redmine":


    ssh xyz00-redmine@xyz00.hostsharing.net
<syntaxhighlight lang="shell">
ssh xyz00-redmine@xyz00.hostsharing.net
</syntaxhighlight>


Auf dem Hostsharing-Server:
Auf dem Hostsharing-Server:


    cd ~
<syntaxhighlight lang="shell">
    mkdir data
cd ~
    chmod 700 data
mkdir data
    wget http://www.redmine.org/releases/redmine-5.0.2.tar.gz
chmod 700 data
    tar xzf redmine-5.0.2.tar.gz  
wget http://www.redmine.org/releases/redmine-5.1.2.tar.gz
    cd ~/redmine-5.0.2/config
tar xzf redmine-5.1.2.tar.gz  
cd ~/redmine-5.1.2/config
</syntaxhighlight>


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


    production:
<syntaxhighlight lang="yaml" line>
      adapter: postgresql
production:
      database: xyz00_prjdb
  adapter: postgresql
      host: localhost
  database: xyz00_prjdb
      username: xyz00_dbuser
  host: localhost
      password: "meinPasswort"
  username: xyz00_dbuser
  password: "meinPasswort"
</syntaxhighlight>


configuration.yml:
configuration.yml:


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


Achtung: Die Einrückung muss immer genau um zwei Leerzeichen erfolgen!
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 ==
== Redmine-Installation ==
Zeile 82: Zeile 96:
Weiterhin als "xyz00-redmine" auf dem Hostsharing-Server:
Weiterhin als "xyz00-redmine" auf dem Hostsharing-Server:


    cd ~/redmine-3.4.6
<syntaxhighlight lang="shell">
    bundle install --without development test --path vendor/bundle
cd ~/redmine-5.1.2
    bundle exec rake generate_secret_token
bundle config --local path 'vendor/bundle'
    RAILS_ENV=production bundle exec rake db:migrate
bundle config --local without 'development:test'
    RAILS_ENV=production bundle exec rake redmine:load_default_data
bundle install
    bundle exec ruby bin/rails server -b 127.0.0.1 webrick -e production
bundle exec rake generate_secret_token
 
RAILS_ENV=production bundle exec rake db:migrate
Wer die Paket-IP-Adresse statt 127.0.0.1 angibt kann Redmine über den Port 3000 von extern ansprechen.
RAILS_ENV=production bundle exec rake redmine:load_default_data
Mit Ctrl-C brich man Webrick wieder ab.
</syntaxhighlight>


Weiter in der Shell:
Weiter in der Shell:
   
   
    cd ~/doms/prj.example.com/
<syntaxhighlight lang="shell">
    rm -rf htdocs-ssl/ app-ssl/ subs/www/ subs-ssl/www/
cd ~/doms/prj.example.com/
    ln -s $HOME/redmine-3.4.6 app-ssl
rm -rf htdocs-ssl/ app-ssl/ subs/www/ subs-ssl/www/
    ln -s $HOME/redmine-3.4.6/public htdocs-ssl
ln -s $HOME/redmine-5.1.2 app-ssl
ln -s $HOME/redmine-5.1.2/public htdocs-ssl
</syntaxhighlight>
 
Wenn alles gut gegangen ist, ist die Redmine-Installation unter
Wenn alles gut gegangen ist, ist die Redmine-Installation unter
https://prj.exmaple.com erreichbar.
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.
 
<syntaxhighlight lang="shell">
# cat .forward
 
"| /home/pacs/xyz00/users/redmine/bin/email2ticket"
</syntaxhighlight>
 
<syntaxhighlight lang="shell">
# 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.2
bundle exec rake redmine:email:read project=projekt-kurzname tracker=3 unknown_user=create
</syntaxhighlight>
 
== Links ==
 
* [https://www.redmine.org/ Redmine Projekt]
* [https://www.redmine.org/projects/redmine/wiki/RedmineInstall Installationsanleitung]
* [https://github.com/farend/redmine_theme_farend_bleuclair Theme Farend Bleuclair]
* [https://github.com/jgraichen/redmine_dashboard Redmine Dashboard Plugin] oder [https://github.com/happy-se-life/kanban Kanban Board Plugin]
* [https://github.com/taqueci/redmine_wysiwyg_editor Wysiwyg Editor Plugin]
* [https://github.com/danmunn/redmine_dmsf Dokumentenverwaltung (DMS) mit WebDAV-Server und Volltextsuche]
* [https://www.redmine.org/projects/redmine/wiki/RedmineReceivingEmails Eingehende E-Mails verarbeiten]


----
----
Zeile 109: Zeile 170:
[[Kategorie:Projektverwaltung]]
[[Kategorie:Projektverwaltung]]
[[Kategorie:Projektmanagement]]
[[Kategorie:Projektmanagement]]
[[Kategorie:WebDAV]]

Aktuelle Version vom 3. Juli 2024, 12:34 Uhr

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

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.2.tar.gz
tar xzf redmine-5.1.2.tar.gz 
cd ~/redmine-5.1.2/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.2
bundle config --local path 'vendor/bundle'
bundle config --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.2 app-ssl
ln -s $HOME/redmine-5.1.2/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.2
bundle exec rake redmine:email:read project=projekt-kurzname tracker=3 unknown_user=create

Links