~ubuntu-branches/ubuntu/natty/moin/natty-updates

<li><a class="backlink" href="http://master19.moinmo.in/4ct10n/fullsearch/HelpOnUpdating?action=fullsearch&context=180&value=linkto%3A%22HelpOnUpdating%22" rel="nofollow" title="Click to do a full-text search for this title">HelpOnUpdating</a></li>

<li><a class="backlink" href="http://master17.moinmo.in/4ct10n/fullsearch/HelpOnUpdating?action=fullsearch&context=180&value=linkto%3A%22HelpOnUpdating%22" rel="nofollow" title="Click to do a full-text search for this title">HelpOnUpdating</a></li>

</ul>

<h1 id="Updating_MoinMoin">Updating MoinMoin</h1>

<div class="table-of-contents">Contents<ol><li>

<a href="#Updating_MoinMoin">Updating MoinMoin</a><ol><li>

<a href="#General_procedures">General procedures</a><ol><li>

<a href="#Download_and_unpack_the_new_MoinMoin_archive">Download and unpack the new MoinMoin archive</a></li><li>

<a href="#Reading_the_docs">Reading the docs</a></li><li>

<a href="http://master17.moinmo.in/HelpContents">HelpContents</a> > <a href="http://master17.moinmo.in/HelpOnAdministration">HelpOnAdministration</a> > HelpOnUpdating Index <div class="table-of-contents">Contents<ol><li><ol><li>

<a href="#Generalprocedures">General procedures</a><ol><li>

<a href="#DownloadandunpackthenewMoinMoinarchive">Download and unpack the new MoinMoin archive</a></li><li>

<a href="#Readingthedocs">Reading the docs</a></li><li>

<a href="#Backup">Backup</a></li><li>

<a href="#Code_update">Code update</a></li><li>

<a href="#Configuration_update">Configuration update</a></li><li>

<a href="#Static_files">Static files</a></li><li>

<a href="#Wiki_pages_update">Wiki pages update</a><ol><li>

<a href="#System_and_Help_pages">System and Help pages</a></li><li>

<a href="#InterWiki_data">InterWiki data</a></li><li>

<a href="#Your_valuable_own_pages">Your valuable own pages</a></li></ol></li><li>

<a href="#Clean_your_cache">Clean your cache</a></li><li>

<a href="#Troubleshooting">Troubleshooting</a></li></ol></li><li>

<a href="#Version_specific_notes">Version specific notes</a></li></ol></li></ol></div>

<h2 id="General_procedures">General procedures</h2>

<h3 id="Download_and_unpack_the_new_MoinMoin_archive">Download and unpack the new MoinMoin archive</h3>

Download the <a href="http://master19.moinmo.in/MoinMoin">MoinMoin</a> code that you are interested in updating to. If you are not a developer, this is usually the distribution archive for the latest released version from the project homepage.

<h3 id="Reading_the_docs">Reading the docs</h3>

<div class="note">Please read the files <tt class="backtick">docs/CHANGES</tt> and <tt class="backtick">docs/README.migration</tt> contained in the moin distribution archive for details on what changed and how to upgrade. The docs might contain import installation, compatibility and upgrade hints we won't repeat here. </div>

<a href="#Codeupdate">Code update</a></li><li>

<a href="#Configurationupdate">Configuration update</a></li><li>

<a href="#Staticstuffupdate">Static stuff update</a></li><li>

<a href="#Wikipagesupdate">Wiki pages update</a><ol><li>

<a href="#SystemandHelppages">System and Help pages</a></li><li>

<a href="#Yourvaluableownpages">Your valuable own pages</a></li></ol></li><li>

<a href="#Troubleshooting">Troubleshooting</a></li></ol></li></ol></li></ol></div>

<h2 id="Generalprocedures">General procedures</h2>

<h3 id="DownloadandunpackthenewMoinMoinarchive">Download and unpack the new MoinMoin archive</h3>

Download the <a href="http://master17.moinmo.in/MoinMoin">MoinMoin</a> code that you are interested in updating to. If you are not a developer, this is usually the latest released version from the project homepage. <img alt="(!)" height="15" src="http://static.moinmo.in/moin_static170/modern/img/idea.png" title="(!)" width="15" /> Often it is better (and easy enough) to install latest release from distribution archive than relying on some outdated package provided by your Linux distribution. Some people use moin as a package, because they hope for easy upgrades and security fixes. But often, there are either no upgrades or they are not easy and in the worst case, there are not even security fixes.

<h3 id="Readingthedocs">Reading the docs</h3>

