Amnesty International Amnesty-Intern.de

Impressum | Login

Amnesty-Intern.de

StartseiteWiki-Installation-Aktualisierung

In den nachfolgenden Abschnitten erläutern wir die Aktualisierung eines vorhandenen Wiki-Paketes auf eine Version 1.5.2 oder höher. Die Vorgehensweise bei einer Neuinstallation (es ist noch kein wiki installiert) ist auf der Seite Wiki-Installation beschrieben.

Falls Ihr Fragen habt oder Hilfe in Anspruch nehmen möchtet, wendet Euch gerne an uns per Mail an fk-internet@amnesty.de .

Allgemeines

Je nach Ausgangssituation unterscheiden sich die Vorgehensweisen bei der Aktualisierung etwas, wie aus den im folgenden dargestellten Abläufen ersichtlich ist. Es werden daher verschiedene Varianten beschrieben, zunächst als Auflistung einzelner Schritte, danach ausführlich.

Die Abläufe können natürlich auch anders gestaltet werden (z.B. könnte das wiki-Paket wie es ist auf den webspace hochgeladen und sämtliche Änderungen dort durchgeführt werden, je nach zur Verfügung stehenden Mitteln und Kenntnissen). Der Einfachheit halber wird hier jeweils nur eine Variante vorgestellt. Noch eine Vorgehensweise ist in http://www.pmwiki.org/wiki/PmWikiDe/Upgrades beschrieben.

Alle Änderungen, die ihr selbst vornehmt (es soll ja Bastler geben), sollten sich auf den Ordner "gruppe" beschränken, damit die Basis-Software pmwiki ohne größere Probleme ausgetauscht werden kann.

Voraussetzungen

Ein paar Grundkenntnisse setzen wir voraus (z.B. wie eine Datei aus einem zip-Archiv entpackt wird, sollte schon bekannt sein. Sowas wird hier nicht erklärt). Vor der Installation sollte gesichert, danach getestet und ggf. der vorherige Zustand aus der Sicherung wiederhergestellt werden.

Umfang der Unterstützung

Wenn im folgenden von Unterstützung durch die FK Internet die Rede ist, dann gilt das vor allem dann, wenn der webspace bei der Sektion beantragt wurde. Wenn ihr selbst den webspace bei Stratos, 1&1, der Telekom, AOL, Vodafone, Domainfactory unter eigenem Namen, wo auch immer habt, können wir euch bestenfalls ein paar Fragen beantworten bzw. beim Umzug auf eine Amnesty-eigene Domain/webspace helfen.


Aktualisierung

Als Beispiel-Domain wird www.amnesty-orscholz.de verwendet. Ihr müsst an diesen Stellen eure eigene Domain (bzw. Ordnernamen) einsetzen.

Wie finde ich die Version der aktuellen Installation heraus?

Nach der Anmeldung erscheint auf eurer Homepage in der linken Seitenleiste der Bereich "Intern" mit dem Unterpunkt "Konfiguration".

  • aber der Version 1.5.3 wird die Version des wiki-Pakets direkt angezeigt
  • in den Versionen 1.4.1 bis 1.5.2 gibt es den Link "Analyse-Seite auf pmwiki.de" http://www.pmwiki.org/wiki/PmWiki/SiteAnalyzer. Den ruft ihr auf, gebt dort die Adresse eurer Homepage und "aedmr" ein, und bekommt dann die Versionen der verschiedenen Software-Pakete angezeigt. Anhand der Version des Pakets pmwiki könnt ihr auf der Seite Wiki-Versionen nachsehen, um welche Amnesty-wiki-Version es sich handelt. Z.B. pmwiki-2.2.29 ist die Amnesty-wiki-Version 1.4.1
  • in den Versionen vor 1.4.1 gibt es den Link "Software-Versionen überprüfen". Dort wird ebenfalls die Version des Pakets pmwiki angezeigt, mir der ihr auf der Seite Wiki-Versionen nachsehen könnt, um welche Amnesty-wiki-Version es sich handelt.

Die genaue Version ist übrigens nicht so wichtig, es geht vor allem um die Unterscheidung - vor 1.4.1 - von 1.4.1 bis 1.5.2 - ab 1.5.3.

Aktualisierung von Version 1.5.0, 1.5.1 oder 1.5.2 nach Version 1.5.3

Situation: Das vorhandene wiki ist bereits aus der aktuellen Hauptversion 1.5 und soll ohne große Umstände auf den allerneuesten Stand gebracht werden.

Hinweis 1: Die FK Internet unterstützt euch auch bei einer Aktualisierung. Je weniger in der vorhandenen Installation manipuliert wurde, umso lieber.

