DeRedmineUpgrade » History » Version 15

C S, 2021-01-26 14:33
Aktualisierung auf originale Rev. 82

1 15 C S
Übersetzung der "Rev. 82":http://www.redmine.org/projects/redmine/wiki/RedmineUpgrade/82
2 1 Robert Schneider
3 1 Robert Schneider
{{>TOC}}
4 1 Robert Schneider
5 1 Robert Schneider
h1. Upgrading
6 1 Robert Schneider
7 15 C S
Die folgende Dokumentation behandelt das Aktualisieren von Redmine auf Version 2.x oder höher. Eine "frühere Version dieser Seite auf Englisch":/projects/redmine/wiki/RedmineUpgrade?version=53 enthält das Upgrading auf Redmine 1.x.
8 1 Robert Schneider
9 1 Robert Schneider
h2. Schritt 1 - Anforderungen überprüfen
10 1 Robert Schneider
11 15 C S
Der erste Schritt für das Upgrade ist, zu überprüfen, ob die [[DeRedmineInstall#Anforderungen|Anforderungen]] der Version, die installiert werden soll, erfüllt werden.
12 1 Robert Schneider
13 1 Robert Schneider
h2. Schritt 2 - Sicherung
14 1 Robert Schneider
15 1 Robert Schneider
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.
16 15 C S
Weitere Informationen hierzu finden Sie unter [[DeRedmineBackupRestore|Sichern und Wiederherstellen von Redmine]]
17 1 Robert Schneider
18 1 Robert Schneider
h2. Schritt 3 - Das Upgrade durchführen
19 1 Robert Schneider
20 15 C S
Nun ist es Zeit, die eigentliche Aktualisierung vorzunehmen. Dieser Vorgang fällt, je nachdem, wie Redmine bezogen wurde, unterschiedlich aus. Nur *eine* der beiden folgenden Optionen ist nun durchzuführen.
21 1 Robert Schneider
22 1 Robert Schneider
h3. Option 1 - Eine stabile Version herunterladen
23 1 Robert Schneider
24 15 C S
*1.* [[Download|Herunterladen]] des Releases, entweder als tar.gz- oder als zip-Format, mit anschließendem Entpacken des Archivs in ein neues Verzeichnis. Entpacken des Archivs in ein neues Verzeichnis.
25 1 Robert Schneider
26 15 C S
*2.* Kopieren der bestehenden Datei @config/database.yml@ (die Datenbankeinstellungen enthält) 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. 
27 2 Robert Schneider
28 15 C S
Stellen Sie sicher, dass für die neu extrahierten und kopierten Dateien und Verzeichnisse der richtige Eigentümer und die richtige Gruppe festgelegt sind, damit der Benutzer / die Gruppe, auf der Ihr Anwendungsserver ausgeführt wird, tatsächlich auf die Dateien zugreifen kann. Insbesondere ist darauf zu achten, dass bei den Verzeichnissen @files@, @log@ und @tmp@ Schreibrechte vorhanden sind.
29 2 Robert Schneider
30 15 C S
*3a.* Kopieren der bestehenden Datei @config/configuration.yml@ (die generelle Einstellungen enthält) in das neue @config@-Verzeichnis. 
31 4 Robert Schneider
32 15 C S
*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. Diese kann auch durch das Duplizieren und Umbenennen der Datei @config/configuration.yml.example@ erstellt werden.
33 4 Robert Schneider
34 15 C S
*4.* Kopieren des Verzeichnisinhaltes aus @files@ in das gleichnamige Verzeichnis in der neuen Installation (das Verzeichnis enthält alle hochgeladenen Dateien).
35 1 Robert Schneider
36 15 C S
*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. Stellen Sie sicher, dass Sie nur Plugins kopieren, die ursprünglich nicht mit Ihrem vorherigen Redmine-Setup gebündelt wurden.
37 1 Robert Schneider
38 4 Robert Schneider
*6.* Installieren der benötigten Gems:
39 1 Robert Schneider
40 4 Robert Schneider
  bundle install --without development test
41 4 Robert Schneider
42 15 C S
Falls auf dem System ImageMagick nicht vorhanden ist, so sollte die Installation des Gems @rmagick@ ausgelassen werden:
43 4 Robert Schneider
44 4 Robert Schneider
  bundle install --without development test rmagick
45 4 Robert Schneider
46 4 Robert Schneider
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!
47 4 Robert Schneider
48 15 C S
Weitere zu installierende Gems, die nicht direkt von Redmine benötigt werden, können diese in einer eigenen Datei mit dem Namen @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.
49 4 Robert Schneider
50 4 Robert Schneider
*7.* Ausführen der folgenden Anweisungen im Root-Verzeichnis der neuen Redmine-Installation:
51 1 Robert Schneider
 
52 4 Robert Schneider
Falls von einer Redmine-Version vor 2.x aktualisiert wird, zunächst diese Datei löschen, sofern sie existiert: @config/initializers/secret_token.rb@
53 4 Robert Schneider
54 4 Robert Schneider
Dann mit folgender Anweisung ein neues 'Secret' erzeugen:
55 1 Robert Schneider
56 4 Robert Schneider
  bundle exec rake generate_secret_token
57 4 Robert Schneider
58 4 Robert Schneider
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
59 4 Robert Schneider
60 4 Robert Schneider
*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.
61 1 Robert Schneider
62 4 Robert Schneider
BESONDERS WICHTIG: @config/settings.yml@ sollte NICHT mit der alten Datei überschrieben werden.
63 4 Robert Schneider
64 4 Robert Schneider
h3. Option 2 - Upgrade über ein SVN-Checkout
65 4 Robert Schneider
66 1 Robert Schneider
*1.* Im Root-Verzeichnis der bestehenden Redmine-Installation diese Anweisung ausführen:
67 1 Robert Schneider
68 1 Robert Schneider
<pre><code>svn update</code></pre>
69 5 Robert Schneider
70 5 Robert Schneider
*2.* Installieren der benötigten Gems mit folgender Anweisung:
71 1 Robert Schneider
72 5 Robert Schneider
<pre><code>bundle udpate</code></pre>
73 5 Robert Schneider
74 5 Robert Schneider
h2. Schritt 4 - Die Datenbank aktualisieren
75 5 Robert Schneider
76 5 Robert Schneider
Dieser Schritt ist jener, der die Datenbank verändern könnte. Dafür ist im Redmine-Verzeichnis folgende Migrationsanweisung ausführen:
77 1 Robert Schneider
78 6 Robert Schneider
<pre><code>bundle exec rake db:migrate RAILS_ENV=production</code></pre>
79 6 Robert Schneider
80 6 Robert Schneider
Falls Plugins installiert sind, so sollten auch ihre Datenbankmigrationsanweisungen durchgeführt werden:
81 6 Robert Schneider
82 6 Robert Schneider
<pre><code>bundle exec rake redmine:plugins:migrate RAILS_ENV=production</code></pre>
83 6 Robert Schneider
84 6 Robert Schneider
h2. Schritt 5 - Aufräumen
85 1 Robert Schneider
86 1 Robert Schneider
*1.* Leeren des Caches und Löschen bestehender Sessions:
87 7 Robert Schneider
88 15 C S
<code><pre>bundle exec rake tmp:cache:clear RAILS_ENV=production</pre></code>
89 7 Robert Schneider
90 7 Robert Schneider
*2.* Neustarten des Anwendungsservers (z.B. puma, thin, passenger).
91 7 Robert Schneider
92 15 C S
*3.* Abschließend im Browser auf _"Administrationn -> Rollen und Berechtigungen"_ gehen, um dort die Berechtigungen möglicher neuer Features einzustellen.
93 7 Robert Schneider
94 1 Robert Schneider
h2. Häufige Probleme
95 1 Robert Schneider
96 9 Robert Schneider
h3. Fehler beim Management von Subversion-Projektarchiven
97 8 Robert Schneider
98 15 C S
Der Datei reposman.rb wurden mehrere neue Funktionen hinzugefügt. Stellen Sie sicher, dass Sie eine Gruppe angegeben haben, wenn Sie Probleme haben  ( --group=groupnamehere). Stellen Sie außerdem sicher, dass Sie die Anweisungen *[[Repositories_access_control_with_apache_mod_dav_svn_and_mod_perl|hier]]* erneut befolgen, wenn Sie nur Ihre Redmine.pm nur kopiert haben. Des Weiteren aktualisieren Sie ggf. Ihre Apache-Konfiguration, wenn sich die empfohlene Konfiguration geändert hat.
99 1 Robert Schneider
100 1 Robert Schneider
h3. secret_token.rb neu erstellen
101 1 Robert Schneider
102 11 Robert Schneider
Vor der Version version:2.0.0 war es nötig eine Datei @session_store.rb@ im Verzeichnis @config@ anzulegen, um Cookie-basierte Sessions zu ermöglichen.
103 11 Robert Schneider
104 11 Robert Schneider
Seit Version version:2.0.0 wird diese Datei nicht mehr benötigt und sollte daher erst gar nicht existieren. Stattdessen wird mit folgender Anweisung die Datei @secret_token.rb@ generiert.
105 11 Robert Schneider
106 11 Robert Schneider
  bundle exec rake generate_secret_token
107 11 Robert Schneider
108 15 C S
_Hinweis: Der Code im Projektarchiv von Redmine selbst enthält die Datei @config/initializers/secret_token.rb@ nicht. Sie wird durch die obige rake-Anweisung erst erzeugt._
109 11 Robert Schneider
110 1 Robert Schneider
h3. Weitere Hilfen
111 12 Robert Schneider
112 14 Robert Schneider
Beim Aktualisieren von Redmine können auch diese Quellen weiterhelfen:
113 12 Robert Schneider
114 12 Robert Schneider
* Fehler beim Browsen in der Wiki-Historie nach einem Upgrade von Redmine-Version 1.x mit einer SQLite-Datenbank: #12501.
115 12 Robert Schneider
* "mod_fcgid for Apache2":http://httpd.apache.org/mod_fcgid/, um Rails mit Apache 2 zum Laufen zu bringen
116 1 Robert Schneider
* HowTo: [[HowTo_configure_Apache_to_run_Redmine|Apache für Redmine konfigurieren]]
117 13 Robert Schneider
* "Bemerkungen zu Problemen und deren Lösung beim Upgrade von Version 0.8.6 auf 0.9.3":http://web.archive.org/web/20111214022108/http://www.cybersprocket.com/2010/project-management/upgrading-redmine-from-8-6-to-9-3/ --cybersprocket (14.08.2010)
118 13 Robert Schneider
* "Bemerkungen zur Vorgehensweise beim Upgrade von Version 0.9.6 auf 1.0(RC)":http://web.archive.org/web/20120610010521/http://www.cybersprocket.com/2010/tips-tricks/upgrading-redmine-from-0-9-6-to-1-0-0/ --cybersprocket (14.08.2010)