DeRedmineUpgrade » History » Revision 5
« Previous |
Revision 5/18
(diff)
| Next »
Robert Schneider, 2015-06-20 13:15
Übersetzung der Rev. 75
- Table of contents
- Upgrading
Upgrading¶
Die folgende Dokumentation behandelt das Aktualisieren von Redmine auf Version 2.x oder höher. Eine frühere Version dieser Seite auf Englisch enthält das Upgrading auf Redmine 1.x.
Schritt 1 - Anforderungen überprüfen¶
Der erste Schritt für das Upgrade ist, zu überprüfen, ob die Anforderungen der Version, die installiert werden soll, erfüllt werden.
Schritt 2 - Sicherung¶
Es wird empfohlen, die Datenbank und die hochgeladenen Dateien zu sichern. Die meisten Upgrades laufen ohne Probleme ab, doch kann es nie schaden, eine Sicherung für den Fall der Fälle zu besitzen.
Sichern der Dateien¶
Alle hochgeladenen Dateien (Anhänge) sind im Verzeichnis files
gespeichert. Zum Sichern kann das Verzeichnis einfach an eine andere Stelle kopiert werden.
MySQL-Datenbanken¶
Die mysqldump
-Anweisung kann zum Sichern der Datenbank in eine Textdatei verwendet werden.
/usr/bin/mysqldump -u <username> -p<password> <redmine_database> | gzip > /path/to/backup/db/redmine_`date +%y_%m_%d`.gz
SQListe-Datenbanken¶
SQLite-Datenbanken sind in Dateien gespeichert, weswegen sie einfach durch das Kopieren an eine andere Stelle gesichert werden können.
PostgreSQL-Datenbanken¶
Die pg_dump
-Anweisung kann zum Sichern der Datenbank in eine Textdatei verwendet werden.
Beispiel:
/usr/bin/pg_dump -U <username> -Fc --file=redmine.sqlc <redmine_database>
Schritt 3 - Das Upgrade durchführen¶
Nun ist es Zeit, die eigentliche Aktualisierung vorzunehmen. Dieser Vorgang fällt, je nachdem, wie Redmine herungergeladen wurde, unterschiedlich aus. Nur eine der beiden folgenden Optionen ist nun durchzuführen.
Option 1 - Eine stabile Version herunterladen¶
Dieser Schritt besteht aus folgenden Teilschritten:
1. Herunterladen des Releases, entweder als tar.gz- oder als zip-Format, mit anschließendem Entpacken des Archivs in ein neues Verzeichnis.
Damit der Anwendungsserver, der mit gewissen Benutzer- und Gruppenrechten läuft, auf die Dateien überhaupt zugreifen kann, muss sichergestellt werden, dass die frisch entpackten und kopierten Dateien entsprechende Benutzer- und Gruppenrechte aufweisen. Insbesondere ist darauf zu achten, dass bei den Verzeichnissen files
, log
und tmp
Schreibrechte vorhanden sind.
2. Kopieren der bestehenden Datei config/database.yml
(die Datenbankeinstellungen enthällt) in das neue config
-Verzeichnis. Falls Redmine >= 1.4 mit MySQL und Ruby 1.9 verwendet wird, so muss der Datenbankadapter in der Datei auf mysql2
gesetzt sein.
3a. Kopieren der bestehenden Datei config/configuration.yml
(die generelle Einstellungen enthällt) in das neue config
-Verzeichnis.
3b. Oder: falls von einer Version vor 1.2.0 aktualisiert wird, die Email-Einstellungen aus der Datei config/email.yml
in die neue Datei config/configuration.yml
kopieren, welche duch das Duplizieren und Umbenennen der Datei config/configuration.yml.example
erstellt werden kann.
4. Kopieren des Verzeichnisinhalts aus files
in das gleichnamige Verzeichnis in der neuen Installation (das Verzeichnis enthält alle hochgeladenen Dateien).
5. Kopieren der Verzeichnisse der eigenen (selbst installierten) Plugins aus dem plugins
Verzeichnis (oder aus vendor/plugins
, falls von einer Version vor 1.x aktualisiert wird) in das Verzeichnis plugins
der neuen Installation. Hierbei sollte darauf geachtet werden, dass nur solche Plugins zu berücksichtigen sind, die nicht Teil von Redmine selbst waren.
6. Installieren der benötigten Gems:
bundle install --without development test
Falls auf dem System ImageMagick nicht vorhanden ist, so sollte die Installation des Gems rmagick ausgelassen werden:
bundle install --without development test rmagick
Es werden dabei lediglich die für die Adapter benötigten Gems installiert, die in der Konfigurationsdatei für die Datenbankverbindung angegeben sind (z.B. wenn in config/database.yml
der _mysql2_Adapter in Verwendung ist, so wird nur das Gem mysql2 installiert). Falls config/database.yml
so verändert wird, dass ein anderer Datenbankadapter verwendet werden soll, so ist 'bundle install' jedes Mal erneut aufzurufen!
Weitere zu installierende Gems, die nicht direkt von Redmine benötigt werden, können in einer eigenen Datei namens Gemfile.local im Root-Verzeichnis angegeben werden. Sie ist ggf. erst anzulegen. Sie wird dann automatisch beim Ausführen von 'bundle install' geladen und installiert die dort angegebenen Gems.
7. Ausführen der folgenden Anweisungen im Root-Verzeichnis der neuen Redmine-Installation:
Falls von einer Redmine-Version vor 2.x aktualisiert wird, zunächst diese Datei löschen, sofern sie existiert: config/initializers/secret_token.rb
Dann mit folgender Anweisung ein neues 'Secret' erzeugen:
bundle exec rake generate_secret_token
Alternativ kann dieses 'Secret' auch in config/secrets.yml gespeichert werden. Informationen dazu unter http://guides.rubyonrails.org/upgrading_ruby_on_rails.html#config-secrets-yml
8. Falls Themes bisher verwendet wurde, so können diese aus public/themes
in das bleichnamige Verzeichnis des neues Installationsverzeichnis kopiert werden. Es ist aber sinnvoll, vorher zu überprüfen, ob eine neue Version des Themes verfügbar ist.
BESONDERS WICHTIG: config/settings.yml
sollte NICHT mit der alten Datei überschrieben werden.
Option 2 - Upgrade über ein SVN-Checkout¶
1. Im Root-Verzeichnis der bestehenden Redmine-Installation diese Anweisung ausführen:
svn update
2. Installieren der benötigten Gems mit folgender Anweisung:
bundle udpate
Schritt 4 - Die Datenbank aktualisieren¶
Schritt 5 - Aufräumen¶
Häufige Probleme¶
Fehler beim Archivmanagement¶
secret_token.rb neu erstellen¶
Weitere Hilfen¶
Updated by Robert Schneider about 9 years ago · 5 revisions