Hinweis 2: Die Aktualisierung geht davon aus, dass die Installation nach der Installationsanleitung durchgeführt und insbesondere der Ordner pmwiki in Ruhe gelassen wurde (abgesehen vielleicht von der farmconfig.php, aber darauf wird noch eingegangen). Sonst sollte sie mit den umfassenderen Abläufen durchgeführt werden, die weiter unten beschrieben sind.

Ablauf

  1. Sicherung der aktuellen Installation (also der alten Version)
  2. Herunterladen des aktuellen wiki-Pakets
  3. Entpacken der config-Dateien und des Ordners pmwiki
  4. Ändern der config-Dateien
  5. Meldet euch auf dem Webspace an
  6. Hochladen der config-Dateien und des Ordners pmwiki auf den webspace, die dort vorhandene Datei und den Ordner ersetzen
  7. Übernahme geänderter Seiten
  8. Sicherung der neuen Installation

Ausführliche Beschreibung

Sicherung der vorhandenen Installation

Packt den Ordner amnesty-orscholz.de z.B. in ein zip-Archiv oder eine andere Form der Sicherungsdatei, der ihr einen Namen gebt, der eine Wiedererkennung wahrscheinlich macht und auch das Sicherungsdatum und die wiki-Version enthalten sollte.

Beispiel (Version 1.5.1): Sicherung-amnesty-orscholz-v151-2015-04-01-a.zip.
Wenn ihr mehrere Sicherungen an einem Tag in derselben Version macht, z.B. bei sehr umfangreichen Arbeiten, kann je Sicherung der Buchstabe am Ende (vor .zip) in alphabetischer Reihenfolge vergeben werden.

Diese Datei verbringt ihr an einen sicheren Ort (z.B. auf euren heimischen Rechner, einen USB-Stick, eine CD/DVD, ...).

Während der Installation kann die Sicherung zunächst (zusätzlich zum sicheren Ort) auf dem Webspace verbleiben, dann ist sie im Bedarfsfall schnell im Zugriff. Später sollte sie auf dem webspace wieder gelöscht werden.

Herunterladen des aktuellen wiki-Pakets

Ladet das aktuelle Wiki-Paket amnesty-wiki-1.5.3.zip in einen Ordner auf eurem Rechner herunter.

Entpacken der config-Dateien und des Ordners pmwiki

Aus dem heruntergeladenen zip-Archiv entpackt ihr die Datei config.php aus dem Ordner gruppe/local und den Ordner pmwiki.
Falls ihr eigene wiki-Gruppen (siehe FAQ) eingerichtet habt, entpackt auch die Datei farmconfig.php aus dem Ordner pmwiki/local (aber nicht die ebenfalls dort befindliche config.php!).

Ändern der config-Dateien

Ändern der config.php

  1. Weist der Variablen $AiSite eure Domain zu. Dabei darf kein "http://" oder "https://" vorangestellt werden! Ansonsten entspricht der Wert demjenigen, der vorher (in der alten Version) der Variablen $ScriptUrl zugewiesen wurde. Die Variable $ScriptUrl darf in der neuen Version nicht verändert werden!
  2. Die Zeilen für die Passwörter übernehmt ihr aus der alten config.php
  3. Die gruppenspezifische Information ($AiGroupName usw.) übernehmt ihr ebenfalls aus der alten config.php
  4. Schließlich übernehmt ihr noch den Abschnitt "Zusätzliche Recipes" ganz am Ende. Dort steht aber nur was, wenn ihr selber zusätzliche Rezepte installiert oder Parameter für vorhandene Rezepte (z.B. mini) geändert habt

Siehe dazu auch Ändern der config.php bei der Neuinstallation.

Ändern der farmconfig.php

Im Ordner pmwiki/local befindet sich die Datei farmconfig.php. Diese enthält eine Zeile, in der die Variable $GroupPattern für die wiki-Gruppen (siehe FAQ) gesetzt wird.
Wenn ihr eigene Wikigruppen eingerichtet habt, dann müsst ihr diese in der Variable $GroupPattern in der farmconfig.php der neuen Version ergänzen.

Achtung: Im Ordner pmwiki/local gibt es auch eine config.php. Die hat mit derjenigen aus dem vorigen Abschnitt nichts zu tun und ist von euch nicht zu verändern!

Hochladen des Ordners pmwiki und der geänderten config.php

Ladet

  • den Ordner pmwiki in den Ordner amnesty-orscholz.de
  • die geänderte config.php in den Ordner amnesty-orscholz.de/gruppe/local
  • ggf. die geänderte farmconfig.php in den Ordner amnesty-orscholz.de/pmwiki/local

auf dem Webspace hoch.

