##language:de
##master-page:HelpOnUpdating
##master-date:2003-11-18 21:08:10
HilfeInhalt > HilfeZurAdministration > HilfeZumUpdaten

'''Index'''
[[TableOfContents]]

== Allgemeine Verfahrensweise ==

/!\ '''Bevor Sie ein existierendes Wiki updaten, ERSTELLEN SIE EINE SICHERUNG!''' Sie wurden gewarnt - es ist nicht mein Fehler, wenn Sie so enden: @) 

=== Konfigurations-Update ===

Nach dem Upgrade sollte Ihr existierendes Wiki weiterhin funktionsfhig sein (das Ziel ist, vernnftige Default-Werte fr neue Konfigurations-Variablen zu haben, aber Fehler kann es immer mal geben). Prfen 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:
 * in gewisser Weise gefhrliche Macros, die nicht standardmig aktiviert sind, weil sie fr ffentliche Wikis nicht ratsam sind. Sie mssen diese explizit aktivieren, indem Sie eine {{{allowed_actions}}}-Liste zu der Konfiguration hinzufgen. Derzeit werden die Aktionen {{{DeletePage}}} und {{{AttachFile}}} als unsicher betrachtet.

 * email-Funktionen: Sie mssen {{{mail_smarthost}}} und {{{mail_from}}} angeben.

 * Neue Seiten-Icons: um die Icons wie "XML", "Subscribe" etc. zu bekommen, lschen Sie am besten die {{{page_icons}}}-Einstellung, da es nun einen Default in "config.py" dafr gibt. Wenn Sie es in der Vergangenheit gendert haben, fgen Sie neue Icons aus dem "config.py"-Default zu Ihrer "moin_config.py" hinzu.

