Redmine im Webspace: Unterschied zwischen den Versionen

Aus Hostsharing Wiki
Zur Navigation springen Zur Suche springen
KKeine Bearbeitungszusammenfassung
 
(7 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 23: Zeile 23:
Unter Debian Bookworm kann das systemseitig installierte Ruby benutzt werden.
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
Sonst: siehe Seite [[RubyRBEnv]]


== Download, Entpacken, Konfiguration ==
== Download, Entpacken, Konfiguration ==
Zeile 29: 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.1.1.tar.gz
chmod 700 data
    tar xzf redmine-5.1.1.tar.gz  
wget http://www.redmine.org/releases/redmine-5.1.2.tar.gz
    cd ~/redmine-5.1.1/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 44: 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: "127.0.0.1"
    smtp_settings:
          port: 4025
      address: "127.0.0.1"
          enable_starttls_auto: false
      port: 4025
      attachments_storage_path: "/home/pacs/xyz00/users/redmine/data"
      enable_starttls_auto: false
      autologin_cookie_name:
  attachments_storage_path: "/home/pacs/xyz00/users/redmine/data"
      autologin_cookie_path:
  autologin_cookie_name:
      autologin_cookie_secure:
  autologin_cookie_path:
      scm_subversion_command:
  autologin_cookie_secure:
      scm_mercurial_command:
  scm_subversion_command:
      scm_git_command:
  scm_mercurial_command:
      scm_cvs_command:
  scm_git_command:
      scm_bazaar_command:
  scm_cvs_command:
      scm_darcs_command:
  scm_bazaar_command:
      scm_subversion_path_regexp:
  scm_darcs_command:
      scm_mercurial_path_regexp:
  scm_subversion_path_regexp:
      scm_git_path_regexp:
  scm_mercurial_path_regexp:
      scm_cvs_path_regexp:
  scm_git_path_regexp:
      scm_bazaar_path_regexp:
  scm_cvs_path_regexp:
      scm_darcs_path_regexp:
  scm_bazaar_path_regexp:
      scm_filesystem_path_regexp:
  scm_darcs_path_regexp:
      scm_stderr_log_file:
  scm_filesystem_path_regexp:
      database_cipher_key:
  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!
Zeile 88: Zeile 96:
Weiterhin als "xyz00-redmine" auf dem Hostsharing-Server:
Weiterhin als "xyz00-redmine" auf dem Hostsharing-Server:


    cd ~/redmine-5.1.1
<syntaxhighlight lang="shell">
    bundle config set --local path 'vendor/bundle'
cd ~/redmine-5.1.2
    bundle config set --local without 'development:test'
bundle config --local path 'vendor/bundle'
    bundle install
bundle config --local without 'development:test'
    bundle exec rake generate_secret_token
bundle install
    RAILS_ENV=production bundle exec rake db:migrate
bundle exec rake generate_secret_token
    RAILS_ENV=production bundle exec rake redmine:load_default_data
RAILS_ENV=production bundle exec rake db:migrate
RAILS_ENV=production bundle exec rake redmine:load_default_data
</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-5.0.4 app-ssl
rm -rf htdocs-ssl/ app-ssl/ subs/www/ subs-ssl/www/
    ln -s $HOME/redmine-5.0.4/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.example.com erreichbar. Beim ersten Login als User "admin" mit Passwort "admin" wird ein neues Passwort konfiguriert.
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 ==
== weitere Schritte ==
Zeile 116: Zeile 132:


Weiterhin ist es möglich, das Anlegen von Tickets für eingehende E-Mail-Nachrichten zu konfigurieren.
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 ==
== Links ==
Zeile 122: Zeile 158:
* [https://www.redmine.org/projects/redmine/wiki/RedmineInstall Installationsanleitung]
* [https://www.redmine.org/projects/redmine/wiki/RedmineInstall Installationsanleitung]
* [https://github.com/farend/redmine_theme_farend_bleuclair Theme Farend Bleuclair]
* [https://github.com/farend/redmine_theme_farend_bleuclair Theme Farend Bleuclair]
* [https://github.com/happy-se-life/kanban Kanban Board Plugin]
* [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/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]
* [https://www.redmine.org/projects/redmine/wiki/RedmineReceivingEmails Eingehende E-Mails verarbeiten]


Zeile 133: 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