Wenn ihr den Dateimanager im Administrationsmenü verwendet, müsst ihr zu nächst die vorhandene config.php (und ggf. farmconfig.php) und den vorhandenen Ordner pmwiki umbenennen, verschieben oder löschen. Der (hochzuladende) Ordner pmwiki muss in ein zip-Archiv gepackt werden, da der Dateimanager nur Dateien, aber keine Ordner hochladen kann. Nach dem Hochladen muss das Archiv dann wieder entpackt und der Ordner an die richtige Stelle (da wo vorher der alte war) verschoben werden.

Ein ftp-Programm kann normalerweise vorhandene Ordner und Dateien ersetzen, da geht es weniger umständlich.

In Version 1.5.3 geänderte Seiten

Da die Inhalte aus der vorhandenen Installation bestehen bleiben, fehlen ein paar Änderungen, die in der Version 1.5.3 durchgeführt wurden, und die ihr daher ggf. übertragen müsst. Ansehen könnt ihr euch das im Testwiki

Es handelt sich um folgende Seiten:

  • Main/Spenden:
    • Das Amnesty Journal gibt es nur noch sechs Mal im Jahr
    • Bankverbindung ergänzt für herkömmliche Formen des Zahlungsverkehrs
  • Site/SideBar:
    • Informieren-International: Der rss-feed muss ersetzt werden durch
  >>rssfeed<<
  (:pmfeed feed='https://www.amnesty.org/en/rss?contentType=2561&resourceType=newsarticle&sort=date' showitemdescr='true' max_count=5   title='Aktuell aus dem Internationalem Sekretariat- ':)
  >><<
  • in der SideBar selbst ist vor "Intern" der Link auf das Internationale Sekretariat eingefügt:
  * [[http://www.amnesty.org|Internationales Sekretariat www.amnesty.org]]

Sicherung der neuen Installation

Packt den Ordner amnesty-orscholz.de z.B. in ein zip-Archiv oder eine andere Form der Sicherungsdatei, der ihr einen Namen gebt, der eine Wiedererkennung wahrscheinlich macht und auch das Sicherungsdatum und die wiki-Version enthalten sollte.

Beispiel: Sicherung-amnesty-orscholz-v153-2015-04-01-a.zip.

Diese Datei verbringt ihr an einen sicheren Ort (z.B. auf euren heimischen Rechner, einen USB-Stick, eine CD/DVD, ...).


Aktualisierung von Versionen größer 1.1, kleiner 1.5 nach Version 1.5.3 in der vorhandenen Installation

Situation: Ein wiki ab Version 1.1 ist bereits installiert und soll auf die neueste Version gebracht werden. Es wird in Kauf genommen, dass die Seite kurzzeitig nicht erreichbar ist.

Hinweis: Die FK Internet unterstützt euch auch bei einer Aktualisierung. Je weniger in der vorhandenen Installation manipuliert wurde, umso lieber.

Ablauf

Der hier beschriebene Ablauf ist sehr umfangreich mit vielen einzelnen kleinen Schritten. Die Aktualisierung wird auf dem lokalen Rechner durchgeführt und anschließend das neue Gruppen-/Bezirkswiki komplett hochgeladen. Wer sich auskennt, kann natürlich einiges abkürzen und/oder größere Teile auf dem Webspace direkt durchführen.

Nochmal der Hinweis: www.amnesty-orscholz.de ist die Beispiel-Domain, amnesty-orscholz.de der Beispiel-Ordner. Ihr setzt dafür euren eigenen Domainnamen (Ordnernamen) ein.

  1. Sicherung der aktuellen Installation (also der alten Version)
  2. Herunterladen des aktuellen wiki-Pakets
  3. Entpacken des Installationspakets
  4. Herunterladen eurer aktuellen Installation
  5. Entpacken eurer heruntergeladenen aktuellen Installation
  6. Ändern der config-Dateien
  7. Aktualisierung von Rezepten
  8. Überprüfen und Übernehmen weiterer Änderungen
  9. Übernehmen der Seiten und hochgeladenen Dateien aus der alten Version
  10. Meldet euch auf dem Webspace an
  11. Umbenennen des Ordners auf dem Webspace
  12. Hochladen des wiki-Pakets auf den webspace
  13. Entpacken des wiki-Pakets auf dem webspace
  14. Übernahme geänderter Seiten
  15. Sicherung der neuen Installation

Ausführliche Beschreibung

Die ausführliche Beschreibung befindet sich auf der Seite Aktualisierung von 1.1 nach 1.5.3


Aktualisierung auf Version 1.5.0 - 1.5.2

Das macht an sich keinen Sinn. Geht auf die aktuelle Version 1.5.3., das ist kein großer Aufwand (siehe oben).

Falls ihr trotzdem unbedingt eine Version 1.5 vor 1.5.3 haben oder behalten wollt, der Ablauf ist derselbe wie bei Version 1.5.3, nur die Datei config.php unterscheidet sich. Siehe dazu Wiki-Installation-AendereConfig152


Aktualisierung über vorübergehende Installation in einer Subdomain

Situation: Ein wiki ab Version 1.1 ist bereits installiert und soll auf die neueste Version gebracht werden. Die neue Version wird zunächst parallel zur Hauptinstallation in einer Subdomain installiert.

Hinweis: Die FK Internet unterstützt euch auch bei einer Aktualisierung. Je weniger in der vorhandenen Installation manipuliert wurde, umso lieber.

  1. Anlegen der Subdomain wiki153
  2. Herunterladen des aktuellen wiki-Pakets
  3. Entpacken der config-Dateien und des Ordners pmwiki
  4. Herunterladen und Entpacken der momentanen Installation
  5. Ändern der config-Dateien
  6. Aktualisierung von Rezepten
  7. Überprüfen und Übernehmen weiterer Änderungen
  8. Übernehmen der Seiten und hochgeladenen Dateien aus der alten Version
  9. Meldet euch auf dem Webspace an
  10. Hochladen des wiki-Pakets auf den webspace
  11. Entpacken des wiki-Pakets auf dem webspace
  12. Testen der Seiten auf der Subdomain
  13. Übernahme geänderter Seiten
  14. Sicherung der neuen Installation
  15. Subdomain zur Hauptdomain machen
  16. Ordner der alten Installation und Subdomain löschen

Ausführliche Beschreibung

Die ausführliche Beschreibung befindet sich auf der Seite Aktualisierung nach 1.5.3 in Subdomain


Aktualisierung aus Version 1.0

Situation: Ein wiki in Version 1.0 ist bereits installiert und soll auf die neueste Version gebracht werden.

Hinweis: Die FK Internet unterstützt euch auch bei einer Aktualisierung.

Es gibt einige wesentliche Unterschiede zwischen der Version 1.0 und neueren Versionen

  • Es gibt einen neuen "Hauptordner", der so heißt wie die Domain (also z.B. "amnesty-orscholz.de") mit den Unterordnern "gruppe" und "pmwiki". Außerdem enthält dieser Ordner die Dateien ".htaccess" und "README.md"
  • Die Installationsdateien aus dem bisherigen Verzeichnis /pmwiki wurden auf die erwähnten Unterordner "gruppe" und "pmwiki" verteilt. Änderungen (der Gruppen) sollen möglichst nur noch im Ordner "gruppe" stattfinden, damit der Ordner pmwiki ohne große Arbeit aktualisiert werden kann (z.B. für neue Versionen von pmwiki)
  • Der Inhalt der Datei pmwiki/local/config.php wurde auf gruppe/local/config.php und pmwiki/local/farmconfig.php aufgeteilt. Auch hier sollten Änderungen nur in gruppe/local/config.php vorgenommen werden (lediglich neue wikigruppen müssen in die farmconfig.php eingetragen werden).
  • Blogeinträge benötigen nun außer dem Anker "hauptteil", auch einen Anker "kopfteil" über ">>eintrag<<", andernfalls wird die Blogvorschau nicht richtig angezeigt.

Ablauf

  1. Installiert das wiki neu in einer Subdomain (siehe oben)
  2. Führt die Änderungen an der config.php durch (noch ohne Übernahme eventueller Ergänzungen aus der bisherigen Installation - das ist unter "Aktualisierung Rezepte" beschrieben)
  3. Kopiert den Inhalt des Ordners uploads aus eurer bisherigen Installation in den Ordner gruppe/uploads in der neuen Installation auf der Subdomain (das sind die hochgeladenen Dateien: Bilder, Dokumente usw.)
  4. Löscht die Dateien im Ordner gruppe/wiki.d in der neuen Installation auf der Subdomain. Aus dem Ordner wiki.d eurer bisherigen Installation kopiert ihr alle Dateien außer Site.Konfiguration (diese NICHT übernehmen, es gibt diese Datei ab der Version 1.5.3 nicht mehr) in den Ordner gruppe/wiki.d.
  5. Aktualisiert Rezepte, die ihr selber hinzugefügt habt
  6. Überprüfen und Übernehmen weiterer Änderungen
  7. Übernahme geänderter Seiten
  8. Testen der Seiten auf der Subdomain
  9. Sicherung der neuen Installation
  10. Subdomain zur Hauptdomain machen
  11. Ordner der alten Installation und Subdomain löschen

Seite zuletzt geändert am 09.08.2016 22:17 Uhr UTC

Wiki