comparison docs/UPDATE.html @ 3888:a016745f4cca

make install-docs interwiki
author Thomas Waldmann <tw AT waldmann-edv DOT de>
date Sun, 20 Jul 2008 14:14:01 +0200
parents 8ffe79f29100
children a1f682e8f8f8
comparison
equal deleted inserted replaced
3886:3d3cbae4c550 3888:a016745f4cca
17 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="http://static.moinmo.in/moin_static170/modern/css/msie.css"> 17 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="http://static.moinmo.in/moin_static170/modern/css/msie.css">
18 <![endif]--> 18 <![endif]-->
19 19
20 20
21 21
22
22 <link rel="Start" href="http://master17.moinmo.in/FrontPage"> 23 <link rel="Start" href="http://master17.moinmo.in/FrontPage">
23 <link rel="Alternate" title="Wiki Markup" href="http://master17.moinmo.in/HelpOnUpdating?action=raw"> 24 <link rel="Alternate" title="Wiki Markup" href="http://master17.moinmo.in/HelpOnUpdating?action=raw">
24 <link rel="Alternate" media="print" title="Print View" href="http://master17.moinmo.in/HelpOnUpdating?action=print"> 25 <link rel="Alternate" media="print" title="Print View" href="http://master17.moinmo.in/HelpOnUpdating?action=print">
25 <link rel="Search" href="http://master17.moinmo.in/FindPage"> 26 <link rel="Search" href="http://master17.moinmo.in/FindPage">
26 <link rel="Index" href="http://master17.moinmo.in/TitleIndex"> 27 <link rel="Index" href="http://master17.moinmo.in/TitleIndex">
33 <div id="interwiki"><span><a href="http://master17.moinmo.in/FrontPage" rel="nofollow">MoinMaster</a></span></div> 34 <div id="interwiki"><span><a href="http://master17.moinmo.in/FrontPage" rel="nofollow">MoinMaster</a></span></div>
34 <ul id="pagelocation"> 35 <ul id="pagelocation">
35 <li><a class="backlink" href="http://master17.moinmo.in/4ct10n/fullsearch/HelpOnUpdating?action=fullsearch&amp;context=180&amp;value=linkto%3A%22HelpOnUpdating%22" rel="nofollow" title="Click to do a full-text search for this title">HelpOnUpdating</a></li> 36 <li><a class="backlink" href="http://master17.moinmo.in/4ct10n/fullsearch/HelpOnUpdating?action=fullsearch&amp;context=180&amp;value=linkto%3A%22HelpOnUpdating%22" rel="nofollow" title="Click to do a full-text search for this title">HelpOnUpdating</a></li>
36 </ul> 37 </ul>
37 <div dir="ltr" id="content" lang="en"><span class="anchor" id="top"></span> 38 <div dir="ltr" id="content" lang="en"><span class="anchor" id="top"></span>
38 <span class="anchor" id="line-8"></span><p class="line867"><a href="http://master17.moinmo.in/HelpContents">HelpContents</a> &gt; <a href="http://master17.moinmo.in/HelpOnAdministration">HelpOnAdministration</a> &gt; HelpOnUpdating <span class="anchor" id="line-9"></span><span class="anchor" id="line-10"></span><p class="line867"><strong>Index</strong> <span class="anchor" id="line-11"></span><div class="table-of-contents"><p class="table-of-contents-heading">Contents<ol><li><ol><li> 39 <span class="anchor" id="line-8"></span><p class="line867"><a href="http://master17.moinmo.in/HelpContents">HelpContents</a> &gt; <a href="http://master17.moinmo.in/HelpOnAdministration">HelpOnAdministration</a> &gt; HelpOnUpdating <span class="anchor" id="line-9"></span><span class="anchor" id="line-10"></span><p class="line867"><strong>Index</strong> <span class="anchor" id="line-11"></span><div class="table-of-contents"><p class="table-of-contents-heading">Contents<ol><li>
39 <a href="#Generalprocedures">General procedures</a><ol><li> 40 <a href="#Generalprocedures">General procedures</a><ol><li>
40 <a href="#DownloadandunpackthenewMoinMoinarchive">Download and unpack the new MoinMoin archive</a></li><li> 41 <a href="#DownloadandunpackthenewMoinMoinarchive">Download and unpack the new MoinMoin archive</a></li><li>
41 <a href="#Readingthedocs">Reading the docs</a></li><li> 42 <a href="#Readingthedocs">Reading the docs</a></li><li>
42 <a href="#Backup">Backup</a></li><li> 43 <a href="#Backup">Backup</a></li><li>
43 <a href="#Codeupdate">Code update</a></li><li> 44 <a href="#Codeupdate">Code update</a></li><li>
44 <a href="#Configurationupdate">Configuration update</a></li><li> 45 <a href="#Configurationupdate">Configuration update</a></li><li>
45 <a href="#Staticstuffupdate">Static stuff update</a></li><li> 46 <a href="#Staticstuffupdate">Static stuff update</a></li><li>
46 <a href="#Wikipagesupdate">Wiki pages update</a><ol><li> 47 <a href="#Wikipagesupdate">Wiki pages update</a><ol><li>
47 <a href="#SystemandHelppages">System and Help pages</a></li><li> 48 <a href="#SystemandHelppages">System and Help pages</a></li><li>
49 <a href="#InterWikidata">InterWiki data</a></li><li>
48 <a href="#Yourvaluableownpages">Your valuable own pages</a></li></ol></li><li> 50 <a href="#Yourvaluableownpages">Your valuable own pages</a></li></ol></li><li>
51 <a href="#Cleanyourcache">Clean your cache</a></li><li>
49 <a href="#Troubleshooting">Troubleshooting</a></li></ol></li></ol></li></ol></div><p class="line874"> <span class="anchor" id="line-12"></span><span class="anchor" id="line-13"></span><p class="line867"> 52 <a href="#Troubleshooting">Troubleshooting</a></li></ol></li></ol></li></ol></div><p class="line874"> <span class="anchor" id="line-12"></span><span class="anchor" id="line-13"></span><p class="line867">
50 <h2 id="Generalprocedures">General procedures</h2> 53 <h2 id="Generalprocedures">General procedures</h2>
51 <span class="anchor" id="line-14"></span><p class="line867"> 54 <span class="anchor" id="line-14"></span><p class="line867">
52 <h3 id="DownloadandunpackthenewMoinMoinarchive">Download and unpack the new MoinMoin archive</h3> 55 <h3 id="DownloadandunpackthenewMoinMoinarchive">Download and unpack the new MoinMoin archive</h3>
53 <span class="anchor" id="line-15"></span><p class="line862">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. <span class="anchor" id="line-16"></span><span class="anchor" id="line-17"></span><p class="line867"><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 <em>latest</em> 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. <span class="anchor" id="line-18"></span><span class="anchor" id="line-19"></span><span class="anchor" id="line-20"></span><p class="line867"> 56 <span class="anchor" id="line-15"></span><p class="line862">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. <span class="anchor" id="line-16"></span><span class="anchor" id="line-17"></span><p class="line867"><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 <em>latest</em> 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. <span class="anchor" id="line-18"></span><span class="anchor" id="line-19"></span><span class="anchor" id="line-20"></span><p class="line867">
63 <span class="anchor" id="line-60"></span><span class="anchor" id="line-61"></span><p class="line874">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. <span class="anchor" id="line-62"></span><span class="anchor" id="line-63"></span><p class="line862">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. <span class="anchor" id="line-64"></span><span class="anchor" id="line-65"></span><p class="line867"> 66 <span class="anchor" id="line-60"></span><span class="anchor" id="line-61"></span><p class="line874">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. <span class="anchor" id="line-62"></span><span class="anchor" id="line-63"></span><p class="line862">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. <span class="anchor" id="line-64"></span><span class="anchor" id="line-65"></span><p class="line867">
64 <h3 id="Wikipagesupdate">Wiki pages update</h3> 67 <h3 id="Wikipagesupdate">Wiki pages update</h3>
65 <span class="anchor" id="line-66"></span><p class="line867"> 68 <span class="anchor" id="line-66"></span><p class="line867">
66 <h4 id="SystemandHelppages">System and Help pages</h4> 69 <h4 id="SystemandHelppages">System and Help pages</h4>
67 <span class="anchor" id="line-67"></span><p class="line862">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). <span class="anchor" id="line-68"></span><span class="anchor" id="line-69"></span><p class="line867"> 70 <span class="anchor" id="line-67"></span><p class="line862">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). <span class="anchor" id="line-68"></span><span class="anchor" id="line-69"></span><p class="line867">
71 <h4 id="InterWikidata">InterWiki data</h4>
72 <span class="anchor" id="line-70"></span><p class="line862">Copy <tt class="backtick">intermap.txt</tt> from the distribution archive into your wiki data <span class="anchor" id="line-71"></span><span class="anchor" id="line-72"></span><p class="line867">
68 <h4 id="Yourvaluableownpages">Your valuable own pages</h4> 73 <h4 id="Yourvaluableownpages">Your valuable own pages</h4>
69 <span class="anchor" id="line-70"></span><p class="line862">See CHANGES and README.migration for maybe necessary steps to convert your <tt class="backtick">data_dir</tt> to what we expect. <span class="anchor" id="line-71"></span><span class="anchor" id="line-72"></span><p class="line867"> 74 <span class="anchor" id="line-73"></span><p class="line862">See CHANGES and README.migration for maybe necessary steps to convert your <tt class="backtick">data_dir</tt> to what we expect. <span class="anchor" id="line-74"></span><span class="anchor" id="line-75"></span><p class="line867">
75 <h3 id="Cleanyourcache">Clean your cache</h3>
76 <span class="anchor" id="line-76"></span><p class="line862">Finally, delete cached data by running <tt class="backtick">moin&nbsp;...&nbsp;maint&nbsp;cleancache</tt>. This is necessary for things like the updated <a href="http://master17.moinmo.in/InterWiki">InterWiki</a> data to trickle down into the pages that use it. <span class="anchor" id="line-77"></span><span class="anchor" id="line-78"></span><p class="line867">
70 <h3 id="Troubleshooting">Troubleshooting</h3> 77 <h3 id="Troubleshooting">Troubleshooting</h3>
71 <span class="anchor" id="line-73"></span><p class="line874">Use absolute pathes, not relative ones. <span class="anchor" id="line-74"></span><span class="anchor" id="line-75"></span><p class="line874">Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log! <span class="anchor" id="line-76"></span><span class="anchor" id="line-77"></span><p class="line862">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). <span class="anchor" id="line-78"></span><span class="anchor" id="line-79"></span><p class="line862">Make sure MoinMoin can find the data_dir and data_underlay_dir (see <tt class="backtick">wikiconfig.py</tt>). <span class="anchor" id="line-80"></span><span class="anchor" id="line-81"></span><p class="line862">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). <span class="anchor" id="line-82"></span><span class="anchor" id="line-83"></span><p class="line862">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). <span class="anchor" id="line-84"></span><span class="anchor" id="line-85"></span><p class="line862">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. <span class="anchor" id="line-86"></span><span class="anchor" id="bottom"></span></div><p id="pageinfo" class="info" lang="en" dir="ltr">MoinMaster: HelpOnUpdating (last edited 2008-06-08 14:27:43 by <span title="??? @ localhost[127.0.0.1]">localhost</span>)</p> 78 <span class="anchor" id="line-79"></span><p class="line874">Use absolute pathes, not relative ones. <span class="anchor" id="line-80"></span><span class="anchor" id="line-81"></span><p class="line874">Make sure you have an adequate logging configuration (see server adaptor script and the logging configuration file) and carefully read the log! <span class="anchor" id="line-82"></span><span class="anchor" id="line-83"></span><p class="line862">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). <span class="anchor" id="line-84"></span><span class="anchor" id="line-85"></span><p class="line862">Make sure MoinMoin can find the data_dir and data_underlay_dir (see <tt class="backtick">wikiconfig.py</tt>). <span class="anchor" id="line-86"></span><span class="anchor" id="line-87"></span><p class="line862">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). <span class="anchor" id="line-88"></span><span class="anchor" id="line-89"></span><p class="line862">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). <span class="anchor" id="line-90"></span><span class="anchor" id="line-91"></span><p class="line862">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. <span class="anchor" id="line-92"></span><span class="anchor" id="bottom"></span></div><p id="pageinfo" class="info" lang="en" dir="ltr">MoinMaster: HelpOnUpdating (last edited 2008-07-16 18:34:31 by <span title="SamMorris @ 78.146.165.120[78.146.165.120]"><a class="interwiki" href="http://moinmo.in/SamMorris" title="SamMorris @ 78.146.165.120[78.146.165.120]">SamMorris</a></span>)</p>
72 <div id="pagebottom"></div> 79 <div id="pagebottom"></div>
73 </div> 80 </div>
74 </body> 81 </body>
75 </html> 82 </html>
76 83