Please read the files <tt class="backtick">docs/CHANGES</tt> and <tt class="backtick">docs/README.migration</tt> contained in the moin distribution archive for details on what changed and how to upgrade. <img alt="/!\" height="15" src="http://static.moinmo.in/moin_static170/modern/img/alert.png" title="/!\" width="15" /> The docs might contain import installation, compatibility and upgrade hints we won't repeat here.

<h3 id="Backup">Backup</h3>

<div class="warning">Before you update an existing wiki, MAKE A BACKUP! You have been warned, and it's not our fault when you end up like this: <img alt="X-(" height="16" src="/moin_static193/modernized/img/angry.png" title="X-(" width="16" /> </div>As you want to make a complete backup (not even losing a single edit), you want to stop your wiki server process now. This is what you should backup (the real paths depend on your installation): <ul><li>The directory containing the <a href="http://master19.moinmo.in/MoinMoin">MoinMoin</a> code files (e.g. <tt>/usr/lib/python*.*/site-packages/MoinMoin</tt>) <ul><li><img alt="(!)" height="16" src="/moin_static193/modernized/img/idea.png" title="(!)" width="16" /> after you have a backup of this, you might want to delete the <tt class="backtick">MoinMoin</tt> directory there to avoid having old code files there that are not overwritten by the new code, but maybe interfering with it) </li></ul></li><li>The directory containing your data (e.g. <tt>/usr/share/moin/wikiname/data</tt> - see data_dir in your moin_config.py). </li><li>your moin.wsgi file (or other server adaptor file you use) </li><li>your wikiconfig.py or farmconfig.py or other wiki configuration files </li><li>your web server configuration files </li><li>optionally you can also backup your underlay_data_dir (it shouldn't contain data from you, but it is maybe easier to rollback if you have a backup of it and don't need to get it from some other place) </li></ul>

<h3 id="Code_update">Code update</h3>

First remove the old <a href="http://master19.moinmo.in/MoinMoin">MoinMoin</a> code (including any <tt class="backtick">*.pyc</tt> and <tt class="backtick">*.pyo</tt> files). If you are installing from the original distribution archive, run "<tt>python setup.py install</tt>" as root to install the new version. If you are using some Linux (or other) distributor's package, please read their docs. Please also upgrade your moin.wsgi (or other) server adaptor file. You likely have to edit it to fix some pathes and you also need to set some specific user/group/mode on that file (just look at the old one before replacing it).

<h3 id="Configuration_update">Configuration update</h3>

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 and also changes that must break compatibility). Check that this is indeed the case, and then take the time to check the CHANGES file in your distribution archive. Often, new features will be invisible unless you extend your configuration in <tt class="backtick">wikiconfig.py</tt>. Check that you have the latest "intermap.txt" file; If you have your own entries, 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).

<h3 id="Static_files">Static files</h3>

Since release 1.9.0, moin has a built-in static file webserver to serve the CSS, images, javascript, etc. files that come with moin. This static file web server serves the files contained in path <tt class="backtick">MoinMoin/web/static/htdocs/</tt> at URL <tt class="backtick"><script URL> + <url_prefix_static></tt>. So, if you run your wiki at the root of your site (/) the default <tt class="backtick">url_prefix_static</tt> will work for you. The default <tt class="backtick">url_prefix_static</tt> is something like <tt class="backtick">/moin_staticVVV</tt> (VVV is 190 for moin release 1.9.0) and VVV will change on every release (moin 1.9.1 will use <tt class="backtick">/moin_static191</tt> by default). This is done to be able to use a very long cache lifetime for the static stuff, so your wiki will be faster and cause less load and traffic. Even if you don't use a long cache lifetime, a changing <tt class="backtick">url_prefix_static</tt> makes sure that if you upgrade your wiki all your wiki users will immediately get the fresh static stuff. If you run your wiki at a different base path, you need to set <tt class="backtick">url_prefix_static</tt> to the correct value, e.g. <tt class="backtick">url_prefix_static = '/mywiki' + url_prefix_static</tt> if you run your wiki at <tt class="backtick">/mywiki</tt>. If you want moin to serve a different directory than the default <tt class="backtick">MoinMoin/web/static/htdocs/</tt>, you can change the path in <tt class="backtick">moin.wsgi</tt> like <tt class="backtick">shared='/my/path/to/htdocs'</tt> to serve static files from that path. <img alt="(!)" height="16" src="/moin_static193/modernized/img/idea.png" title="(!)" width="16" /> Please note that if you serve the static files from a different than the "builtin" directory, you are responsible for updating those files from <tt class="backtick">MoinMoin/web/static/htdocs/</tt> when you upgrade your moin installation. Alternatively to using moin's builtin static files server, you can also serve the static files with some external webserver (e.g. with Apache, if that is your main web server). If you want to do this, just have your web server catch the requests for stuff below the <tt class="backtick">url_prefix_static</tt> URL (before they reach the moin script) and serve those requests with the files from <tt class="backtick">MoinMoin/web/static/htdocs/</tt> (or a copy of them).

