##language:de
##master-page:HelpOnUpdating
##master-date:2004-01-31 20:02:37
HilfeInhalt > HilfeZurAdministration > HilfeZumUpdaten

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

== 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 Verzeichnisbume, die Sie sichern sollten:

    * Der, der die ausfhrbaren MoinMoin-Dateien enthlt (z.B. {{{/usr/lib/python*.*/site-packages/MoinMoin}}})
    * und der, der die Daten enthlt (z.B. {{{/usr/share/moin/wikiname/data}}} - siehe data_dir in Ihrer moin_config.py). 

Die Pfade hngen 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 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 Icons. 
 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 Ihre eigenen Eintrge haben, knnen 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 Eintrge in der Datei im shared-, private Eintrge in der Datei im data-Verzeichnis).


=== Problembehandlung ===

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
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 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.

[[FootNote]]

[[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.


'''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

[[Anchor(update-1-2)]]
=== Version 1.2 ===
/!\ 1.2 ist ''noch'' nicht released. 

'''Version 1.2 bentigt Python 2.2.2 oder hher''', wir empfehlen, Python >=2.3.2 zu benutzen (mit 2.3.x luft MoinMoin ungefhr 20-30% schneller).

 * die URL fr den RecentChanges RSS feed hat sich gendert. Es funktioniert nur noch mit `?action=rss_rc`.

 * Zeichnungen verwenden nun ein neues Applet, das PNGs statt GIFs verwendet und auch image maps erzeugen kann, um Bereich einer Zeichnung zu aktivieren. Beim Anzeigen wird auch ein GIF gesucht, wenn kein PNG gefunden wird. Wir empfehlen, alle GIFs in indizierte PNGs umzuwandeln, weil dies mglicherweise in spteren Versionen entfllt.
 Beispielcode fr bash & !ImageMagick (nur wenn Sie wissen, was Sie tun):
 {{{
for draw in `find /path/to/wiki/data -name \*.draw`; do
    file=`dirname $draw`/`basename $draw .draw`
    if [ -e "${file}.gif" ]; then
        echo "Converting ${file}.gif to ${file}.png"
        convert "${file}.gif" "${file}.png"
    fi
done
}}}

 * `caching_formats` (default: {{{['text_html',]}}}) - Das Zwischenspeichern fr die angegebenen Ausgabeformate aktivieren; standardmig aktiviert. Entwickler wollen dies mglicherweise abschalten und eine leere Liste verwenden.

 * Themes und HTML/CSS-Aufrumarbeiten
  * Browser mit kaputter CSS-Untersttzung (wie z.B. Netscape 4.x) werden nicht lnger untersttzt. Wenn Sie diese Browser immer noch unterstzten mssen, machen Sie keinen Upgrade auf moin 1.2. Wenn Sie immer noch diese Browser benutzen, empfehlen wir, dass Sie zuerst ihren Browser upgraden (Mozilla >= 1.5 hat gute und standardkonforme HTML- und CSS-Untersttzung und ist als Freie Software fr Windows, Linux und Mac verfgbar).
  * Wenn Sie HTML im Code oder per Config gendert haben, sollten Sie die Funktion berprfen. Fr das bliche, schauen Sie in `MoinMoin/theme/classic.py` und `classic/css/screen.css`. Um die Standardwerte der Konfiguration fr die HTML-Fragmente zu sehen, lesen Sie  `MoinMoin/config.py`. Wenn Sie ein Theme modifizieren wollen, ndern Sie nicht einfach das classic Theme, sondern kopieren Sie es oder leiten Sie eine Unterklasse davon ab - unter einem neuen Theme-Namen.
  * durch die neue Theme-Untersttzung hat sich das Layout des `htdocs`-Verzeichnisses gendert:
   * statt Icons unter `img/` und CSS unter `css/` zu verwenden, gibt es nun ein zustzliches Verzeichnis `themename/` dazwischen, z.B. `classic/img/` und `classic/css/`. Wenn Sie eigene Icons hinzugefgt haben, mssen Sie diese ggf. in die Theme-Verzeichnisse kopieren.
   * Der Dateiname der CSS-Datei hat sich auf den Medientyp gendert, das normale, was fr die Bildschirmausgabe benutzt wird, hat sich also von `moinmoin.css` zu `screen.css` gendert. Es gab auch einige nderungen und Verbesserungen in den CSS-Dateien, also benutzen Sie besser die neuen.
  * config.css_url wurde entfernt

 * Plugins - wir benutzen einen neuen Plugin-Lader, der eine korrekte `__init__.py`-Datei im Plugin-Verzeichnis erfordert. Siehe das Verzeichnis `wiki/data/plugin/` im Distributions-Archiv - kopieren Sie es einfach ber das Plugin-Verzeichnis Ihres Wikis.

 * Vergessen Sie nicht, auf das neue Twikidrawplugin upzudaten, das bei moin 1.2 beiliegt.

 * Entfernte config-Variablen:
  * external_diff (nicht mehr bentigt, wir haben jetzt ein internes Diff)
  * shared_metadb (war noch nie implementiert - wir werden es wieder hinzufgen, wenn es implementiert ist)
  * title1/2 (bitte page_header1/2 benutzen)
  * page_icons_up

 * Genderte config-Variablen:
  * changed_time_fmt (HTML und Klammern entfernt vom Standardwert)
  * html_head (Standardwert ist nun der leere String)
  * page_footer1/2 (Standardwert ist nun der leere String)
  * page_icons (ist jetzt eine Liste von Icon-Namen, nicht mehr HTML)
  * umask (Standardwert ist nun 0770, nicht mehr fr jedermann les- und schreibbar == sicherer)

 * Neue config-Variablen (siehe MoinMaster:HelpOnConfiguration):
  * cookie_lifetime
  * mail_login
  * page_credits
  * page_dict_regex
  * page_group_regex
  * page_header1/2
  * page_iconbar 
  * page_icons_table
  * page_license_enabled
  * page_license_page
  * theme_default
  * theme_force
  * tz_offset 

