HilfeInhalt > HilfeZurAdministration > HilfeZumUpdaten

Index

Allgemeine Verfahrensweise

Backup

/!\ Bevor Sie ein existierendes Wiki updaten, ERSTELLEN SIE EINE SICHERUNG!

Sie wurden gewarnt. Es ist nicht unsere Schuld, wenn Sie so enden: X-(

Es gibt 2 Verzeichnisbäume, die Sie sichern sollten:

Die Pfade hängen von Ihrer Installation ab.

Installation

Laden Sie den MoinMoin-Code herunter, auf den Sie updaten wollen.

Als root, starten Sie "python setup.py install", um die neue Version zu installieren.

Konfigurations-Update

Nach dem Upgrade sollte Ihr existierendes Wiki weiterhin funktionsfähig sein (das Ziel ist, vernünftige Default-Werte für neue Konfigurations-Variablen zu haben, aber Fehler kann es immer mal geben). Prüfen Sie also, ob dem wirklich so ist und dann nehmen Sie sich die Zeit, die Datei CHANGES in der Distribution zu lesen. Oft sind neue Eigenschaften nicht sichtbar, es sei denn Sie erweitern Ihre Konfigurationsdatei "moin_config.py".

Insbesondere trifft dies zu auf:

Updaten der Dateien

Bilder
Bei jedem Update sollten Sie den Inhalt des Verzeichnisses "share/moin/htdocs/img" in das Ihrem Webserver sichtbare Bildverzeichnis kopieren - normalerweise enthalten neue Releases einige neue Icons.

Wenn Sie das standardmäßige distutils-Setupverfahren benutzen, ist das nicht mehr notwendig (distutils frischt die Dateien für Sie auf und der Webserver bekommt die Dateien der installierten Bilder).

System-Seiten
Wenn Sie auf eine neue Version upgraden, kopieren sie wenigstens die Hilfeseiten ("Help*" und "Hilfe*") in Ihr existierendes Verzeichnis. Danach überprüfen Sie bitte, ob irgendwelche neuen System-Seiten fehlen.
InterWiki

Überprüfen Sie, ob Sie die neuesten Einträge in der Datei "intermap.txt" haben. Wenn Sie Ihre eigenen Einträge haben, können Sie mit "shared_intermap" auf eine Datei verweisen, die vor der Datei im data-Verzeichnis geladen wird, die dann bevorzugt wird (d.h. halten sie globale Einträge in der Datei im shared-, private Einträge in der Datei im data-Verzeichnis).

Problembehandlung

Es ist eine gute Idee, nach Installation einer neuen Release im Browser "moin.cgi?action=test" aufzurufen. Durch die Angabe von "?action=test" wird ein Diagnosewerkzeug aufgerufen, welches helfen kann, einige übliche Fehler finden.

Abhängig von Ihrer Installation sind enger definierte Zugriffsrechte eine gute Idee. Idealerweise weisen Sie allen Dateien im data-Verzeichnis den User zu, unter dem der Webserver-Prozess abläuft und dann benutzen Sie 700 oder 755 als Zugriffsrechte.

Upgrade-Informationen für bestimmte Versionen

Die folgenden Abschnitten enthalten Informationen, die sich auf bestimmte Versionen der Software beziehen. Wenn Sie mehrere Versionen überspringen, lesen Sie alle Abschnitte, die sich auf Ihre Situation beziehen.

Version 0.11

(!) Es wird bestens empfohlen, dass Sie jede Installation vor 0.11 auf die neue distutils-Methode umstellen, was Ihnen zukünftige Upgrades stark vereinfachen wird.

Sie sollten der Anleitung auf HilfeZurInstallation folgen bezüglich der Grundinstallation, bis Sie zu dem Punkt "Erzeugen einer Wiki-Instanz"-Schritt kommen. Dann haben Sie zwei Möglichkeiten:

  1. passen Sie einfach Ihre alte Installation auf die neue Situation an, das bedeutet insbesondere, dass Sie einen Alias erzeugen, der auf das .../share/moin/htdocs-Verzeichnis verweist; Sie müssen url_prefix dann auf /wiki ändern. Der positive Effekt daran ist, dass Sie automatisch jegliche neue Icons und CSS-Dateien der Version 0.11 und jeder zukünftigen Version bekommen, weil distutils sie an dieser Stelle updatet.

  2. erzeugen Sie eine neue Instanz der Anleitung folgend, kopieren Sie das data-Verzeichnis von Ihrer alten Instanz und vereinigen Sie die Konfigurations-Dateien.

Prüfen Sie Ihre Konfiguration im Vergleich zu der mitgelieferten standardmäßigen moin_config.py, die Sie in .../share/moin/cgi-bin/moin_config.py nach der Installation mit distutils finden. Sie sollten die sitename-Einstellung hinzufügen, die zu Seitentiteln, zu RSS feeds und ähnlichem hinzugefügt wird.

Wenn Sie offizieller Teil des InterWiki-Verbunds sind, fügen Sie auch interwikiname hinzu, was Ihren eigenen InterWiki-Kurznamen enthalten sollte (z.B. "MoinMoin" für das MoinMoin-Wiki selbst).

Um neue Icons zu bekommen und auch die I18N-Anpassung der Menu- und Icon-Links zu erlauben, sollten Sie Ihre Einstellungen für page_icons und navi_bar entweder löschen oder anpassen1. Beachten Sie, dass die neue navi_bar-Standardeinstellung den Wikinamen aus der neuen sitename-Einstellung bezieht, was früher der Hauptgrund war, eine eigene, modifizierte navi_bar zu haben.

Aufgrund der I18N-Unterstützung für System-Seiten ist der einzige übriggebliebene Seitenname der der front page, die über page_front_page (der alte Name front_page für diese Einstellung wird nicht mehr unterstützt) eingestellt werden kann; der Logik dahinter ist die, dass Seitennamen-Anpassung hauptsächlich für Lokalisierung hinzugefügt wurde, während das Ändern der front page relativ üblich ist, oft wird die front page genauso benannt, wie das ganze Wiki.

Zuguterletzt kopieren Sie jegliche neue Systemseiten in Ihr Wiki data-Verzeichnis. Die aktuellen System-Seiten sind im Verzeichnis .../share/moin/data/text. Die Mindestmenge, die Sie kopieren müssen sind die neuen (englischen) Hilfeseiten ("Help*"). Wenn Sie sicher sind, dass Sie keinerlei Systemseiten geändert haben, können Sie auch einfach alle in das Verzeichnis data/text Ihrer Wiki-Instanz kopieren.

/!\ Wenn Sie alle Systemseiten mit einem Kommando kopieren, versichern Sie sich, dass Sie Seiten, die wahrscheinlich von Ihren Benutzern geändert wurden, aus der folgenden Liste auslassen/löschen.

Die folgenden Seiten werden sehr wahrscheinlich geändert, sobald ein Wiki in Benutzung ist und es ist ratsam, sie aus dem Haupt-Systemseiten-Verzeichnis .../share/moin/data/text zu löschen vor jeglichen Update einer Instanz; Sie sind nur beigelegt, um damit neue Wikis zu bestücken:

CategoryCategory
CategoryHomepage
FrontPage
HomepageTemplate
LocalSpellingWords
WikiHomePage
WikiName
WikiSandBox

Die empfohlene Menge ist die folgende Liste:

Help*
AbandonedPages
EventStats
EventStats_2fHitCounts
EventStats_2fUserAgents
FindPage
InterWiki
MoinMoin
OrphanedPages
PageSize
RandomPage
RecentChanges
SiteNavigation
StructuredText
SystemInfo
TitleIndex
UserPreferences
WantedPages
WikiWikiWeb
WordIndex
XsltVersion

Wenn Sie deutschen Besuchern einen Gefallen tun wollen, sollten Sie auch die neuen deutschen System- und Hilfe-Seiten kopieren, sie werden automatisch aktiviert, wenn Sie die standardmäßigen page_icons- und navi_bar-Einstellungen verwenden:

Hilfe*
AktuelleÄnderungen (Aktuelle_c4nderungen)
AufgegebeneSeiten
BenutzerEinstellungen
GesuchteSeiten
SeiteFinden
SeitenGröße (SeitenGr_f6_dfe)
StartSeite
TitelIndex
VerwaisteSeiten
WegWeiser
WortIndex
ZufallsSeite

Die nächste Version wird eine Admin-Schnittstelle beinhalten, die interaktive Upgrades erlauben wird.

  • 1 Anpassen bedeutet, Ihre Einstellungen und die Standardeinstellungen in MoinMoin/config.py zu vergleichen.

Version 1.0

Version 1.0 ist die letzte, die Python 1.5.2 unterstützt - allerdings benötigen einige optionale Eigenschaften (wie Statistiken) bereits Python 2.0.

Version 1.1

Aktualisieren Ihrer Konfiguration

Aktivierung neuer Features

Version 1.2

Version 1.2 benötigt Python 2.2.1 oder höher, wir empfehlen, Python >=2.3.2 zu benutzen (mit 2.3.x läuft MoinMoin ungefähr 20-30% schneller) oder >=2.2.2.

Version 1.5 beta