<h3 id="Wiki_pages_update">Wiki pages update</h3>

<h4 id="System_and_Help_pages">System and Help pages</h4>

System and help pages are separately stored in the <tt class="backtick">underlay</tt> directory. Just use the fresh underlay directory we provide in the distribution archive (move the old one to your backup directory). If you previously modified some system page in your wiki (see <a href="http://master19.moinmo.in/EditedSystemPages">EditedSystemPages</a> on your wiki), you might want to Delete them to use moinmoin's updated version (warning: you can't un-delete that page later).

<h4 id="InterWiki_data">InterWiki data</h4>

Copy <tt class="backtick">intermap.txt</tt> from the distribution archive into your wiki data

<h4 id="Your_valuable_own_pages">Your valuable own pages</h4>

See CHANGES and README.migration for maybe necessary steps to convert your <tt class="backtick">data_dir</tt> to what we expect.

<h3 id="Clean_your_cache">Clean your cache</h3>

Finally, stop moin, delete cached data by running <tt class="backtick">moin ... maint cleancache</tt>, start moin.

<img alt="/!\" height="15" src="http://static.moinmo.in/moin_static170/modern/img/alert.png" title="/!\" width="15" /> Before you update an existing wiki, MAKE A BACKUP! You have been warned, and it's not our fault when you end up like this: <img alt="X-(" height="15" src="http://static.moinmo.in/moin_static170/modern/img/angry.png" title="X-(" width="15" /> As you want to make a complete backup (not even losing a single edit), you want to stop your wiki server process now. This is what you should backup (the real paths depend on your installation): <ul><li>The directory containing the <a href="http://master17.moinmo.in/MoinMoin">MoinMoin</a> code files (e.g. <tt>/usr/lib/python*.*/site-packages/MoinMoin</tt>) <ul><li><img alt="(!)" height="15" src="http://static.moinmo.in/moin_static170/modern/img/idea.png" title="(!)" width="15" /> after you have a backup of this, you might want to delete the <tt class="backtick">MoinMoin</tt> directory there to avoid having old code files there that are not overwritten by the new code, but maybe interfering with it) </li></ul></li><li>The directory containing your data (e.g. <tt>/usr/share/moin/wikiname/data</tt> - see data_dir in your moin_config.py). </li><li>your moin.cgi file (or moin.fcg or other adaptor file you use) </li><li>your wikiconfig.py or farmconfig.py or other wiki configuration files </li><li>your web server configuration files </li><li>optionally you can also backup your underlay_data_dir (it shouldn't contain data from you, but it is maybe easier to rollback if you have a backup of it and don't need to get it from some other place) </li></ul>

<h3 id="Codeupdate">Code update</h3>

First remove the old <a href="http://master17.moinmo.in/MoinMoin">MoinMoin</a> code (including any <tt class="backtick">*.pyc</tt> and <tt class="backtick">*.pyo</tt> files). If you are installing from the original distribution archive, run "<tt>python setup.py install</tt>" as root to install the new version. If you are using some Linux (or other) distributor's package, please read their docs. Please also upgrade your moin.cgi (or moin.wsgi or other) server adaptor file. You likely have to edit it to fix some pathes and you also need to set some specific user/group/mode on that file (just look at the old one before replacing it).

<h3 id="Configurationupdate">Configuration update</h3>

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 and also changes that must break compatibility). Check that this is indeed the case, and then take the time to check the CHANGES file in your distribution archive. Often, new features will be invisible unless you extend your configuration in <tt class="backtick">wikiconfig.py</tt>. Check that you have the latest "intermap.txt" file; If you have your own entries, 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).

<h3 id="Staticstuffupdate">Static stuff update</h3>

On every update, you should copy the content of the "wiki/htdocs/" directory we provide to the directory visible to your web server, normally a new release has some new images, CSS and Javascript in it. You also have to change your web server / directory setup to match the <tt class="backtick">url_prefix_static</tt> setting of moin. This defaults to <tt class="backtick">/moin_staticVVV</tt> (VVV is 170 for moin release 1.7.0) and the default will change on every release (moin 1.7.1 will use <tt class="backtick">/moin_static171</tt> by default). This is done to be able to use a very long cache lifetime for the static stuff, so your wiki will be faster and cause less load and traffic.

