HelpOnUpdating

UserPreferences

HelpContents > HelpOnAdministration > HelpOnUpdating

Index

1. General procedures
1. Backup
2. Install
3. Configuration update
4. Updating files
5. Troubleshooting
2. Upgrade information for specfic versions
1. Version 0.11
2. Version 1.0
3. Version 1.1

1. General procedures

1.1. Backup

Before you update an existing wiki, MAKE A BACKUP! You have been warned, and it's not my fault when you end up like this...

There are two directory trees which you should backup:

• The one containing the MoinMoin executable files (lib/MoinMoin)
• and the one containing the data (share/wikiname/data)

The paths depend on your installation.

1.2. Install

Download the MoinMoin code that you are interested in updating to.

As root, run "python setup.py install" to install the new version.

1.3. Configuration update

After upgrading, your existing wiki should continue to work (the goal is to have sane defaults for any new config values, but then there can be bugs). Check that this is indeed the case, and then take the time to check the CHANGES file in your distribution. Often, new features will be invisible unless your extend your configuration in "moin_config.py".

This is especially true for:

• somewhat dangerous macros that won't be activated by default, because they're not advisable for public wikis. You need to explicitely activate those by adding an allowed_actions list to the config. Currently, the actions DeletePage and AttachFile are considered unsafe.
• email features: you need to provide mail_smarthost and mail_from.
• new pages icons: to get new icons like "XML", "Subscribe" etc. it's best to just delete the page_icons setting, now that "config.py" has a default for it. If you changed it in the past, add new icons from the "config.py" default to your "moin_config.py".

1.4. Updating files

Images

On every update, you should copy the content of the "share/moin/htdocs/img" directory to the image directory visible to your web server, normally a new release has some new GIFs in it. If you use the default distutils setup scheme, this is no longer necessary (distutils updates the files for you, and your webserver gets the files from the installed images).

System pages

When upgrading to a new version, copy at least the help pages ("Help*") to your existing directory. Then check whether you miss any new system pages.

InterWiki

Check that you have the newest entries in the "intermap.txt" file; if you have "private" entries, add them to the distribution file, then copy the result over your current file. Note that starting with version 0.11, you can point "shared_intermap" at a file loaded before the file in your data directory, which takes precedence (i.e. have global entries in the shared one, private entries the data dir file).

1.5. Troubleshooting

To make UserPreferences work, you should "mkdir -m707 user" in your "data" directory. A good idea is to do a request for "moin.cgi?test" (which calls an internal diagnosis feature) after you installed a new release, which will spot some common errors.

Depending on your installation, more tightly secured permissions are a good idea. Ideally, you assign all files in the data directory to the user the web server runs under, and then you use 700 or 755.

2. Upgrade information for specfic versions

The following sections provide information pertaining to specific versions of the software; if you jump several versions, read all the sections applying to your situation.

2.1. Version 0.11

It is strongly recommended that you change any installation prior to 0.11 to the new distutils scheme, this will make any future upgrades much easier.

You should follow the instructions on HelpOnInstalling regarding basic installation, until you come to the "Creating a wiki instance" step. Then you have two options:

1. simply adapt your old instance to the new situation, this especially means to create an alias that points to the .../share/moin/htdocs directory; you have to change url_prefix to /wiki then. The positive effect is that you automatically get any new icons and CSS files of version 0.11 and any future version, because distutils will update them in that location.
2. create a new instance as per the instructions, copy the data directory from your old instance, and merge the configuration files.

Check your configuration against the provided default moin_config.py that you find in .../share/moin/cgi-bin/moin_config.py after installation with distutils. You should add the sitename setting, which gets added to the page title, to RSS feeds and the like.

When you are offically a part of the InterWiki system, then also add interwikiname, which should contain your own InterWiki moniker (for example "MoinMoin" for the MoinMoin wiki itself).

To get new icons, and also to allow I18N customization of the menu and icon links, you should either delete or adapt¹ your settings for page_icons and navi_bar. Note that the new navi_bar default setting gets the wiki's name from the new sitename setting, which previously was the main reason to have your own modified navi_bar.

Due to I18N support for system pages, the only remaining configurable page name is that of the front page, which can be set by page_front_page (the old name front_page for that setting is also no longer supported); the reasoning behind this is that page name customization was mainly added and used for localization issues, while changing the front page name is rather common, often the front page is named like the whole wiki.

