comparison docs/UPDATE.html @ 0:77665d8e2254

tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0 (automatically generated log message) imported from: moin--main--1.5--base-0
author Thomas Waldmann <>
date Thu, 22 Sep 2005 15:09:50 +0000
children cfbecd3400d3
equal deleted inserted replaced
-1:000000000000 0:77665d8e2254
2 <html>
3 <head>
4 <link rel="shortcut icon" href="">
5 <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
6 <meta name="robots" content="noindex,nofollow">
9 <title>HelpOnUpdating - MoinMaster</title>
11 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="wiki/htdocs/modern/css/common.css">
12 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="wiki/htdocs/modern/css/print.css">
13 <link rel="alternate" title="MoinMaster Recent Changes" href=";ddiffs=1&amp;unique=1" type="application/rss+xml">
14 <link rel="Start" href="">
15 <link rel="Alternate" title="Wiki Markup" href="">
16 <link rel="Alternate" media="print" title="Print View" href="">
17 <link rel="Search" href="">
18 <link rel="Index" href="">
19 <link rel="Glossary" href="">
20 <link rel="Help" href="">
21 </head>
23 <body lang="en" dir="ltr">
24 <div id="page" lang="en" dir="ltr">
26 <h1 id="title">HelpOnUpdating</h1>
27 <div lang="en" id="content" dir="ltr">
28 <a id="top"></a>
29 <p><a href="">HelpContents</a> &gt; <a href="">HelpOnAdministration</a> &gt; HelpOnUpdating </p>
30 <p><strong>Index</strong> <ol>
31 <li><a href="#head-e9fc017905cde431b9eb693851523c71c81b9a9e">General procedures</a><ol>
32 <li><a href="#head-6c62d24dd986c08a1a21ae0a6e2c4548f79f989d">Backup</a></li>
33 <li><a href="#head-28a7e259e240e06c446a4e260ad6a96322de263d">Install</a></li>
34 <li><a href="#head-1409f14b1d4801cdc1cfa7a7d31ebe9011a350f1">Configuration update</a></li>
35 <li><a href="#head-93651cf60ec7638f011aa01673f747b168e68c9e">Updating files</a></li>
36 <li><a href="#head-7aa313a5b6991fdd59b559e6d7c26fb14442e8b7">Troubleshooting</a></li>
37 </ol>
38 <li><a href="#head-b3a424f875af1a1f08e21a2a771ecd7459a6d4dc">Upgrade information for specfic versions</a><ol>
39 <li><a href="#head-d45ca8cc7a44289d82ff1d58582c89bb638f3fcd">Version 1.0</a></li>
40 <li><a href="#head-ab06519c303d7468ebd774ccade247864c85511f">Version 1.1</a></li>
41 <li><a href="#head-b67c2d9266310861577c255faf04abda607713c7">Version 1.2</a></li>
42 <li><a href="#head-6b39642936e912c76ea6eec794a0ce182bf5f751">Version 1.2.1, 1.2.2, 1.2.3</a></li>
43 <li><a href="#head-bad7644afcfbab5ecaffd6f8fa739abf11841232">Version 1.3</a></li>
44 <li><a href="#head-64b74b335c0bb5764150db10b4f12dc7b9b1154f">Deprecation Note</a></li>
45 </ol>
46 </li>
47 </ol>
48 </p>
50 <h3 id="head-e9fc017905cde431b9eb693851523c71c81b9a9e">General procedures</h3>
53 <h4 id="head-6c62d24dd986c08a1a21ae0a6e2c4548f79f989d">Backup</h4>
55 <p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> <strong>Before you update an existing wiki, MAKE A BACKUP!</strong> </p>
56 <p>You have been warned, and it's not our fault when you end up like this: <img src="wiki/htdocs/modern/img/angry.png" alt="X-(" height="15" width="15"> </p>
57 <p>There are two directory trees which you should backup: </p>
58 <ul>
59 <li><p> The one containing the <a href="">MoinMoin</a> executable files (e.g. <tt>/usr/lib/python*.*/site-packages/MoinMoin</tt>) </p>
60 </li>
61 <li><p> and the one containing the data (e.g. <tt>/usr/share/moin/wikiname/data</tt> - see data_dir in your </p>
62 </li>
63 </ul>
64 <p>The pathes depend on your installation. </p>
66 <h4 id="head-28a7e259e240e06c446a4e260ad6a96322de263d">Install</h4>
68 <p>Download the <a href="">MoinMoin</a> code that you are interested in updating to. </p>
69 <p>As root, run "<tt>python&nbsp;;install</tt>" to install the new version. </p>
71 <h4 id="head-1409f14b1d4801cdc1cfa7a7d31ebe9011a350f1">Configuration update</h4>
73 <p>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 "" (1.3: </p>
74 <p>This is especially true for: </p>
75 <ul>
76 <li><p> 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 <tt>allowed_actions</tt> list to the config. Currently, the actions <tt>DeletePage</tt> and <tt>AttachFile</tt> are considered unsafe. </p>
77 </li>
78 <li class="gap"><p> email features: you need to provide <tt>mail_smarthost</tt> and <tt>mail_from</tt>. </p>
79 </li>
80 <li class="gap"><p> new pages icons: to get new icons like "XML", "Subscribe" etc. it's best to just delete the <tt>page_icons</tt> setting, now that "" has a default for it. If you changed it in the past, add new icons from the "" default to your "". </p>
81 </li>
82 </ul>
84 <h4 id="head-93651cf60ec7638f011aa01673f747b168e68c9e">Updating files</h4>
86 <dl>
87 <dt>Images and CSS</dt>
88 <dd><p>On every update, you should copy the content of the "share/moin/htdocs/" directory to the directory visible to your web server, normally a new release has some new images and CSS 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 and CSS). </p>
89 </dd>
90 <dt>System pages</dt>
91 <dd><p>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. In 1.3 these pages are kept separate in the underlay directory. </p>
92 </dd>
93 <dt>InterWiki</dt>
94 <dd><p>Check that you have the newest "intermap.txt" file; If you have your own entries, you can point "shared_intermap" at a file loaded <em>before</em> the file in your data directory, which takes precedence (i.e. have global entries in the shared one, private entries the data dir file). </p>
95 </dd>
96 </dl>
98 <h4 id="head-7aa313a5b6991fdd59b559e6d7c26fb14442e8b7">Troubleshooting</h4>
100 <p>A good idea is to do a request for "moin.cgi?action=test" (which calls an internal diagnosis feature) after you installed a new release, which will spot some common errors. </p>
101 <p>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 <tt>700</tt> or <tt>755</tt>. </p>
103 <h3 id="head-b3a424f875af1a1f08e21a2a771ecd7459a6d4dc">Upgrade information for specfic versions</h3>
105 <p>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. </p>
106 <a id="update-1-0"></a>
107 <p> </p>
109 <h4 id="head-d45ca8cc7a44289d82ff1d58582c89bb638f3fcd">Version 1.0</h4>
111 <p>Version 1.0 is the last to support Python 1.5.2, but some optional features (like statistics) already require Python 2.0. </p>
112 <a id="update-1-1"></a>
113 <p> </p>
115 <h4 id="head-ab06519c303d7468ebd774ccade247864c85511f">Version 1.1</h4>
117 <p>Be sure to read the above section on <em>General procedures</em> before you start upgrading. </p>
118 <p><strong>Version 1.1 requires Python 2.0 or higher</strong>, we recommend to use Python 2.2 (version 2.2.2 if that is available on your host) or even better &gt;= 2.3.2 (with 2.3.x, <a href="">MoinMoin</a> runs about 20-30% faster). </p>
119 <p><strong>Upgrading your configuration</strong> </p>
120 <ul>
121 <li><p> If you changed the default for <tt>page_template_ending</tt>, this is now called <tt>page_template_regex</tt> and must contain a regex (defaults to '[a-z]Template$'). </p>
122 </li>
123 <li><p> Same applies to <tt>page_form_ending</tt> now called <tt>page_form_regex</tt> (default: '[a-z]Form$') </p>
124 </li>
125 <li><p> Not a new feature, but configurable now: <tt>page_category_regex</tt> (default: '^Category[A-Z]') </p>
126 </li>
127 <li><p> If you have added your own <tt>SecurityPolicy</tt>, the class interface for that has changed (see <tt></tt>). </p>
128 </li>
129 </ul>
130 <p><strong>Enabling new features</strong> </p>
131 <ul>
132 <li><p> <tt>default_lang</tt> (default: 'en') - If user does not set a language in his user settings, this will be used. </p>
133 </li>
134 <li><p> <tt>edit_locking</tt> (default: <tt>'warn&nbsp;10'</tt>) - Editor locking policy: None, 'warn &lt;timeout in minutes&gt;', or 'lock &lt;timeout in minutes&gt;'. </p>
135 </li>
136 <li><p> <tt>hosts_deny</tt> (default: <tt>[]</tt>) - a list of denied IPs; if an IP ends with a dot, it denies a whole subnet (class A, B or C). </p>
137 </li>
138 <li><p> <tt>html_pagetitle</tt> (default: <tt>None</tt>) - Allows you to set a specific HTML page title (if not set, it defaults to the value of sitename). </p>
139 </li>
140 <li><p> <tt>mail_login</tt> (default: <tt>None</tt>) - 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". </p>
141 </li>
142 <li><p> <tt>smileys</tt> (default: <tt>{}</tt>) - User-defined smileys (a dict with the markup as the key and a tuple of width, height, border, image name as the value). </p>
143 </li>
144 <li><p> don't forget to read the CHANGES file in the distribution archive </p>
145 </li>
146 </ul>
147 <a id="update-1-2"></a>
148 <p> </p>
150 <h4 id="head-b67c2d9266310861577c255faf04abda607713c7">Version 1.2</h4>
152 <p><strong>Version 1.2 requires Python 2.2.2 or higher</strong>, we recommend to use Python &gt;=2.3.2 (with 2.3.x, <a href="">MoinMoin</a> runs about 20-30% faster). </p>
153 <ul>
154 <li><p> the URL for the <a href="">RecentChanges</a> RSS feed changed. It now only works with <tt>?action=rss_rc</tt>. </p>
155 </li>
156 <li class="gap"><p> drawings use a new applet. It saves PNG instead of GIF and can do image maps to make areas of the drawing active. On display a GIF will be searched if no PNG is found. We recommend changing all GIFs to indexed PNGs cause this fallback might disappear in later versions. Sample code using bash &amp; ImageMagick (be sure you know what you do):
157 </p>
158 <pre>
159 for draw in `find /path/to/wiki/data -name \*.draw`; do
160 file=`dirname $draw`/`basename $draw .draw`
161 if [ -e "${file}.gif" ]; then
162 echo "Converting ${file}.gif to ${file}.png"
163 convert "${file}.gif" "${file}.png"
164 fi
165 done
166 </pre>
167 </li>
168 <li class="gap"><p> <tt>caching_formats</tt> (default: <tt>['text_html',]</tt>) - enable caching for the given output formats; enabled by default. Developers maybe want to disable this and use the empty list. </p>
169 </li>
170 <li class="gap"><p> Themeing and HTML/CSS cleanup </p>
171 <ul>
172 <li><p> Browsers with completely broken CSS support (like e.g. Netscape 4.x) are no longer supported. If you still need to support them, do not upgrade to moin 1.2. If you still use these browsers, we recommend that you upgrade your browser first (Mozilla 1.5 has nice and standards compliant HTML and CSS support and is available as Free Software for Windows, Linux and Mac). </p>
173 </li>
174 <li><p> If you changed any html in code or by config you will have to check if it still works. For the usual stuff, look into <tt>MoinMoin/theme/</tt> and <tt>classic/css/screen.css</tt>. For config defaults of the html fragments, read <tt>MoinMoin/</tt>. If you want to modify a theme, don't simply change classic, but copy or subclass it under a new theme name. </p>
175 </li>
176 <li><p> because of the new theme support the layout of the <tt>htdocs</tt> directory changed: </p>
177 <ul>
178 <li><p> Instead of using icons under <tt>img/</tt> and css under <tt>css/</tt>, there will be an additional <tt>themename/</tt> directory in between, e.g. <tt>classic/img/</tt> and <tt>classic/css/</tt>. If you added own icons, you may have to copy them to the themes directory. </p>
179 </li>
180 <li><p> The filename of the CSS file has changed to the media type, so the normal one used for screen output has changed name from <tt>moinmoin.css</tt> to <tt>screen.css</tt>. There also were quite some changes and enhancements to the CSS files, so better use the new ones. </p>
181 </li>
182 </ul>
183 </li>
184 <li><p> config.css_url was removed </p>
185 </li>
186 </ul>
187 </li>
188 <li class="gap"><p> Plugins - we use a new plugin loader that requires a correct <tt></tt> file in the plugin directories. See the directory <tt>wiki/data/plugin/</tt> in the distribution archive and just copy it over to your wiki's plugin directory. </p>
189 </li>
190 <li class="gap"><p> Do not forget to update to the new Twikidrawplugin that comes with moin 1.2. </p>
191 </li>
192 <li class="gap"><p> removed config variables: </p>
193 <ul>
194 <li><p> external_diff (not needed any more, we have internal diff now) </p>
195 </li>
196 <li><p> shared_metadb (wasn't implemented for long - we will re-add it, when it is) </p>
197 </li>
198 <li><p> title1/2 (please use page_header1/2) </p>
199 </li>
200 <li><p> page_icons_up </p>
201 </li>
202 </ul>
203 </li>
204 <li class="gap"><p> changed config variables: </p>
205 <ul>
206 <li><p> changed_time_fmt (removed some html and brackets around time from default) </p>
207 </li>
208 <li><p> html_head (default is empty string now) </p>
209 </li>
210 <li><p> page_footer1/2 (default is empty string now) </p>
211 </li>
212 <li><p> page_icons (is now a list of icon names, not html any more) </p>
213 </li>
214 <li><p> umask (default is 0770 now, not world r/w any more == more secure) </p>
215 </li>
216 </ul>
217 </li>
218 <li class="gap"><p> new config variables (see <a class="interwiki" title="MoinMaster" href=""><img src="wiki/htdocs/modern/img/moin-inter.png" alt="[MoinMaster]" height="16" width="16">HelpOnConfiguration</a>): </p>
219 <ul>
220 <li><p> cookie_lifetime </p>
221 </li>
222 <li><p> mail_login </p>
223 </li>
224 <li><p> page_credits </p>
225 </li>
226 <li><p> page_dict_regex </p>
227 </li>
228 <li><p> page_group_regex </p>
229 </li>
230 <li><p> page_header1/2 </p>
231 </li>
232 <li><p> page_iconbar </p>
233 </li>
234 <li><p> page_icons_table </p>
235 </li>
236 <li><p> page_license_enabled </p>
237 </li>
238 <li><p> page_license_page </p>
239 </li>
240 <li><p> theme_default </p>
241 </li>
242 <li><p> theme_force </p>
243 </li>
244 <li><p> tz_offset </p>
245 </li>
246 </ul>
247 </li>
248 </ul>
249 <a id="update-1-2-1"></a>
250 <p> <a id="update-1-2-2"></a>
251 <a id="update-1-2-3"></a>
252 </p>
254 <h4 id="head-6b39642936e912c76ea6eec794a0ce182bf5f751">Version 1.2.1, 1.2.2, 1.2.3</h4>
256 <p>As 1.2.x is primarily a bug-fix release for 1.2, there is not much special if you run 1.2 and want to update to 1.2.x. </p>
257 <p>If you run a version previous to 1.2, please read above about upgrading to 1.2 first. </p>
258 <p>In any case, read the <tt>CHANGES</tt> file in the toplevel directory of your moin archive - all fixes are described there and also some few new features. </p>
259 <p>Be aware that except code fixes, there were also fixes in the data and htdocs directory - so please selectively copy them over to your running wiki installation. </p>
260 <a id="update-1-3"></a>
261 <p> </p>
263 <h4 id="head-bad7644afcfbab5ecaffd6f8fa739abf11841232">Version 1.3</h4>
265 <p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> Upgrading to moin 1.3 will be non-trivial. It will definitely take you more than 5 minutes. <img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> </p>
266 <p>This is because of many changes to configuration, data format, filenames and pathes. </p>
267 <p>In any case, make a backup or you risk destroying your wiki's content. </p>
268 <p>Please read the files <tt>CHANGES</tt> and <tt>README.migration</tt> in the toplevel directory of your moin archive for details on what changed and how to upgrade. </p>
270 <h4 id="head-64b74b335c0bb5764150db10b4f12dc7b9b1154f">Deprecation Note</h4>
272 <p>This page is deprecated (at least the version specific stuff on it), for 1.4 it will be gone and we will use CHANGES file exclusively. </p>
273 <a id="bottom"></a>
275 </div>
276 <p id="pageinfo" class="info" lang="en" dir="ltr">last edited 2005-02-02 20:39:41 by <span title="">AlexanderSchremmer</span></p>
277 <div id="pagebottom"></div>
278 </div>
279 </body>
280 </html>