<h3 id="Wikipagesupdate">Wiki pages update</h3>

<h4 id="SystemandHelppages">System and Help pages</h4>

System and help pages are separately stored in the <tt class="backtick">underlay</tt> directory. Just use the fresh underlay directory we provide in the distribution archive (move the old one to your backup directory).

<h4 id="Yourvaluableownpages">Your valuable own pages</h4>

See CHANGES and README.migration for maybe necessary steps to convert your <tt class="backtick">data_dir</tt> to what we expect.

<h3 id="Troubleshooting">Troubleshooting</h3>

Hints: <ul><li>Use absolute pathes, not relative ones. </li><li class="gap">Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log! </li><li class="gap">Make sure python can find the MoinMoin code package and your wiki configuration files (fix <tt class="backtick">sys.path</tt> in the server adaptor script or PYTHONPATH in the environment). </li><li class="gap">Make sure MoinMoin can find the data_dir and data_underlay_dir (see <tt class="backtick">wikiconfig.py</tt>). </li><li class="gap">When you are editing python code files (e.g. <tt class="backtick">wikiconfig.py</tt>), be careful to indent correctly (use 4 spaces, not tabs) and also be careful not to make syntax errors. If you have a working config, do not make too many changes at once (and have a backup of a working version). </li><li class="gap">Check permissions (the moin process needs read/write access to <tt class="backtick">data_dir</tt> and <tt class="backtick">data_underlay_dir</tt>, it needs at least read access to the <a href="http://master19.moinmo.in/MoinMoin">MoinMoin</a> code and configuration). </li><li class="gap">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 class="backtick">700</tt> or <tt class="backtick">770</tt> - see also the <tt class="backtick">config.umask</tt> setting. </li></ul>

<h2 id="Version_specific_notes">Version specific notes</h2>

<ul><li>For 1.2.x to 1.3.x, you maybe find some useful hints on <a class="interwiki" href="http://moinmo.in/MauricioHernandez/HowToSurviveMigration" title="MoinMoin">MauricioHernandez/HowToSurviveMigration</a>. </li><li>For 1.5.x to 1.6.x, see <a class="interwiki" href="http://moinmo.in/RickVanderveer/UpgradingFromMoin15ToMoin16" title="MoinMoin">RickVanderveer/UpgradingFromMoin15ToMoin16</a>. </li><li>For 1.6.x to 1.7.x, see <a class="interwiki" href="http://moinmo.in/RickVanderveer/UpgradingFromMoin16ToMoin17" title="MoinMoin">RickVanderveer/UpgradingFromMoin16ToMoin17</a>. </li><li>For 1.7.x to 1.8.x, see <a class="interwiki" href="http://moinmo.in/RickVanderveer/UpgradingFromMoin17ToMoin18" title="MoinMoin">RickVanderveer/UpgradingFromMoin17ToMoin18</a>. </li><li>For 1.8.x to 1.9.x, see <a class="interwiki" href="http://moinmo.in/RickVanderveer/UpgradingFromMoin18ToMoin19" title="MoinMoin">RickVanderveer/UpgradingFromMoin18ToMoin19</a>. </li></ul></div>MoinMaster: HelpOnUpdating (last edited 2010-05-25 17:21:51 by <a class="interwiki" href="http://moinmo.in/ThomasWaldmann" title="ThomasWaldmann @ p57B42A2E.dip0.t-ipconnect.de[87.180.42.46]">ThomasWaldmann</a>)

Use absolute pathes, not relative ones. Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log! Make sure python can find the MoinMoin code package and your wiki configuration files (fix <tt class="backtick">sys.path</tt> in the server adaptor script or PYTHONPATH in the environment). Make sure MoinMoin can find the data_dir and data_underlay_dir (see <tt class="backtick">wikiconfig.py</tt>). When you are editing python code files (e.g. <tt class="backtick">wikiconfig.py</tt>), be careful to indent correctly (use 4 spaces, not tabs) and also be careful not to make syntax errors. If you have a working config, do not make too many changes at once (and have a backup of a working version). Check permissions (the moin process needs read/write access to <tt class="backtick">data_dir</tt> and <tt class="backtick">data_underlay_dir</tt>, it needs at least read access to the <a href="http://master17.moinmo.in/MoinMoin">MoinMoin</a> code and configuration). 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 class="backtick">700</tt> or <tt class="backtick">770</tt> - see also the <tt class="backtick">config.umask</tt> setting. </div>MoinMaster: HelpOnUpdating (last edited 2008-06-08 14:27:43 by localhost)

</div>

</body>

Older »