comparison docs/INSTALL.html @ 394:4d58b19bd3a7

make underlay install-docs interwiki imported from: moin--main--1.5--patch-398
author Thomas Waldmann <tw@waldmann-edv.de>
date Sat, 21 Jan 2006 20:48:49 +0000
parents 89d0a178964a
children 8eefc299cf06
comparison
equal deleted inserted replaced
393:f25101c236bb 394:4d58b19bd3a7
96 </ol> 96 </ol>
97 <li><a href="#head-d7d600c8dcfdd9270f4a6642566404ede510f46a">Test installation</a></li> 97 <li><a href="#head-d7d600c8dcfdd9270f4a6642566404ede510f46a">Test installation</a></li>
98 <li><a href="#head-87a60f1d02c36fb1804b442815dba49cbc8adfe7">What has been installed</a></li> 98 <li><a href="#head-87a60f1d02c36fb1804b442815dba49cbc8adfe7">What has been installed</a></li>
99 </ol> 99 </ol>
100 <span id="line-14" class="anchor"></span></p> 100 <span id="line-14" class="anchor"></span></p>
101 <span id="line-15" class="anchor"></span><p>Before you can integrate Moin<tt></tt>Moin into your web environment, you have to install the <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> source code and data files using the standard Python <em>distutils</em> mechanism (<tt>setup.py</tt>). This page explains the steps you usually need to take to do this. For more details on the <em>distutils</em> installation process, consult the <a class="www" href="http://www.python.org/doc/current/inst/inst.html">Installing Python Modules</a> document in your Python documentation set. <span id="line-16" class="anchor"></span></p> 101 <span id="line-15" class="anchor"></span><p>Before you can integrate Moin<tt></tt>Moin into your web environment, you have to install the <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> source code and data files using the standard Python <em>distutils</em> mechanism (<tt>setup.py</tt>). This page explains the steps you usually need to take to do this. For more details on the <em>distutils</em> installation process, consult the <a class="http" href="http://www.python.org/doc/current/inst/inst.html">Installing Python Modules</a> document in your Python documentation set. <span id="line-16" class="anchor"></span></p>
102 <span id="line-17" class="anchor"></span><p>The installation is similar on Windows and Linux (and other POSIX-type systems; for simplicity, we just say "Linux" in the docs). <span id="line-18" class="anchor"></span></p> 102 <span id="line-17" class="anchor"></span><p>The installation is similar on Windows and Linux (and other POSIX-type systems; for simplicity, we just say "Linux" in the docs). <span id="line-18" class="anchor"></span></p>
103 <span id="line-19" class="anchor"></span><ul> 103 <span id="line-19" class="anchor"></span><ul>
104 <li style="list-style-type:none"><p><img src="wiki/htdocs/modern/img/idea.png" alt="(!)" height="15" width="15"> We use text such as <strong><tt>&gt;&nbsp;command&nbsp;arguments</tt></strong> to show what you have to type at the command prompt (also known as shell, terminal, etc.). In our examples "<tt>&gt;&nbsp;</tt>" is the prompt, you don't have to type it in, you have to type what comes after it. Lines that do not begin with "<tt>&gt;&nbsp;</tt>" are the answers to the commands you have typed. Read them carefully. <span id="line-20" class="anchor"></span></p> 104 <li style="list-style-type:none"><p><img src="wiki/htdocs/modern/img/idea.png" alt="(!)" height="15" width="15"> We use text such as <strong><tt>&gt;&nbsp;command&nbsp;arguments</tt></strong> to show what you have to type at the command prompt (also known as shell, terminal, etc.). In our examples "<tt>&gt;&nbsp;</tt>" is the prompt, you don't have to type it in, you have to type what comes after it. Lines that do not begin with "<tt>&gt;&nbsp;</tt>" are the answers to the commands you have typed. Read them carefully. <span id="line-20" class="anchor"></span></p>
105 <span id="line-21" class="anchor"></span></li> 105 <span id="line-21" class="anchor"></span></li>
106 </ul> 106 </ul>
107 107
108 <h1 id="head-2fa431ad9c9bff5badd07c5ee676b19852ed28e3">Check if Python is working</h1> 108 <h1 id="head-2fa431ad9c9bff5badd07c5ee676b19852ed28e3">Check if Python is working</h1>
109 109
110 <span id="line-22" class="anchor"></span><span id="line-23" class="anchor"></span><p>Moin<tt></tt>Moin needs Python to run, so the first step is to check if an usable version of Python is installed and correctly set-up. If this is not the case, you will have to fix that before you can proceed. <span id="line-24" class="anchor"></span></p> 110 <span id="line-22" class="anchor"></span><span id="line-23" class="anchor"></span><p>Moin<tt></tt>Moin needs Python to run, so the first step is to check if an usable version of Python is installed and correctly set-up. If this is not the case, you will have to fix that before you can proceed. <span id="line-24" class="anchor"></span></p>
111 <span id="line-25" class="anchor"></span><p>The <tt>CHANGES</tt> file in the Moin<tt></tt>Moin archive mentions what versions are supported. Python 2.3 is the minimum requirement for Moin<tt></tt>Moin 1.5, but we suggest you use the latest Python release version. <span id="line-26" class="anchor"></span></p> 111 <span id="line-25" class="anchor"></span><p>The <tt>CHANGES</tt> file in the Moin<tt></tt>Moin archive mentions what versions are supported. Python 2.3 is the minimum requirement for Moin<tt></tt>Moin 1.5, but we suggest you use the latest Python release version. <span id="line-26" class="anchor"></span></p>
112 <span id="line-27" class="anchor"></span><p>You can download Python at <a class="www" href="http://www.python.org/download/">http://www.python.org/download/</a>. <span id="line-28" class="anchor"></span></p> 112 <span id="line-27" class="anchor"></span><p>You can download Python at <a class="http" href="http://www.python.org/download/">http://www.python.org/download/</a>. <span id="line-28" class="anchor"></span></p>
113 <span id="line-29" class="anchor"></span><p>If you are pretty sure an acceptable version of Python is installed but the commands below do not work, this may be because your Python files are not in the <em>search path</em>. Correctly setting the search path is outside the scope of this document; please ask for help on your favorite Python, Linux, or Windows discussion board. <span id="line-30" class="anchor"></span></p> 113 <span id="line-29" class="anchor"></span><p>If you are pretty sure an acceptable version of Python is installed but the commands below do not work, this may be because your Python files are not in the <em>search path</em>. Correctly setting the search path is outside the scope of this document; please ask for help on your favorite Python, Linux, or Windows discussion board. <span id="line-30" class="anchor"></span></p>
114 <span id="line-31" class="anchor"></span><p>If you have shell access, checking if Python is working is very simple. Just type the following command, and look at the result: <span id="line-32" class="anchor"></span> 114 <span id="line-31" class="anchor"></span><p>If you have shell access, checking if Python is working is very simple. Just type the following command, and look at the result: <span id="line-32" class="anchor"></span>
115 <span id="line-33" class="anchor"></span></p> 115 <span id="line-33" class="anchor"></span></p>
116 <pre> 116 <pre>
117 &gt; python -V 117 &gt; python -V
135 <span id="line-51" class="anchor"></span><span id="line-52" class="anchor"></span><p>If it doesn't display "CGI scripts work", well, then CGI scripts don't work. If it doesn't show one or more Python version numbers, then Python is not correctly installed. In both cases, before you can proceed, you will have to get in touch with the administrator of the server so that the problems get corrected. <span id="line-53" class="anchor"></span></p> 135 <span id="line-51" class="anchor"></span><span id="line-52" class="anchor"></span><p>If it doesn't display "CGI scripts work", well, then CGI scripts don't work. If it doesn't show one or more Python version numbers, then Python is not correctly installed. In both cases, before you can proceed, you will have to get in touch with the administrator of the server so that the problems get corrected. <span id="line-53" class="anchor"></span></p>
136 <span id="line-54" class="anchor"></span><p>Also be sure to read <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheOnLinuxFtp">../ApacheOnLinuxFtp</a> after you've completed the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> illustrated here. <span id="line-55" class="anchor"></span></p> 136 <span id="line-54" class="anchor"></span><p>Also be sure to read <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheOnLinuxFtp">../ApacheOnLinuxFtp</a> after you've completed the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> illustrated here. <span id="line-55" class="anchor"></span></p>
137 <span id="line-56" class="anchor"></span> 137 <span id="line-56" class="anchor"></span>
138 <h1 id="head-119b1acf8110bb618e4f366c3d1f8a35ad625f75">Download MoinMoin</h1> 138 <h1 id="head-119b1acf8110bb618e4f366c3d1f8a35ad625f75">Download MoinMoin</h1>
139 139
140 <span id="line-57" class="anchor"></span><span id="line-58" class="anchor"></span><p>To download the distribution archive, go to the <a class="www" href="http://sourceforge.net/project/showfiles.php?group_id=8482">download area</a> and fetch the latest archive. <span id="line-59" class="anchor"></span></p> 140 <span id="line-57" class="anchor"></span><span id="line-58" class="anchor"></span><p>To download the distribution archive, go to the <a class="http" href="http://sourceforge.net/project/showfiles.php?group_id=8482">download area</a> and fetch the latest archive. <span id="line-59" class="anchor"></span></p>
141 <span id="line-60" class="anchor"></span><p>The next step is to unpack the distribution archive (which you have done already if you are reading this text from your hard drive). If you read this on the web, the distribution comes in a versioned <tt>.tar.gz</tt> archive, which you can unpack as shown below. <span id="line-61" class="anchor"></span></p> 141 <span id="line-60" class="anchor"></span><p>The next step is to unpack the distribution archive (which you have done already if you are reading this text from your hard drive). If you read this on the web, the distribution comes in a versioned <tt>.tar.gz</tt> archive, which you can unpack as shown below. <span id="line-61" class="anchor"></span></p>
142 <span id="line-62" class="anchor"></span><ul> 142 <span id="line-62" class="anchor"></span><ul>
143 <li><p>On Windows <span id="line-63" class="anchor"></span></p> 143 <li><p>On Windows <span id="line-63" class="anchor"></span></p>
144 <ul> 144 <ul>
145 <li><p>You can use recent versions of programs like Win<tt></tt>Zip, Win<tt></tt>Rar, and Win<tt></tt>Ace, which handle .tar.gz kind of archives. <span id="line-64" class="anchor"></span></p> 145 <li><p>You can use recent versions of programs like Win<tt></tt>Zip, Win<tt></tt>Rar, and Win<tt></tt>Ace, which handle .tar.gz kind of archives. <span id="line-64" class="anchor"></span></p>
146 </li> 146 </li>
147 <li><p>At the command prompt, you can use <a class="www" href="http://gnuwin32.sourceforge.net/packages/gzip.htm">GNU gzip</a> and <a class="www" href="http://gnuwin32.sourceforge.net/packages/tar.htm">GNU tar</a> for Windows. <span id="line-65" class="anchor"></span></p> 147 <li><p>At the command prompt, you can use <a class="http" href="http://gnuwin32.sourceforge.net/packages/gzip.htm">GNU gzip</a> and <a class="http" href="http://gnuwin32.sourceforge.net/packages/tar.htm">GNU tar</a> for Windows. <span id="line-65" class="anchor"></span></p>
148 </li> 148 </li>
149 </ul> 149 </ul>
150 </li> 150 </li>
151 <li><p>On Linux <span id="line-66" class="anchor"></span></p> 151 <li><p>On Linux <span id="line-66" class="anchor"></span></p>
152 <ul> 152 <ul>
743 </ol> 743 </ol>
744 <p> <span id="line-10" class="anchor"></span></p> 744 <p> <span id="line-10" class="anchor"></span></p>
745 <span id="line-11" class="anchor"></span> 745 <span id="line-11" class="anchor"></span>
746 <h1 id="head-4e6235e8e3535359b4aa9df9722961dfd62a685a">Why Use mod_python</h1> 746 <h1 id="head-4e6235e8e3535359b4aa9df9722961dfd62a685a">Why Use mod_python</h1>
747 747
748 <span id="line-12" class="anchor"></span><span id="line-13" class="anchor"></span><p><a class="www" href="http://modpython.org/">mod_python</a> embeds the python interpreter into <span id="line-14" class="anchor"></span>the apache server. This saves initialization time and the need of <span id="line-15" class="anchor"></span>forking cgi scripts. It doesn't have the ability to run as different <span id="line-16" class="anchor"></span>users. It will always run as the main apache user and group. Be sure <span id="line-17" class="anchor"></span>that your wiki data files are accessible and writable by your apache <span id="line-18" class="anchor"></span>server. <span id="line-19" class="anchor"></span></p> 748 <span id="line-12" class="anchor"></span><span id="line-13" class="anchor"></span><p><a class="http" href="http://modpython.org/">mod_python</a> embeds the python interpreter into <span id="line-14" class="anchor"></span>the apache server. This saves initialization time and the need of <span id="line-15" class="anchor"></span>forking cgi scripts. It doesn't have the ability to run as different <span id="line-16" class="anchor"></span>users. It will always run as the main apache user and group. Be sure <span id="line-17" class="anchor"></span>that your wiki data files are accessible and writable by your apache <span id="line-18" class="anchor"></span>server. <span id="line-19" class="anchor"></span></p>
749 <span id="line-20" class="anchor"></span><p><img src="wiki/htdocs/modern/img/attention.png" alt="&lt;!&gt;" height="15" width="15"> The basic configuration is suitable for mod_python 3.1.3 and later. If you use older version, see the section "Older mod_python versions" <span id="line-21" class="anchor"></span></p> 749 <span id="line-20" class="anchor"></span><p><img src="wiki/htdocs/modern/img/attention.png" alt="&lt;!&gt;" height="15" width="15"> The basic configuration is suitable for mod_python 3.1.3 and later. If you use older version, see the section "Older mod_python versions" <span id="line-21" class="anchor"></span></p>
750 <span id="line-22" class="anchor"></span><p><img src="wiki/htdocs/modern/img/attention.png" alt="&lt;!&gt;" height="15" width="15"> mod_python will cause your apache processes to increase their <span id="line-23" class="anchor"></span>memory requirements considerably - especially as apache runs many <span id="line-24" class="anchor"></span>separate processes which will each need to have their own copy of the <span id="line-25" class="anchor"></span>python code and data in the process memory space. You may find that <span id="line-26" class="anchor"></span>FastCGI, as detailed in <a class="nonexistent" href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheWithFastCgi">HelpOnInstalling/ApacheWithFastCgi</a> is rather <span id="line-27" class="anchor"></span>more efficient in this respect. <span id="line-28" class="anchor"></span></p> 750 <span id="line-22" class="anchor"></span><p><img src="wiki/htdocs/modern/img/attention.png" alt="&lt;!&gt;" height="15" width="15"> mod_python will cause your apache processes to increase their <span id="line-23" class="anchor"></span>memory requirements considerably - especially as apache runs many <span id="line-24" class="anchor"></span>separate processes which will each need to have their own copy of the <span id="line-25" class="anchor"></span>python code and data in the process memory space. You may find that <span id="line-26" class="anchor"></span>FastCGI, as detailed in <a class="nonexistent" href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheWithFastCgi">HelpOnInstalling/ApacheWithFastCgi</a> is rather <span id="line-27" class="anchor"></span>more efficient in this respect. <span id="line-28" class="anchor"></span></p>
751 <span id="line-29" class="anchor"></span> 751 <span id="line-29" class="anchor"></span>
752 <h1 id="head-52f515a2448d32357136b23a188dd227330baeb2">Basic configuring</h1> 752 <h1 id="head-52f515a2448d32357136b23a188dd227330baeb2">Basic configuring</h1>
753 753
765 </ol> 765 </ol>
766 <p>The sample configurations below are for a wiki instance called <tt>mywiki</tt> installed in a directory <tt>/var/www/moin/mywiki</tt> with the main <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> installation installed in python's default site library path. The wiki appears as URL <tt>/mywiki</tt> under the server - ie <tt>http://my.ser.ver/mywiki</tt>. You will need to change these to reflect your installation. <span id="line-38" class="anchor"></span></p> 766 <p>The sample configurations below are for a wiki instance called <tt>mywiki</tt> installed in a directory <tt>/var/www/moin/mywiki</tt> with the main <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> installation installed in python's default site library path. The wiki appears as URL <tt>/mywiki</tt> under the server - ie <tt>http://my.ser.ver/mywiki</tt>. You will need to change these to reflect your installation. <span id="line-38" class="anchor"></span></p>
767 <span id="line-39" class="anchor"></span> 767 <span id="line-39" class="anchor"></span>
768 <h2 id="head-8cd6758d1fcc77b433f6584bcc34e24469568d75">Install mod_python</h2> 768 <h2 id="head-8cd6758d1fcc77b433f6584bcc34e24469568d75">Install mod_python</h2>
769 769
770 <span id="line-40" class="anchor"></span><span id="line-41" class="anchor"></span><p>Most people will just add a <tt>mod_python</tt> package to their current operating system installation. If you are building from source then you should consult the <a class="www" href="http://modpython.org/live/current/doc-html/">mod_python documentation</a>. <span id="line-42" class="anchor"></span></p> 770 <span id="line-40" class="anchor"></span><span id="line-41" class="anchor"></span><p>Most people will just add a <tt>mod_python</tt> package to their current operating system installation. If you are building from source then you should consult the <a class="http" href="http://modpython.org/live/current/doc-html/">mod_python documentation</a>. <span id="line-42" class="anchor"></span></p>
771 <span id="line-43" class="anchor"></span><p>The mod_python installation should have added some lines to the Apache configuration file - either in the file itself or in an included configuration file (for example on Red Hat or Fedora linux the mod_python configuration is in <tt>/etc/httpd/conf.d/python.conf</tt>). <span id="line-44" class="anchor"></span></p> 771 <span id="line-43" class="anchor"></span><p>The mod_python installation should have added some lines to the Apache configuration file - either in the file itself or in an included configuration file (for example on Red Hat or Fedora linux the mod_python configuration is in <tt>/etc/httpd/conf.d/python.conf</tt>). <span id="line-44" class="anchor"></span></p>
772 <span id="line-45" class="anchor"></span><p>Make sure you have this line in <tt>httpd.conf</tt> or mod_python will not work: <span id="line-46" class="anchor"></span> 772 <span id="line-45" class="anchor"></span><p>Make sure you have this line in <tt>httpd.conf</tt> or mod_python will not work: <span id="line-46" class="anchor"></span>
773 <span id="line-47" class="anchor"></span></p> 773 <span id="line-47" class="anchor"></span></p>
774 <pre> 774 <pre>
775 LoadModule python_module modules/mod_python.so 775 LoadModule python_module modules/mod_python.so
836 <span id="line-101" class="anchor"></span> # Add the path of your wiki directory 836 <span id="line-101" class="anchor"></span> # Add the path of your wiki directory
837 <span id="line-102" class="anchor"></span> PythonPath "['/var/www/moin/mywiki'] + sys.path" 837 <span id="line-102" class="anchor"></span> PythonPath "['/var/www/moin/mywiki'] + sys.path"
838 <span id="line-103" class="anchor"></span> PythonHandler MoinMoin.request::RequestModPy.run 838 <span id="line-103" class="anchor"></span> PythonHandler MoinMoin.request::RequestModPy.run
839 <span id="line-104" class="anchor"></span>&lt;/Location&gt; 839 <span id="line-104" class="anchor"></span>&lt;/Location&gt;
840 <span id="line-105" class="anchor"></span></pre> 840 <span id="line-105" class="anchor"></span></pre>
841 <span id="line-106" class="anchor"></span><span id="line-107" class="anchor"></span><p>If you have multiple <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> instances then add one location directive for each one (changing the paths as appropriate) and add a line with the directive <tt>PythonInterpreter&nbsp;mywiki</tt> to each Location section. With this directive different subinterpreters with completely separate namespaces will be used for each wiki (see <a class="www" href="http://modpython.org/live/current/doc-html/pyapi-interps.html">here</a> for details). <span id="line-108" class="anchor"></span></p> 841 <span id="line-106" class="anchor"></span><span id="line-107" class="anchor"></span><p>If you have multiple <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> instances then add one location directive for each one (changing the paths as appropriate) and add a line with the directive <tt>PythonInterpreter&nbsp;mywiki</tt> to each Location section. With this directive different subinterpreters with completely separate namespaces will be used for each wiki (see <a class="http" href="http://modpython.org/live/current/doc-html/pyapi-interps.html">here</a> for details). <span id="line-108" class="anchor"></span></p>
842 <span id="line-109" class="anchor"></span><p>If you did not install <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> in the default location, you will have to add the path to <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> to the system path: <span id="line-110" class="anchor"></span> 842 <span id="line-109" class="anchor"></span><p>If you did not install <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> in the default location, you will have to add the path to <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> to the system path: <span id="line-110" class="anchor"></span>
843 <span id="line-111" class="anchor"></span></p> 843 <span id="line-111" class="anchor"></span></p>
844 <pre> 844 <pre>
845 PythonPath "['/var/www/moin/mywiki', '/prefix/lib/python2.x/site-packages'] + sys.path" 845 PythonPath "['/var/www/moin/mywiki', '/prefix/lib/python2.x/site-packages'] + sys.path"
846 <span id="line-112" class="anchor"></span></pre> 846 <span id="line-112" class="anchor"></span></pre>
956 956
957 <div lang="en" id="Include_HelpOnInstalling/TwistedWeb" dir="ltr"> 957 <div lang="en" id="Include_HelpOnInstalling/TwistedWeb" dir="ltr">
958 <span id="top_Include_HelpOnInstalling/TwistedWeb" class="anchor"></span><span id="line-8" class="anchor"></span><span id="line-9" class="anchor"></span> 958 <span id="top_Include_HelpOnInstalling/TwistedWeb" class="anchor"></span><span id="line-8" class="anchor"></span><span id="line-9" class="anchor"></span>
959 <h1 id="head-aadc9ea90352d5b5ad5745583f12238abc07f6b1">Using MoinMoin with Twisted</h1> 959 <h1 id="head-aadc9ea90352d5b5ad5745583f12238abc07f6b1">Using MoinMoin with Twisted</h1>
960 960
961 <span id="line-10" class="anchor"></span><span id="line-11" class="anchor"></span><p><a class="www" href="http://twistedmatrix.com">Twisted</a> is a standalone python framework for many kinds of applications. <span id="line-12" class="anchor"></span>For <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>, we use Twisted as a python web server that just imports <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> persistently. <span id="line-13" class="anchor"></span></p> 961 <span id="line-10" class="anchor"></span><span id="line-11" class="anchor"></span><p><a class="http" href="http://twistedmatrix.com">Twisted</a> is a standalone python framework for many kinds of applications. <span id="line-12" class="anchor"></span>For <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>, we use Twisted as a python web server that just imports <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> persistently. <span id="line-13" class="anchor"></span></p>
962 <span id="line-14" class="anchor"></span><p>This has the advantage that the Python interpreter and all Python scripts (including Twisted itself and also <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>) is only loaded and initialized one time, and that data can be cached in memory from request to request, enhancing the performance of <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>. <span id="line-15" class="anchor"></span></p> 962 <span id="line-14" class="anchor"></span><p>This has the advantage that the Python interpreter and all Python scripts (including Twisted itself and also <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>) is only loaded and initialized one time, and that data can be cached in memory from request to request, enhancing the performance of <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>. <span id="line-15" class="anchor"></span></p>
963 <span id="line-16" class="anchor"></span><p>Another advantage is that this is all based on Python. <img src="wiki/htdocs/modern/img/smile4.png" alt=";)" height="15" width="15"> <span id="line-17" class="anchor"></span></p> 963 <span id="line-16" class="anchor"></span><p>Another advantage is that this is all based on Python. <img src="wiki/htdocs/modern/img/smile4.png" alt=";)" height="15" width="15"> <span id="line-17" class="anchor"></span></p>
964 <span id="line-18" class="anchor"></span><p>First do <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> and <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a>. <span id="line-19" class="anchor"></span></p> 964 <span id="line-18" class="anchor"></span><p>First do <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> and <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a>. <span id="line-19" class="anchor"></span></p>
965 <span id="line-20" class="anchor"></span> 965 <span id="line-20" class="anchor"></span>
966 <h2 id="head-781019b7b4433e2b39a07387d381c1ca28eb9134">Install Twisted</h2> 966 <h2 id="head-781019b7b4433e2b39a07387d381c1ca28eb9134">Install Twisted</h2>
1511 <h2 id="head-eb585ff24f9cd4b445a74b848cd1c5ec2b10706a">Testing Your New Wiki</h2> 1511 <h2 id="head-eb585ff24f9cd4b445a74b848cd1c5ec2b10706a">Testing Your New Wiki</h2>
1512 1512
1513 <span id="line-113" class="anchor"></span><span id="line-114" class="anchor"></span><p>In a web-browser surf to the site: <a class="http" href="http://localhost/mywiki">http://localhost/mywiki</a> <span id="line-115" class="anchor"></span></p> 1513 <span id="line-113" class="anchor"></span><span id="line-114" class="anchor"></span><p>In a web-browser surf to the site: <a class="http" href="http://localhost/mywiki">http://localhost/mywiki</a> <span id="line-115" class="anchor"></span></p>
1514 <span id="line-116" class="anchor"></span><p>You should see the FrontPage of your new wiki. <span id="line-117" class="anchor"></span></p> 1514 <span id="line-116" class="anchor"></span><p>You should see the FrontPage of your new wiki. <span id="line-117" class="anchor"></span></p>
1515 <span id="line-118" class="anchor"></span><p>Now run the unit tests, to make sure everything is fine. Go to this address: <a class="http" href="http://localhost/mywiki?action=test">http://localhost/mywiki?action=test</a> <span id="line-119" class="anchor"></span></p> 1515 <span id="line-118" class="anchor"></span><p>Now run the unit tests, to make sure everything is fine. Go to this address: <a class="http" href="http://localhost/mywiki?action=test">http://localhost/mywiki?action=test</a> <span id="line-119" class="anchor"></span></p>
1516 <span id="line-120" class="anchor"></span><p>You should see a report on the wiki and tests results for the <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> engine. If some of the tests fail, please report the problem on <a class="www" href="http://moinmoin.wikiwikiweb.de/MoinMoinBugs">MoinMoinBugs</a>. <span id="line-121" class="anchor"></span></p> 1516 <span id="line-120" class="anchor"></span><p>You should see a report on the wiki and tests results for the <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> engine. If some of the tests fail, please report the problem on <a class="http" href="http://moinmoin.wikiwikiweb.de/MoinMoinBugs">MoinMoinBugs</a>. <span id="line-121" class="anchor"></span></p>
1517 <span id="line-122" class="anchor"></span> 1517 <span id="line-122" class="anchor"></span>
1518 <h2 id="head-14a0f4b701dc07823ca965841351a2bd3d021b8e">Configuring Your wiki</h2> 1518 <h2 id="head-14a0f4b701dc07823ca965841351a2bd3d021b8e">Configuring Your wiki</h2>
1519 1519
1520 <span id="line-123" class="anchor"></span><span id="line-124" class="anchor"></span><p>The wiki you created is a new "Untitled Wiki", using the default configuration. You want to give a better name and setup some configuration values. Open <tt>wikiconfig.py</tt> and read the comments. You can edit the file with any text editor, like pico, emacs, or BBEdit. <span id="line-125" class="anchor"></span></p> 1520 <span id="line-123" class="anchor"></span><span id="line-124" class="anchor"></span><p>The wiki you created is a new "Untitled Wiki", using the default configuration. You want to give a better name and setup some configuration values. Open <tt>wikiconfig.py</tt> and read the comments. You can edit the file with any text editor, like pico, emacs, or BBEdit. <span id="line-125" class="anchor"></span></p>
1521 <span id="line-126" class="anchor"></span><ul> 1521 <span id="line-126" class="anchor"></span><ul>
1839 </ul> 1839 </ul>
1840 <p>Make sure that your webserver runs without problems before you start to install Moin<tt></tt>Moin; problems with your webserver installation are not in the scope of this document. <span id="line-38" class="anchor"></span></p> 1840 <p>Make sure that your webserver runs without problems before you start to install Moin<tt></tt>Moin; problems with your webserver installation are not in the scope of this document. <span id="line-38" class="anchor"></span></p>
1841 <span id="line-39" class="anchor"></span> 1841 <span id="line-39" class="anchor"></span>
1842 <h3 id="head-124918b94fdd224ff1d6bfff86c7525168676c98">Installing Python</h3> 1842 <h3 id="head-124918b94fdd224ff1d6bfff86c7525168676c98">Installing Python</h3>
1843 1843
1844 <span id="line-40" class="anchor"></span><span id="line-41" class="anchor"></span><p>Download <a class="www" href="http://www.python.org/ftp/python/2.3.4/Python-2.3.4.exe">Python 2.3.4</a> and install it. Python installation is done via a standard Windows installer program. <span id="line-42" class="anchor"></span></p> 1844 <span id="line-40" class="anchor"></span><span id="line-41" class="anchor"></span><p>Download <a class="http" href="http://www.python.org/ftp/python/2.3.4/Python-2.3.4.exe">Python 2.3.4</a> and install it. Python installation is done via a standard Windows installer program. <span id="line-42" class="anchor"></span></p>
1845 <span id="line-43" class="anchor"></span><p>Alternatively, you may download the <a class="www" href="http://www.activestate.com/Products/ActivePython/">ActivePython distribution</a> as a Microsoft Installer package. <span id="line-44" class="anchor"></span></p> 1845 <span id="line-43" class="anchor"></span><p>Alternatively, you may download the <a class="http" href="http://www.activestate.com/Products/ActivePython/">ActivePython distribution</a> as a Microsoft Installer package. <span id="line-44" class="anchor"></span></p>
1846 <span id="line-45" class="anchor"></span> 1846 <span id="line-45" class="anchor"></span>
1847 <h3 id="head-a1cff6121b8b9ce2a1b1d94e923ae54f0b89ce4c">Installing MoinMoin</h3> 1847 <h3 id="head-a1cff6121b8b9ce2a1b1d94e923ae54f0b89ce4c">Installing MoinMoin</h3>
1848 1848
1849 <span id="line-46" class="anchor"></span><span id="line-47" class="anchor"></span><p>Before creating a wiki instance, you have to download and install the basic Moin<tt></tt>Moin software. We assume you already have downloaded the distribution archive to the "<tt>C:\TEMP</tt>" directory. <span id="line-48" class="anchor"></span></p> 1849 <span id="line-46" class="anchor"></span><span id="line-47" class="anchor"></span><p>Before creating a wiki instance, you have to download and install the basic Moin<tt></tt>Moin software. We assume you already have downloaded the distribution archive to the "<tt>C:\TEMP</tt>" directory. <span id="line-48" class="anchor"></span></p>
1850 <span id="line-49" class="anchor"></span><p>Open a console window and enter the following commands: <span id="line-50" class="anchor"></span> 1850 <span id="line-49" class="anchor"></span><p>Open a console window and enter the following commands: <span id="line-50" class="anchor"></span>
2150 <span id="line-118" class="anchor"></span><span id="bottom_Include_HelpOnInstalling/TroubleShooting" class="anchor"></span> 2150 <span id="line-118" class="anchor"></span><span id="bottom_Include_HelpOnInstalling/TroubleShooting" class="anchor"></span>
2151 </div> 2151 </div>
2152 <span id="line-78" class="anchor"></span></p> 2152 <span id="line-78" class="anchor"></span></p>
2153 <span id="bottom" class="anchor"></span> 2153 <span id="bottom" class="anchor"></span>
2154 </div> 2154 </div>
2155 <p id="pageinfo" class="info" lang="en" dir="ltr">last edited 2006-01-01 23:26:52 by <span title="??? @ localhost[127.0.0.1]">localhost</span></p> 2155 <p id="pageinfo" class="info" lang="en" dir="ltr">MoinMaster: MoinMoin/InstallDocs (last edited 2006-01-01 23:26:52 by <span title="??? @ localhost[127.0.0.1]">localhost</span>)</p>
2156 <div id="pagebottom"></div> 2156 <div id="pagebottom"></div>
2157 </div> 2157 </div>
2158 </body> 2158 </body>
2159 </html> 2159 </html>
2160 2160