Redmine im Webspace: Unterschied zwischen den Versionen
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 | # 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]] | 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": | ||
<syntaxhighlight lang="shell"> | |||
ssh xyz00-redmine@xyz00.hostsharing.net | |||
</syntaxhighlight> | |||
Auf dem Hostsharing-Server: | Auf dem Hostsharing-Server: | ||
<syntaxhighlight lang="shell"> | |||
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 | |||
</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: | ||
<syntaxhighlight lang="yaml" line> | |||
production: | |||
adapter: postgresql | |||
database: xyz00_prjdb | |||
host: localhost | |||
username: xyz00_dbuser | |||
password: "meinPasswort" | |||
</syntaxhighlight> | |||
configuration.yml: | configuration.yml: | ||
<syntaxhighlight lang="yaml" line> | |||
default: | |||
email_delivery: | |||
delivery_method: :smtp | |||
smtp_settings: | |||
address: "127.0.0.1" | |||
attachments_storage_path: "/home/pacs/xyz00/users/redmine/data" | 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: | |||
</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: | ||
<syntaxhighlight lang="shell"> | |||
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 | |||
</syntaxhighlight> | |||
Weiter in der Shell: | Weiter in der Shell: | ||
<syntaxhighlight lang="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 | |||
</syntaxhighlight> | |||
Wenn alles gut gegangen ist, ist die Redmine-Installation unter | Wenn alles gut gegangen ist, ist die Redmine-Installation unter | ||
https://prj. | 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:
- 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
- Die Domain muss aktualisiert werden: Domainoption passenger einschalten, fastcgi ausschalten
- Einen Postgresql-User xyz00_dbuser mit Passwort meinPasswort
- 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
- Redmine Projekt
- Installationsanleitung
- Theme Farend Bleuclair
- Redmine Dashboard Plugin oder Kanban Board Plugin
- Wysiwyg Editor Plugin
- Dokumentenverwaltung (DMS) mit WebDAV-Server und Volltextsuche
- Eingehende E-Mails verarbeiten