=== 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 GIFs. 
 Wenn Sie das standardmige ''distutils''-Setupverfahren benutzen, ist das nicht mehr notwendig (distutils frischt die Dateien fr 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 berprfen Sie bitte, ob irgendwelche neuen System-Seiten fehlen.

 InterWiki:: berprfen Sie, ob Sie die neuesten Eintrge in der Datei "intermap.txt" haben. Wenn Sie "private" Eintrge haben, fgen Sie diese der neuen Datei aus der Distribution hinzu und kopieren Sie das Resultat dann ber ihre seitherige Datei. Beachten Sie, dass seit Version 0.11, Sie auch mit "shared_intermap" auf eine Datei verweisen knen, die ''vor'' der Datei aus Ihrem ''data''-Verzeichnis (welche Vorrang hat) geladen wird (das heisst, globale Eintrge in der shared_intermap, private Eintrge in der Datei im ''data''-Verzeichnis).

=== Problembehandlung ===

Um BenutzerEinstellungen funktionsfhig zu bekommen, sollten Sie "mkdir -m707 user" in Ihrem "data"-Verzeichnis ausfhren. Es ist eine gute Idee, nach Installation einer neuen Release im Browser "moin.cgi?test" aufzurufen. Durch die Angabe von "?test" wird ein Diagnosewerkzeug aufgerufen, welches helfen kann, einige bliche Fehler finden.

Abhngig 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 abluft und dann benutzen Sie `700` oder `755` als Zugriffsrechte.


== Upgrade-Informationen fr 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.

[[Anchor(update-0-11)]]
=== Version 0.11 ===

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

Sie sollten der Anleitung auf HilfeZurInstallation folgen bezglich der Grundinstallation, bis Sie zu dem Punkt "Erzeugen einer Wiki-Instanz"-Schritt kommen. Dann haben Sie zwei Mglichkeiten:
 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 mssen `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 zuknftigen Version bekommen, weil ''distutils'' sie an dieser Stelle updatet.
 1. erzeugen Sie eine neue Instanz der Anleitung folgend, kopieren Sie das ''data''-Verzeichnis von Ihrer alten Instanz und vereinigen Sie die Konfigurations-Dateien.

Prfen Sie Ihre Konfiguration im Vergleich zu der mitgelieferten standardmigen `moin_config.py`, die Sie in `.../share/moin/cgi-bin/moin_config.py` nach der Installation mit distutils finden. Sie sollten die `sitename`-Einstellung hinzufgen, die zu Seitentiteln, zu ''RSS feeds'' und hnlichem hinzugefgt wird.

Wenn Sie offizieller Teil des InterWiki-Verbunds sind, fgen Sie auch `interwikiname` hinzu, was Ihren eigenen InterWiki-Kurznamen enthalten sollte (z.B. "`MoinMoin`" fr 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 fr `page_icons` und `navi_bar` entweder lschen oder anpassen[[FootNote(Anpassen bedeutet, Ihre Einstellungen und die Standardeinstellungen in MoinMoin/config.py zu vergleichen.)]]. Beachten Sie, dass die neue `navi_bar`-Standardeinstellung den Wikinamen aus der neuen `sitename`-Einstellung bezieht, was frher der Hauptgrund war, eine eigene, modifizierte `navi_bar` zu haben.

Aufgrund der I18N-Untersttzung fr System-Seiten ist der einzige briggebliebene Seitenname der der ''front page'', die ber `page_front_page`  (der alte Name `front_page` fr diese Einstellung wird nicht mehr untersttzt) eingestellt werden kann; der Logik dahinter ist die, dass Seitennamen-Anpassung hauptschlich fr Lokalisierung hinzugefgt wurde, whrend 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 mssen sind die neuen (englischen) Hilfeseiten ("`Help*`"). Wenn Sie sicher sind, dass Sie keinerlei Systemseiten gendert haben, knnen 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 gendert wurden, aus der folgenden Liste auslassen/lschen.'''

Die folgenden Seiten werden sehr wahrscheinlich gendert, sobald ein Wiki in Benutzung ist und es ist ratsam, sie aus dem Haupt-Systemseiten-Verzeichnis `.../share/moin/data/text` zu lschen vor jeglichen Update einer Instanz; Sie sind nur beigelegt, um damit neue Wikis zu bestcken: {{{
CategoryCategory
CategoryHomepage
FrontPage
HomepageTemplate
LocalSpellingWords
PythonLanguage
WikiHomePage
WikiName
WikiSandBox
}}}

Die empfohlene Menge ist die folgende Liste: {{{
Help*
AbandonedPages
EventStats
EventStats_2fHitCounts
EventStats_2fUserAgents
FindPage
InterWiki
MoinMoin
OrphanedPages
PageSize
Python4Suite
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 standardmigen `page_icons`- und `navi_bar`-Einstellungen verwenden: {{{
Hilfe*
Aktuellenderungen (Aktuelle_c4nderungen)
AufgegebeneSeiten
BenutzerEinstellungen
GesuchteSeiten
SeiteFinden
SeitenGre (SeitenGr_f6_dfe)
StartSeite
TitelIndex
VerwaisteSeiten
WegWeiser
WortIndex
ZufallsSeite
}}}

Die nchste Version wird eine Admin-Schnittstelle beinhalten, die interaktive Upgrades erlauben wird.

[[Anchor(update-1-0)]]
=== Version 1.0 ===

Version 1.0 ist die letzte, die Python 1.5.2 untersttzt - allerdings bentigen einige optionale Eigenschaften (wie Statistiken) bereits Python 2.0.


[[Anchor(update-1-1)]]
=== Version 1.1 ===

Lesen Sie auf jeden Fall den obigen Abschnitt ''Allgemeine Vorgehensweise'' bevor Sie los legen.

'''Version 1.1 bentigt Python 2.0 oder hher''', wir empfehlen, Python 2.2 zu benutzen (Version 2.2.2, falls diese auf Ihrem Rechner verfgbar ist) oder noch besser 2.3.2 (mit 2.3.x luft MoinMoin ungefhr 20-30% schneller).

Die nchste Version (1.2) wird Python 2.2.2 oder neuer bentigen.


HelpContents > HelpOnAdministration


'''Aktualisieren Ihrer Konfiguration'''

 * Falls Sie den Standardwert von `page_template_ending` gendert haben: dies heit jetzt `page_template_regex` und muss einen regulren Ausdruck enthalten (Standardwert ist '[a-z]Template$').
 * Das gleiche gilt fr `page_form_ending`, das nun `page_form_regex` heit (Standardwert: '[a-z]Form$')
 * Keine neue Eigenschaft, aber jetzt konfigurierbar: `page_category_regex` (Standardwert: '^Category[A-Z]')
 * Wenn Sie Ihre eigene `SecurityPolicy` konfiguriert haben: das Klassen-Interface hat sich gendert (siehe `security.py`)

'''Aktivierung neuer Features'''

 * `default_lang` (Standardwert: 'en') - dies wird benutzt, wenn der Benutzer keine Sprache in seinen BenutzerEinstellungen einstellt
 * `edit_locking` (Standardwert: `'warn 10'`) - Sperrverfahren des Editors: None, 'warn <Timeout in Minuten>', oder 'lock <Timeout in Minuten>'.
 * `hosts_deny` (Standardwert: `[]`) - eine Liste abgewiesener IPs; wenn eine IP mit einem Punkt endet, wird ein ganzes Subnet abgewiesen (class A, B or C).
 * `html_pagetitle` (Standardwert: `None`) -  ermglicht es, einen bestimmten HTML-Seitentitel zu setzen (wenn nicht gesetzt, wird als Standard der Wert von sitename benutzt).
 * `mail_login` (Standardwert: `None`) - Dies wird nur bentigt wenn Sie SMTP AUTH benutzen, um Mails zu senden; in diesem Fall, setzen Sie den Usernamen und das Passwort - durch ein Leerzeichen getrennt, auf z.B. "user pwd".
 * `smileys` (Standardwert: `{}`) -  Benutzerdefinierte Smileys (ein dict mit dem Markup als Schlssel und einem Tupel aus Breite, Hhe, Rand, Bildname als Wert).
 * vergessen Sie nicht, die Datei CHANGES im Distributionsarchiv zu lesen

[[FootNote]]