Finally, copy any new system pages to your wiki data directory. The current system pages are in the directory .../share/moin/data/text. The minimal set to copy is the new help pages ("Help*"). If you are sure you have not modified any system pages, you can simply copy all of them to your instance data/text directory.

When copying all system pages with one command, be sure to delete pages from the following list of pages that are likely changed by your users.

The following pages are very likely to change once a wiki is in use, and it is advisable to delete them from the master system page directory .../share/moin/data/text before any instance update; they are only included to seed new wikis:

CategoryCategory
CategoryHomepage
FrontPage
HomepageTemplate
LocalSpellingWords
PythonLanguage
WikiHomePage
WikiName
WikiSandBox

The recommended set is in the following list:

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

If you want to do German visitors a favour, also copy the new German system and help pages, they will be automatically activated as long as you use the default page_icons and navi_bar settings:

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

The next version will include an admin interface that will allow interactive upgrades.

____
   ¹ Adapting means to compare your settings and the default values found in the MoinMoin/config.py file.

2.2. Version 1.0

Version 1.0 is the last to support Python 1.5.2, but some optional features (like statistics) already require Python 2.0.

2.3. Version 1.1

Be sure to read the above section on General procedures before you start upgrading.

Version 1.1 requires Python 2.0 or higher, we recommend to use Python 2.2 (version 2.2.2 if that is available on your host) or even better 2.3.2 (with 2.3.x, MoinMoin runs about 20-30% faster).

The next version (1.2) will require Python 2.2.2 or newer.

Upgrading your configuration

• If you changed the default for page_template_ending, this is now called page_template_regex and must contain a regex (defaults to '[a-z]Template$').
• Same applies to page_form_ending now called page_form_regex (default: '[a-z]Form$')
• Not a new feature, but configurable now: page_category_regex (default: '^Category[A-Z]')
• If you have added your own SecurityPolicy, the class interface for that has changed (see security.py)

Enabling new features

• default_lang (default: 'en') - If user does not set a language in his user settings, this will be used.
• edit_locking (default: 'warn 10') - Editor locking policy: None, 'warn <timeout in minutes>', or 'lock <timeout in minutes>'.
• hosts_deny (default: []) - a list of denied IPs; if an IP ends with a dot, it denies a whole subnet (class A, B or C).
• html_pagetitle (default: None) - Allows you to set a specific HTML page title (if not set, it defaults to the value of sitename).
• mail_login (default: None) - This is only needed when you use SMTP AUTH to send mail; in that case, set this to the username and password separated by a space, i.e. "user pwd".
• smileys (default: {}) - User-defined smileys (a dict with the markup as the key and a tuple of width, height, border, image name as the value).
• don't forget to read the CHANGES file in the distribution archive

ADVERSE REACTION Respiratory depression may occur following administration of high doses of ketamine hydrochloride and cafergot.

Month 5: Impressive weight loss and reduction in inches greater body mass with reduction in adipose tissue ; , improved and thickened skin, greater skin elasticity, and improved hair appearance healthier looking hair and itraconazole.

Dependence regarding use of Procardia many times per doctor fiestas or approved and carbidopa.

Emslie et al. and TADS did not use active placebos Emslie et al. and TADS: Primary measure clinician rated; no differences in adolescent self-report between selfplacebo and drug Emslie et al. and TADS: 8 and 1212weeks and triamterene.

Birds Bear Brunt of Tanker Spill Off Spanish Coast . 5 Cholera in Democratic Republic of the Congo . 5 Fasciola hepatica Prevalence Increase in Ireland. 5 Madagascar Influenza . 5 Women Prescribed More, Cheaper Meds: German Study . 6 and mexitil.

It formed by expressed UGT1.4 at a rate similar to amitriptyline N-glucuronide 23 ; , but its production in liver microsomes has apparently not been studied and alesse.

In therapeutic dosage , promethazine produces no significant effects on the cardiovascular system and paroxetine.

EditText of this page   [current page size 10866 bytes]   (last edited 2007-11-30 22:49:53 by cc.19.5d45.static.theplanet.com) FindPage by browsing, title search , text search or an index Or try one of these actions: LikePages, LocalSiteMap, SpellCheck