annotate docs/INSTALL.html @ 196:d0250ed0cd53

make interwiki underlay install-docs imported from: moin--main--1.5--patch-198
author Thomas Waldmann <tw@waldmann-edv.de>
date Sat, 05 Nov 2005 21:26:59 +0000
parents 6ddcb13c0f4e
children 345d0228a0bd
rev   line source
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
2 <html>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
3 <head>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
4 <link rel="shortcut icon" href="http://moinmaster.wikiwikiweb.de/wiki/favicon.ico">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
5 <meta http-equiv="Content-Type" content="text/html;charset=utf-8">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
6 <meta name="robots" content="noindex,nofollow">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
7
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
8 <title>MoinMoin/InstallDocs - MoinMaster</title>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
9 <script type="text/javascript" src="/wiki/common/js/common.js"></script>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
10
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
11
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
12 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="wiki/htdocs/modern/css/common.css">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
13 <link rel="stylesheet" type="text/css" charset="utf-8" media="all" href="wiki/htdocs/modern/css/print.css">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
14 <link rel="alternate" title="MoinMaster Recent Changes" href="http://moinmaster.wikiwikiweb.de/RecentChanges?action=rss_rc&amp;ddiffs=1&amp;unique=1" type="application/rss+xml">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
15
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
16 <link rel="Start" href="http://moinmaster.wikiwikiweb.de/FrontPage">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
17 <link rel="Alternate" title="Wiki Markup" href="http://moinmaster.wikiwikiweb.de/MoinMoin/InstallDocs?action=raw">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
18 <link rel="Alternate" media="print" title="Print View" href="http://moinmaster.wikiwikiweb.de/MoinMoin/InstallDocs?action=print">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
19 <link rel="Up" href="http://moinmaster.wikiwikiweb.de/MoinMoin">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
20 <link rel="Search" href="http://moinmaster.wikiwikiweb.de/FindPage">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
21 <link rel="Index" href="http://moinmaster.wikiwikiweb.de/TitleIndex">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
22 <link rel="Glossary" href="http://moinmaster.wikiwikiweb.de/WordIndex">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
23 <link rel="Help" href="http://moinmaster.wikiwikiweb.de/HelpOnFormatting">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
24 </head>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
25
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
26 <body lang="en" dir="ltr">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
27 <div id="page" lang="en" dir="ltr">
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
28 <div id="interwiki"><span><a href="http://moinmaster.wikiwikiweb.de/FrontPage">MoinMaster</a></span></div>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
29 <ul id="pagelocation">
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
30 <li>MoinMoin/InstallDocs</li>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
31 </ul>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
32 <div lang="en" id="content" dir="ltr">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
33 <a id="top"></a><p>This HTML page contains the basic install docs that can be found on <a href="http://moinmaster.wikiwikiweb.de/MoinMoin/InstallDocs"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> http://moinmaster.wikiwikiweb.de/MoinMoin/InstallDocs</a>. It contains all necessary information to get your wiki up and running, even without being online. If you have a permanent internet connection, you might want to browse the docs on the HelpOnInstalling page, which might contain more up-to-date information. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
34 <p>After following the procedures on this page, you should have a working wiki and can browse the rest of the online docs there. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
35
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
36 <h1 id="head-378d73a512870e1afed036c887489ab98ba3c56a">How to install your own MoinMoin Wiki</h2>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
37
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
38 <p>This page describes the installation procedure of <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>. In the next section, there is a list of real-world <a href="#installscenarios">Installation Scenarios</a> that help you to understand how to apply the instructions in different environments. If you already have a wiki running and want to upgrade, see <a class="interwiki" title="MoinMaster" href="http://moinmaster.wikiwikiweb.de/HelpOnUpdating"><img src="wiki/htdocs/modern/img/moin-inter.png" alt="[MoinMaster]" height="16" width="16">HelpOnUpdating</a>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
39 <p>A MoinMoin installation is done by some elementary steps: </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
40 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
41 <li><p> <a href="#basic-install">Basic Installation</a> explains the "<tt>setup.py</tt>" step of the installation in more detail. This is uses to get the MoinMoin code and wiki template installed onto your system. This applies equally to all scenarios, and you should read it before trying a live installation. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
42 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
43 <li><p> <a href="#wikiinstance-creation">Wiki Instance Creation</a> explains how you make a new wiki instance (data and configuration), this is also common to all scenarios. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
44 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
45 <li><p> Getting the web server to serve static stuff under the <tt>/wiki</tt> URL (url_prefix) - used for theme CSS and images, etc. - this is slightly different for the various web servers that can be used - see below. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
46 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
47 <li><p> Getting the web server to execute the moin code when you access wiki pages. This is done either by CGI, FastCGI, mod_python or Twisted or the built-in stand alone server - this is slightly different for the various web servers that can be used - see below. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
48 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
49 <li><p> After a successful installation, you might want to read more about configuration and other options that you, as the wiki administrator, can set up. <a class="interwiki" title="MoinMaster" href="http://moinmaster.wikiwikiweb.de/HelpOnAdministration"><img src="wiki/htdocs/modern/img/moin-inter.png" alt="[MoinMaster]" height="16" width="16">HelpOnAdministration</a> contains links to pages that cover these topics. Especially, the <a class="interwiki" title="MoinMaster" href="http://moinmaster.wikiwikiweb.de/HelpOnConfiguration"><img src="wiki/htdocs/modern/img/moin-inter.png" alt="[MoinMaster]" height="16" width="16">HelpOnConfiguration</a> and <a class="interwiki" title="MoinMaster" href="http://moinmaster.wikiwikiweb.de/HelpOnUpdating"><img src="wiki/htdocs/modern/img/moin-inter.png" alt="[MoinMaster]" height="16" width="16">HelpOnUpdating</a> pages provide additional information regarding wiki setup and maintenance. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
50 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
51 <li><p> <a href="#trouble-shooting">Trouble-shooting</a> helps with fixing any general problems you might encounter, which apply to any installation platform. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
52 </li>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
53 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
54 <a id="installscenarios"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
55 <p> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
56
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
57 <h1 id="head-bee4ae5a5ef44b7af47ecd4f29b44226ba935e5b">Installation steps specific for some web servers and operating systems</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
58
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
59 <p>The following links will show you concrete examples of installation sessions, showing the commands used and explaining what they do. You <em>must first read the general information on installing above</em> before doing the installation steps described on the pages linked from below: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
60 <p>Linux: </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
61 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
62 <li><p> <a href="#linuxapache-install">Linux Installation using Apache</a> </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
63 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
64 <li><p> <a href="#linuxstandalone-install">Linux Installation using standalone server</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
65 </li>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
66 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
67 <p>Long-Running-Process Setup: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
68 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
69 <li><p> <a href="#fastcgi-install">FastCGI Setup using Apache</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
70 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
71 <li><p> <a href="#modpy-install">mod_python Setup using Apache</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
72 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
73 <li><p> <a href="#twisted-install">Setup using twisted</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
74 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
75 </ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
76 <p>Mac OS X: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
77 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
78 <li><p> <a href="#macosx-install">Mac OS X Installation</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
79 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
80 </ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
81 <p>Windows: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
82 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
83 <li><p> <a href="#win32apache-install">Windows Installation using Apache</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
84 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
85 <li><p> <a href="#win32iis-install">Windows Installation using IIS</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
86 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
87 </ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
88 <a id="basic-install"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
89 <p> <div lang="en" id="Include_HelpOnInstalling/BasicInstallation" dir="ltr">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
90 <a id="top_Include_HelpOnInstalling/BasicInstallation"></a><p><strong>How to do a basic installation of <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> on your system.</strong> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
91 <p><strong>Contents</strong> <ol>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
92 <li><a href="#head-2fa431ad9c9bff5badd07c5ee676b19852ed28e3">Check if Python is working</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
93 <li><a href="#head-119b1acf8110bb618e4f366c3d1f8a35ad625f75">Download MoinMoin</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
94 <li><a href="#head-a84e58c8b4256bd645b9c47b5a900219a356259f">Install MoinMoin</a><ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
95 <li><a href="#head-640b21abea127e7ac4b48c938607c233b7119bd5">Installing in the default system location</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
96 <li><a href="#head-ae8ab55eb5e8c11d4fd1eb06e12d69f1b33d411b">Installing in the home directory or another specific location</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
97 </ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
98 <li><a href="#head-d7d600c8dcfdd9270f4a6642566404ede510f46a">Test installation</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
99 <li><a href="#head-87a60f1d02c36fb1804b442815dba49cbc8adfe7">What has been installed</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
100 </ol>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
101 </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
102 <p>Before you can integrate MoinMoin 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="external" href="http://www.python.org/doc/current/inst/inst.html"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> Installing Python Modules</a> document in your Python documentation set. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
103 <p>The installation is similar on Windows and Linux (and other POSIX-type systems; for simplicity, we just say "Linux" in the docs). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
104 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
105 <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. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
106 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
107 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
108
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
109 <h1 id="head-2fa431ad9c9bff5badd07c5ee676b19852ed28e3">Check if Python is working</h2>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
110
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
111 <p>MoinMoin 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. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
112 <p>The <tt>CHANGES</tt> file in the MoinMoin archive mentions what versions are supported. Python 2.3 is the minimum requirement for MoinMoin 1.5, but we suggest you use the latest Python release version. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
113 <p>You can download Python at <a class="external" href="http://www.python.org/download/"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> http://www.python.org/download/</a>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
114 <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. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
115 <p>If you have shell access, checking if Python is working is very simple. Just type the following command, and look at the result:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
116 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
117 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
118 &gt; python -V
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
119 Python 2.3.4
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
120 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
121 <p>If you don't have shell access, you can try using this <tt>pythontest.cgi</tt> script (it assumes that you are using a Linux kind of webserver). Upload the script to your <tt>cgi-bin</tt> directory, use <tt>chmod&nbsp;a+rx&nbsp;pythontest.cgi</tt> (or a similar command in your FTP program) to make it executable, and invoke it using your web browser.
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
122 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
123 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
124 #!/bin/sh
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
125 echo Content-Type: text/plain
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
126 echo
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
127 echo "Your web server is running as:"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
128 id
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
129 echo "CGI scripts work"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
130 echo "Now we try to invoke Python interpreters and get their versions:"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
131 python -V 2&gt;&amp;1
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
132 python2.3 -V 2&gt;&amp;1
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
133 python2.4 -V 2&gt;&amp;1
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
134 echo "Finished."
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
135 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
136 <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. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
137 <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. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
138
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
139 <h1 id="head-119b1acf8110bb618e4f366c3d1f8a35ad625f75">Download MoinMoin</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
140
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
141 <p>To download the distribution archive, go to the <a class="external" href="http://sourceforge.net/project/showfiles.php?group_id=8482"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> download area</a> and fetch the latest archive. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
142 <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. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
143 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
144 <li><p> On Windows </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
145 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
146 <li><p> You can use recent versions of programs like WinZip, WinRar, and WinAce, which handle .tar.gz kind of archives. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
147 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
148 <li><p> At the command prompt, you can use <a class="external" href="http://gnuwin32.sourceforge.net/packages/gzip.htm"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> GNU gzip</a> and <a class="external" href="http://gnuwin32.sourceforge.net/packages/tar.htm"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> GNU tar</a> for Windows. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
149 </li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
150 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
151 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
152 <li><p> On Linux </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
153 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
154 <li><p> You can use your favorite file manager -- it should be able to unpack them. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
155 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
156 <li><p> At any shell prompt, you can use the <tt>tar</tt> command. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
157 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
158 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
159 </li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
160 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
161 <p>The distribution archive will always unpack into a directory named <tt>moin-&lt;version&gt;</tt>, for example <tt>moin-1.5</tt>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
162 <p>Here is how you would unpack the archive (using GNU tar) and enter the directory with the MoinMoin files:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
163 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
164 <pre>
137
cfbecd3400d3 make install-docs, intermap, underlay, ...
Thomas Waldmann <tw@waldmann-edv.de>
parents: 0
diff changeset
165 &gt; tar xzf moin-1.5.0.tar.gz
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
166 &gt; cd moin-1.5.0
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
167 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
168
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
169 <h1 id="head-a84e58c8b4256bd645b9c47b5a900219a356259f">Install MoinMoin</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
170
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
171 <p>You can install MoinMoin to either: </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
172 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
173 <li><p> a system location (if you have the necessary rights to do that -- on Linux you need to be root) </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
174 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
175 <li><p> some specific location, like your home directory (Linux) or <tt>C:\moin</tt> (Windows). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
176 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
177 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
178 <p>The installation to a system location is easier, so choose that if possible. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
179 <p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> If you have several versions of Python installed, please use the same version for setup and for running the wiki. Usually, the latest Python version will get the best results. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
180 <p>If you have problems with the <tt>setup.py</tt> install step, try using the command:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
181 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
182 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
183 &gt; python -v setup.py --quiet install --record=install.log
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
184 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
185 <p>The additional <tt>-v</tt> flag should provide you detailed verbose messages every step of the way. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
186 <p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> On Linux, if u get an error like <tt>Invalid&nbsp;Python&nbsp;installation:&nbsp;cannot&nbsp;find&nbsp;/usr/lib/Python2.x/config/Makefile</tt>, you may not have the python module <strong><tt>distutils</tt></strong> installed, it's usually a part of the <strong>Python development libarary (<tt>python-dev</tt>)</strong>. Some Linux distributions may not have installed it by default. For example, on Mandrake you need to install the <strong><tt>python-devel</tt></strong> package, on Debian it's called <strong><tt>python-dev</tt></strong>. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
187
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
188 <h2 id="head-640b21abea127e7ac4b48c938607c233b7119bd5">Installing in the default system location</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
189
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
190
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
191 <pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
192 &gt; python setup.py --quiet install --record=install.log
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
193 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
194 <p>This installs MoinMoin to the default system location (typically the Python directory, for example on Linux, inside <tt>/usr/lib</tt> and <tt>/usr/share</tt>). Look at the <tt>install.log</tt> file to see what was installed, and where. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
195 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
196 <li><p> Mac OS X note: use the command:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
197 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
198 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
199 python setup.py install --install-data='/usr/local'
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
200 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
201 <p>This will install the shared files to '/usr/local/share/moin', instead of an inconvenient location in the System folder. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
202 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
203 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
204
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
205 <h2 id="head-ae8ab55eb5e8c11d4fd1eb06e12d69f1b33d411b">Installing in the home directory or another specific location</h3>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
206
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
207 <p>Linux example, installing in the home directory:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
208 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
209 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
210 &gt; python setup.py --quiet install --prefix=$HOME --record=install.log
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
211 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
212 <p>Windows example, installing in the <tt>C:\moin</tt> directory:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
213 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
214 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
215 &gt; python setup.py --quiet install --prefix="C:\moin" --record=install.log
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
216 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
217 <p>All MoinMoin files will then be installed inside those directories, see <tt>install.log</tt> to know which files were installed, and where. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
218 <p><strong>Note:</strong> You will likely see the following warning: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
219 <ul>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
220 <li style="list-style-type:none"><p><tt>warning:&nbsp;install:&nbsp;modules&nbsp;installed&nbsp;to&nbsp;'C:\moin\',&nbsp;which</tt><br>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
221 <tt>is&nbsp;not&nbsp;in&nbsp;Python's&nbsp;module&nbsp;search&nbsp;path&nbsp;(sys.path)&nbsp;--&nbsp;you'll</tt><br>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
222 <tt>have&nbsp;to&nbsp;change&nbsp;the&nbsp;search&nbsp;path&nbsp;yourself</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
223 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
224 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
225 <p>This means exactly what it says, you need to add your install directory to the search path of Python, or it won't find the MoinMoin code. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
226 <p>For example, if you are running using a webserver and standard CGI, edit <tt>moin.cgi</tt> and add your installation directory to the Python path, like this:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
227 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
228 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
229 import sys
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
230 sys.path.insert(0, 'C:/moin')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
231 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
232
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
233 <h1 id="head-d7d600c8dcfdd9270f4a6642566404ede510f46a">Test installation</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
234
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
235 <p>As a final step, if you have access to the shell or the command prompt, you can check that everything is correctly installed and ready to run. Start Python and type <tt>import&nbsp;MoinMoin</tt>. Nothing should be displayed in response to this command. Example: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
236
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
237 <pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
238 &gt; python
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
239 Python 2.3.4 (#1, May 29 2004, 17:05:23)
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
240 [GCC 3.3.3] on linux2
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
241 Type "help", "copyright", "credits" or "license" for more information.
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
242 &gt;&gt;&gt; import MoinMoin
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
243 &gt;&gt;&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
244 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
245 <p>If you get this instead: </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
246
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
247 <pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
248 &gt;&gt;&gt; import MoinMoin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
249 Traceback (most recent call last):
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
250 File "&lt;stdin&gt;", line 1, in ?
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
251 ImportError: No module named MoinMoin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
252 &gt;&gt;&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
253 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
254 <p>then you have to tune your installation. Try modifying <tt>sys.path</tt>, as described above. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
255
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
256 <h1 id="head-87a60f1d02c36fb1804b442815dba49cbc8adfe7">What has been installed</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
257
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
258 <p>So, you have a ready-to-work MoinMoin installation now. Congratulations! Before you go on to configuring it, take a look at the various files and directories that have been installed. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
259 <p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> It is important that you understand the different locations used in a MoinMoin setup, so read this carefully. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
260 <p>In the following descriptions, <tt>PREFIX</tt> is what you used with the <tt>setup.py</tt> command, or a default location if you didn't use the <tt>--prefix</tt> option. (Typical default values on Linux are <tt>/usr</tt> and <tt>/usr/local</tt>.) <tt>X.Y</tt> is the version of Python. Typically, this is <tt>2.3</tt> or <tt>2.4</tt>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
261 <p>Look into <tt>install.log</tt> to find out about following important locations: </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
262 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
263 <li><p> <strong><tt>MoinMoin</tt> directory</strong>, usually <tt>PREFIX/lib/pythonX.Y/site-packages/MoinMoin</tt> -- this is where the MoinMoin <strong>source code</strong> is located </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
264 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
265 <li><p> <strong><tt>share</tt> directory</strong>, usually <tt>PREFIX/share/moin</tt> - this is where the <em>templates</em> are located </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
266 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
267 <li><p> <strong><tt>data</tt></strong> directory (wiki pages, users, etc.) - only MoinMoin should access this </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
268 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
269 <li><p> <strong><tt>underlay</tt></strong> directory (wiki pages) - only MoinMoin should access this </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
270 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
271 <li><p> <strong><tt>htdocs</tt></strong> directory with html support files (images for the various themes, etc.) - the web server will need to access this </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
272 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
273 <li><p> <strong><tt>server</tt></strong> - MoinMoin example startup files (like <tt>moin.cgi</tt> for CGI, and other files for other startup methods) </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
274 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
275 <li><p> <strong><tt>config</tt></strong> - MoinMoin example configuration files (like <tt>wikiconfig.py</tt>) </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
276 </li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
277 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
278 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
279 <li><p> <strong><tt>bin</tt></strong> directory with some scripts that help you use the MoinMoin shell commands </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
280 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
281 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
282 <p>We talk of <em>templates</em> in the <tt>share</tt> directory because you usually will not use those files at that location, but copy them elsewhere when you need them. This way, you can set-up several wikis without problems, and easily upgrade to new MoinMoin versions. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
283 <a id="bottom_Include_HelpOnInstalling/BasicInstallation"></a>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
284 </div>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
285 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
286 <hr class="hr2">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
287 <p> <a id="wikiinstance-creation"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
288 <div lang="en" id="Include_HelpOnInstalling/WikiInstanceCreation" dir="ltr">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
289 <a id="top_Include_HelpOnInstalling/WikiInstanceCreation"></a><p>After you have downloaded and installed MoinMoin, you will want to "have a wiki". As explained at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a>, you have to copy several directories and files. This way, you can have as many wikis as you want, and you can easily upgrade MoinMoin: only the original files will be overwritten, not your copies. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
290 <p>Every time you copy those files (and modify the configuration of your server accordingly), you create what is called a <em>wiki instance</em>. Each wiki instance is independant from the others, with a different configuration, different pages, different users, etc. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
291 <p>Some of the steps you need to take depend on which web server and which operating system you use. They are described on dedicated pages, which you should read (at least the beginning) before reading this one. Some other steps are common to every webserver and operating system (copying files around, setting permissions), and this is what is described here. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
292
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
293 <h1 id="head-8c227c275465dec3f8e3b326d53f9566727c5648">Read this first</h2>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
294
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
295
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
296 <h2 id="head-6e91ed0b234e903763a945b5249e7de8b726e5d7">Security warnings</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
297
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
298 <div>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
299 <table style="color: red">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
300 <tr>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
301 <td>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
302 <p> <img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> <strong>Warning: make sure that your <tt>data</tt> directory and your configuration files are not accessible through your web server. Do not put your wiki directory in <tt>public_html</tt>, <tt>Sites</tt> or any other directory your web server can access. The web server only needs to access the file in the <tt>htdocs</tt> directory and the <tt>moin.cgi</tt> script! (Or whatever script your server uses to start MoinMoin.)</strong> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
303 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
304 </tr>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
305 </table>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
306 </div>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
307 <div>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
308 <table style="color: red">
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
309 <tr>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
310 <td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
311 <p> <img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> <strong>Warning: make sure that the <tt>data</tt> directory and its subdirectories are not readable and not writeable by users other than the web server user. If you need to give worldwide read-write permissions to get it working, be aware that you are doing a very unsecure setup, that can be compromised by any other user or program on your computer.</strong> </p>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
312 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
313 </tr>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
314 </table>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
315 </div>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
316
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
317 <h2 id="head-942d29849126a576afcc19bdbfd59c661739eb55">Note to Windows users</h3>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
318
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
319 <p>All the commands below are Linux commands. The text descriptions that introduce them should be enough to help you understand what you need to do. Use the Windows Explorer, or the appropriate text-mode commands. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
320
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
321 <h1 id="head-66ec28f32e6870e96f6062a4a6ac77bbb4606109">Choose a wiki name</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
322
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
323 <p>Choose a unique name for the new wiki instance you want to create. It should be a short word, something that reflects what you intend to use the wiki for, like the name of your organization, of your team, of the project you are working on, etc. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
324 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
325 <li style="list-style-type:none"><p><img src="wiki/htdocs/modern/img/attention.png" alt="&lt;!&gt;" height="15" width="15"> <strong>Do not use the name "wiki" - it is reserved for internal use. You would need a special setup to use this with CGI, and you can't use it at all with standalone or twisted server.</strong> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
326 </li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
327 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
328 <p>The name "<tt>mywiki</tt>" is used as an example in the various commands below. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
329
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
330 <h1 id="head-379ea73c819b2c729ba9c2432b8a4c4b4c524f71">Choose a location</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
331
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
332 <p>Choose a directory on your disk, it will contain all the files needed for your wiki instance. At the beginning, your wiki instance will use approximately 10 MB of disk space. Then of course, it will grow depending on the way your wiki is used. A personal wiki, even with many pages, might only use 30 MB or 40 MB of disk space. A popular wiki, or a wiki with many files attached to the pages, might use much more, of course. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
333 <p>If you are the administrator (or root) of the server, you can use anything you like or that makes sense to you, for example <tt>/usr/local/var/moin</tt>, <tt>/mnt/wikis</tt>, etc. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
334 <p>If you are a simple user, you will probably only be allowed to write in your personal, "home" directory. Choose a subdirectory that makes sense to you, for example the <tt>share/moin</tt> subdirectory. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
335
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
336 <h1 id="head-951584cdd82db21218fc2ffd3945de602f8275c0">Collect some important information</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
337
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
338 <p>This is where the instructions differ according to the web server and operating system you use, and whether you are the administrator or a simple user. See the appropriate pages for your web server and operating system combination. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
339 <p>On Linux, the <tt>export</tt> command will be used to remember the collected information. Windows users should write it down carefully (maybe cutting-and-pasting in a Notepad window), or store it in environment variables if they use the command prompt. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
340 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
341 <li><p> <tt>PREFIX</tt> is the prefix you used during the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
342 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
343 <li><p> <tt>SHARE</tt> is the name of the <tt>share</tt> directory, as discussed at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
344 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
345 <li><p> <tt>WIKILOCATION</tt> is the name of the directory that will contain your wiki instance </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
346 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
347 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
348 <p>If you are an administrator, you also need to collect the following: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
349 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
350 <li><p> <tt>USER</tt> is the user name of the web server </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
351 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
352 <li><p> <tt>GROUP</tt> is the name of the group to which the web server belongs </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
353 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
354 </ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
355 <p>Now, Linux folks, let's store these settings in memory:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
356 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
357 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
358 &gt; export PREFIX=/usr # this might be something else
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
359 &gt; export SHARE=$PREFIX/share/moin # this should be correct for most people
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
360 &gt; export WIKILOCATION=$SHARE # this is just an example
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
361 &gt; export INSTANCE=mywiki # this is just an example
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
362 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
363 <p>Administrators also need the following two lines: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
364
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
365 <pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
366 &gt; export USER=www-data # this is just an example
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
367 &gt; export GROUP=www-data # this is just an example
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
368 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
369
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
370 <h1 id="head-c3fc33e072973371ea739841440fb52175ddb9f6">Copy the files</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
371
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
372 <p>To create your new instance, you first need to create a directory named like your instance, inside the <tt>WIKILOCATION</tt>. Then you need to copy the <tt>data</tt> and <tt>underlay</tt> directories from your <tt>SHARE</tt> directory into your instance directory. Finally, you need to copy the <tt>wikiconfig.py</tt> file from the <tt>config</tt> directory into the instance directory. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
373 <p>Linux folks need just type these commands:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
374 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
375 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
376 &gt; cd $WIKILOCATION
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
377 &gt; mkdir $INSTANCE # make a directory for this instance
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
378 &gt; cp -R $SHARE/data $INSTANCE # copy template data directory
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
379 &gt; cp -R $SHARE/underlay $INSTANCE # copy underlay data directory
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
380 &gt; cp $SHARE/config/wikiconfig.py $INSTANCE # copy wiki configuration sample file
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
381 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
382 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
383 <li style="list-style-type:none"><p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> Note that you just need to keep one underlay directory on your system if you are running multiple wikis (e.g. in a farm.) </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
384 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
385 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
386
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
387 <h1 id="head-027e3666aea4dc02569ad386901ae9456bad5ae1">Set permissions</h2>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
388
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
389
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
390 <h2 id="head-3b8b040007c209e4621b176c8724b3bbcb755957">Administrators</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
391
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
392 <p>Administrators need to restrict the permissions of the files, so that only the web server (and the administrator of course) can read and write them. For maximum security, no other user on the machine should be able to read or write anything in the wiki instance directory. Don't forget that this directory contains sensitive information, notably the (encrypted) passwords of the wiki users. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
393 <p>On Linux, the following commands should be enough:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
394 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
395 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
396 &gt; chown -R $USER.$GROUP $INSTANCE # check that USER and GROUP are correct
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
397 &gt; chmod -R ug+rwX $INSTANCE # USER.GROUP may read and write
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
398 &gt; chmod -R o-rwx $INSTANCE # everybody else is rejected
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
399 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
400
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
401 <h2 id="head-19c5987edf26a8517fbf6cbee5ba5dd5f36ec280">Normal users</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
402
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
403 <p>Normal users, on the contrary, need to broaden the permissions of the files, so that the web server can read and write them. On recent Windows versions, and on some versions of Unix, Linux and other systems, <em>access control lists</em> can be used to that effect. They are, however, powerful and complicated, much beyond the scope of this document. Ask a knowledgeable person about them. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
404 <p>Without them, normal users have to allow <em>everybody</em> to access the instance directory. This is the only way the web server can enter it and do its work. This is, of course, <strong>VERY INSECURE</strong>, since any other user and program on the server can read the directory. You should <strong>not</strong> use such a setup for a wiki open to the public. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
405 <p>On Linux, the following commands will open the instance directory to the whole world:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
406 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
407 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
408 &gt; chmod -R a+rwX $INSTANCE
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
409 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
410 <p><strong>Note:</strong> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
411 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
412 <li><p> it is also possible to put the web server and the normal user in the same <em>group</em>, and then only open the instance directory to the members of that group. This is a bit more secure (depending on who else is in the group), but you need the cooperation of the server administrator; he is the one setting up groups. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
413 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
414 <li><p> the best other possibility is that the server administrator sets up <tt>suexec</tt> to execute CGI scripts in user directories under the user id of that user. You don't need to give world permissions that way, so it is a quite secure setup, but you also need cooperation of the administrator. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
415 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
416 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
417
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
418 <h1 id="head-442871161f523855f2162b426248f0bb0523c289">Tune configuration</h2>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
419
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
420 <p>Now, you need to tune the configuration of your web server and of your wiki instance. Look at the appropriate help page for your web server, then come back here to tune the settings of your wiki instance. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
421 <p>Edit <tt>wikiconfig.py</tt>. The default settings should work fine in most cases, but there are some things that you will probably want to change, like the name and logo of your wiki! <img src="wiki/htdocs/modern/img/smile.png" alt=":)" height="15" width="15"> Read the comments inside <tt>wikiconfig.py</tt>, they will guide you through this process. (Start with "Wiki identity", around line 25.) </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
422 <p><a href="http://moinmaster.wikiwikiweb.de/HelpOnConfiguration">HelpOnConfiguration</a> contains all the details about all the options, in case the comments in <tt>wikiconfig.py</tt> are not enough. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
423 <a id="bottom_Include_HelpOnInstalling/WikiInstanceCreation"></a>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
424 </div>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
425 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
426 <hr class="hr1">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
427 <p> <a id="linuxapache-install"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
428
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
429 <h1>Linux Installation using Apache</h1>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
430
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
431 <div lang="en" id="Include_HelpOnInstalling/ApacheOnLinux" dir="ltr">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
432 <a id="top_Include_HelpOnInstalling/ApacheOnLinux"></a><p>This page describes the particular steps that need to be taken to create a wiki instance using <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> on Linux with the Apache web server. <strong>You should have already performed the <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a>. </strong>Installations on other Unices like FreeBSD are very similar. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
433 <p>Two scenarios are possible. You might be the administrator (root) of the server, able to install and modify files almost anywhere on the machine, and notably able to modifiy the Apache configuration. You might also be a simple user, only able to write files into your home directory, and unable to alter the master Apache config file. The two scenarios are discussed below. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
434 <p><strong>Table of contents</strong> <ol>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
435 <li><a href="#head-5a61f5b0107edba120089e4251cd633be60b6e15">Administrator (root)</a><ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
436 <li><a href="#head-c27688fbe7f65d67190a47ce8d32eba244ab0d01">Create a wiki instance</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
437 <li><a href="#head-e3e9e08058bb0ae34c33f53367cd58d6c7411998">Install moin.cgi</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
438 <li><a href="#head-408a7a283b2406c4e6b24646b25ec7996d5ff459">Configure moin.cgi</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
439 <li><a href="#head-b02e2f66403a66cc3b1ff0ce2c7261cf44e4f0d4">Configure Apache</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
440 <li><a href="#head-ffa39b171f9d130bb07a8481a5fff1a5a9065e86">Configure MoinMoin</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
441 <li><a href="#head-0f7a0fb8dccf6a13b6042fa17e0d7cda751fe3f3">Test the wiki</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
442 <li><a href="#head-52920da3312438e6a484347d4dfaa369b86cb521">Apache tricks</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
443 </ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
444 <li><a href="#head-e559f024646d8751eee1135ad5423247d72ab7fd">Simple user (home directory installation)</a><ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
445 <li><a href="#head-6a39e2829f37fd34c569c2ffa768c9b3ec2289cc">Make sure /~username works</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
446 <li><a href="#head-c27688fbe7f65d67190a47ce8d32eba244ab0d01-2">Create a wiki instance</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
447 <li><a href="#head-ec9ce458a3f08281e5906f6d1e2e5cc008d620db">Install the htdocs files</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
448 <li><a href="#head-e3e9e08058bb0ae34c33f53367cd58d6c7411998-2">Install moin.cgi</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
449 <li><a href="#head-408a7a283b2406c4e6b24646b25ec7996d5ff459-2">Configure moin.cgi</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
450 <li><a href="#head-ffa39b171f9d130bb07a8481a5fff1a5a9065e86-2">Configure MoinMoin</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
451 <li><a href="#head-0f7a0fb8dccf6a13b6042fa17e0d7cda751fe3f3-2">Test the wiki</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
452 </ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
453 <li><a href="#head-3f286acb05ce4ad64240f788c78a8f915f59e34e">Troubleshooting</a><ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
454 <li><a href="#head-b8c0d1c1aba9cd39d0d15f86ea33025f7f25d48d">Adding permission to serve the htdocs directory</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
455 </ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
456 </li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
457 </ol>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
458 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
459
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
460 <h2 id="head-5a61f5b0107edba120089e4251cd633be60b6e15">Administrator (root)</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
461
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
462 <p>Most GNU/Linux distributions come with Apache pre-installed. There is, however, some variation as to where exactly the various Apache files are located. You should consult your distribution manual, or ask on the appropriate discussion board. In the following paragraphs, we assume a (quite standard) file system layout with: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
463 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
464 <li><p> <tt>/etc/httpd/httpd.conf</tt> - the main Apache configuration file </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
465 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
466 <li><p> <tt>/var/log/httpd/error_log</tt> - the log file containing Apache error messages </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
467 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
468 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
469 <p>Some distributions use <tt>apache</tt> instead of <tt>httpd</tt> for the directory names, others may use weirder settings. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
470
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
471 <h3 id="head-c27688fbe7f65d67190a47ce8d32eba244ab0d01">Create a wiki instance</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
472
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
473 <p>Creating a wiki instance involves copying files around and setting appropriate permissions. Before you can proceed, you need to know what user and group your Apache server runs as. The easiest way to know this is to issue this command: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
474
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
475 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
476 &gt; egrep "^User|^Group" /etc/httpd/httpd.conf
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
477 User wwwrun
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
478 Group nogroup
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
479 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
480 <p>This shows a typical result: "<tt>wwwrun.nogroup</tt>". Other common results are "<tt>nobody.nogroup</tt>", "<tt>apache.apache</tt>" and "<tt>www-data.www-data</tt>". You can of course use your own. What matters is that you know which ones are in use, because you will need them to set file permissions. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
481 <p>Once you have gathered this information, read <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a> and follow the steps described there. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
482
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
483 <h3 id="head-e3e9e08058bb0ae34c33f53367cd58d6c7411998">Install moin.cgi</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
484
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
485 <p>There is one last file you need to copy, the bridge between Apache and MoinMoin: the CGI script that Apache will call every time a wiki page is requested, and that will in turn invoke all the MoinMoin components to handle the request. You can actually put this script anywhere you like (all the paths to the files MoinMoin needs can be configured to match your filesystem layout), but for the sake of simplicity and security, we suggest you follow the instructions below, unless you think you know better. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
486 <p>We will create a <tt>cgi-bin</tt> subdirectory in the instance directory. Using the environment variables defined in <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a>, run the following commands: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
487
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
488 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
489 &gt; cd $WIKILOCATION/$INSTANCE
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
490 &gt; mkdir cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
491 &gt; cp $SHARE/server/moin.cgi cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
492 &gt; chown -R $USER.$GROUP cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
493 &gt; chmod -R ug+rx cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
494 &gt; chmod -R o-rwx cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
495 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
496
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
497 <h3 id="head-408a7a283b2406c4e6b24646b25ec7996d5ff459">Configure moin.cgi</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
498
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
499 <p>When <tt>moin.cgi</tt> is launched, it imports a MoinMoin module that in turn imports other modules and the configuration file. While the MoinMoin modules should always be found in a properly configured system (as described in <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a>), it is likely that the configuration file will not be found. Edit the <tt>moin.cgi</tt> script to correct that. Add these lines near the top of the file: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
500
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
501 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
502 import sys
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
503 sys.path.insert(0, '..')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
504 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
505 <p>You can also use the absolute name of the directory that contains the <tt>wikiconfig.py</tt> file instead of <tt>'..'</tt>. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
506
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
507 <h3 id="head-b02e2f66403a66cc3b1ff0ce2c7261cf44e4f0d4">Configure Apache</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
508
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
509 <p>Now that every file is in place and properly locked down (as far as the filesystem is concerned), we need to configure Apache so that it offers access to the right files, and no others. However, since the default Apache configuration varies a lot according to the distribution you use, and since administrators often make important additions and changes to it, we cannot give exact instructions that cover all cases. Instead, we will first describe roughly what needs to be done, and then give a few specific lines that you should add at the appropriate place in your Apache config. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
510 <p>Your Apache should be set up so that: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
511 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
512 <li><p> Access to your instance directory is denied (sane Apache installations should actually deny access to the whole server, and then only allow a few specific directories). </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
513 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
514 <li><p> An alias is set up to redirect requests from <tt>/wiki/</tt> (in the URL) to the <tt>htdocs</tt> directory (in the <tt>share</tt> directory, as discussed at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a>) </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
515 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
516 <li><p> A script alias is set up to redirect requests from whatever you want (we suggest you use your instance name, for example <tt>/mywiki</tt>) to the CGI script you just copied. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
517 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
518 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
519 <p>The following commands will add two lines at the bottom of your Apache config file. These lines only cover the last two items listed above. You have to check the first one by yourself (there is too much variation in Linux distributions). Note that you may have to move the two lines to the appropriate place in your config file -- maybe near other similar lines. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
520
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
521 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
522 &gt; echo "" &gt;&gt;/etc/httpd/httpd.conf
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
523 &gt; echo "Alias /wiki/ \"$SHARE/htdocs/\"" &gt;&gt;/etc/httpd/httpd.conf
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
524 &gt; echo "ScriptAlias /mywiki \"$WIKILOCATION/$INSTANCE/cgi-bin/moin.cgi\"" &gt;&gt;/etc/httpd/httpd.conf
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
525 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
526 <p>You only need to define the alias for <tt>htdocs</tt> once. You need to define a different script alias for each wiki instance you intend to run. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
527
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
528 <h3 id="head-ffa39b171f9d130bb07a8481a5fff1a5a9065e86">Configure MoinMoin</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
529
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
530 <p>Finally, check that the <tt>wikiconfig.py</tt> file in the instance directory contains correct paths for the htdocs prefix, the instance data directory, and the instance underlay directory. You can use relative paths for the directories, but note that they are relative to the CGI script, not the configuration file! You can also use absolute paths, and save yourself some headaches. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
531 <p>Here are the settings you should have in the config file if you followed all our suggestions: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
532
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
533 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
534 data_dir = '../data/'
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
535 data_underlay_dir = '../underlay/'
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
536 url_prefix = '/wiki'
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
537 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
538 <p>There are other settings you will likely want to alter, look at the bottom of <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a> for more details about them. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
539
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
540 <h3 id="head-0f7a0fb8dccf6a13b6042fa17e0d7cda751fe3f3">Test the wiki</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
541
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
542 <p>Everything should work fine now. It is time to <strong>restart the Apache server</strong> (usually with "<tt>/etc/init.d/apache&nbsp;restart</tt>", sometimes with "<tt>apachectl&nbsp;restart</tt>") and perform the following steps: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
543 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
544 <li><p> Run the <em>MoinMoin CGI Diagnosis</em>: connect to "<tt>http://127.0.0.1/mywiki?action=test</tt>" (or the name and port you have defined in the Apache configuration file). Verify that the displayed information is correct. Check that the directories listed under <em>Checking directories...</em> are <em>OK</em>. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
545 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
546 <li><p> Access your new wiki with the URL "<tt>http://127.0.0.1/mywiki/</tt>" (or the name and port you have defined in the Apache configuration file). You should see the FrontPage. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
547 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
548 <li><p> If this is the case, try to edit it and save your changes. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
549 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
550 <li><p> If that works, see if your edit is reflected on the RecentChanges page. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
551 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
552 <li><p> If you see them, congratulations, your new wiki works! <img src="wiki/htdocs/modern/img/smile.png" alt=":)" height="15" width="15"> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
553 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
554 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
555 <p>If something goes wrong, have a look at Troubleshooting, at the bottom of this page. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
556
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
557 <h3 id="head-52920da3312438e6a484347d4dfaa369b86cb521">Apache tricks</h4>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
558
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
559 <p>For more advanced configuration and some tricks see <a href="http://moinmaster.wikiwikiweb.de/HelpMiscellaneous">HelpMiscellaneous</a>. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
560
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
561 <h2 id="head-e559f024646d8751eee1135ad5423247d72ab7fd">Simple user (home directory installation)</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
562
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
563 <p>On machines shared by many people, simple users typically have no access to the root account, cannot modify the <tt>httpd.conf</tt> file, and cannot copy files into the system-wide <tt>cgi-bin</tt> and <tt>htdocs</tt> directories. In that case, Apache can be set up so that each user can host a web site in the home directory of his or her shell account, using the <tt>UserDir</tt> directive. If the machine administrator decides to use it, all URLs that start with "<tt>/~username</tt>" will be redirected to a directory in the users' home directories, where they have write permission and can install MoinMoin. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
564 <p>As an example, we will consider the case of a user named "<tt>mm</tt>". Of course, wherever you see "<tt>mm</tt>" below, you will replace it with your own username. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
565
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
566 <h3 id="head-6a39e2829f37fd34c569c2ffa768c9b3ec2289cc">Make sure /~username works</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
567
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
568 <p>The home directory installation can only work if the administrator (root) has allowed it. So, the first step is of course to check that it works. Typically, Apache is set up so that the <tt>public_html</tt> subdirectory in the home directory is used as the web site root. So, the first first step is to check if that directory exists. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
569
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
570 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
571 &gt; ls -ld ~/public_html
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
572 drwxr-xr-x 2 mm users 4096 Nov 30 00:29 public_html
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
573 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
574 <p>If the directory does not exist, create it, and be sure it can be read and entered by the web server. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
575
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
576 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
577 &gt; mkdir public_html
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
578 &gt; chmod a+rx public_html
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
579 &gt; ls -ld ~/public_html
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
580 drwxr-xr-x 2 mm users 4096 Nov 30 00:35 public_html
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
581 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
582 <p>Now, check if the "<tt>/~mm</tt>" URL works: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
583
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
584 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
585 &gt; lynx -error_file=/dev/stderr -dump http://localhost/~mm/ &gt;/dev/null
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
586 URL=http://localhost/~mm/ (GET)
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
587 STATUS=HTTP/1.1 200 OK
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
588 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
589 <p>If you get a "<tt>200&nbsp;OK</tt>" response code, then it works, and you can go on to the next check. If you get a "<tt>403&nbsp;Forbidden</tt>" or a "<tt>404&nbsp;Not&nbsp;Found</tt>" response, then maybe something is wrong with your directory, or maybe the whole thing has not been enabled by your administrator. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
590 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
591 <li><p> Check the permissions for your home directory (<tt>~</tt>) and your <tt>public_html</tt> directory. The first one should at least end with "<tt>--x</tt>", and the second one, as we saw above, with "<tt>r-x</tt>". </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
592 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
593 <li><p> It also possible that the administrator has set up another name for the personal web site directory. "<tt>public_html</tt>" is just the usual default, but anything can actually be used. There is no way to know, you have to ask the administrator (root). </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
594 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
595 <li><p> Finally, if the personal web site feature is disabled, maybe you can ask the administrator to enable it? </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
596 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
597 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
598 <p>Once you have checked you can read the files in the directory, you need to check that you are also able to execute CGI scripts in that directory. Use the following commands to create a simple CGI script in the appropriate location: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
599
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
600 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
601 &gt; mkdir -p ~/public_html/cgi-bin
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
602 &gt; cat &gt; ~/public_html/cgi-bin/test.cgi
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
603 #!/bin/sh
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
604 echo Content-Type: text/plain
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
605 echo
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
606 echo "CGI scripts work"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
607 &lt;CTRL-D&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
608 &gt; chmod a+rx ~/public_html/cgi-bin/test.cgi
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
609 &gt; lynx -dump http://localhost/~jh/cgi-bin/test.cgi
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
610 CGI scripts work
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
611 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
612 <p>If you get anything else than "<tt>CGI&nbsp;scripts&nbsp;work</tt>", then something went wrong. Check the directory permissions as above, try other names (or ask about them). The sad truth might be that you are not allowed to execute CGI scripts. You would then have to ask the administrator (root) for that permission. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
613 <p>Once you get it, you can set up your wiki instance in the <tt>public_html</tt> directory. <img src="wiki/htdocs/modern/img/smile.png" alt=":)" height="15" width="15"> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
614
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
615 <h3 id="head-c27688fbe7f65d67190a47ce8d32eba244ab0d01-2">Create a wiki instance</h4>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
616
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
617 <p>Creating a wiki instance involves copying files around and setting appropriate permissions. Read <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a> and follow the steps described there. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
618
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
619 <h3 id="head-ec9ce458a3f08281e5906f6d1e2e5cc008d620db">Install the htdocs files</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
620
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
621 <p>The web server needs to access these files, so we need to copy them in the "<tt>public_html</tt>" directory. Just use this: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
622
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
623 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
624 &gt; cd ~/public_html
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
625 &gt; cp -R ~/share/moin/htdocs wiki
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
626 &gt; chmod -R a+rX wiki
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
627 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
628
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
629 <h3 id="head-e3e9e08058bb0ae34c33f53367cd58d6c7411998-2">Install moin.cgi</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
630
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
631 <p>There is one last file you need to copy, the bridge between Apache and MoinMoin: the CGI script that Apache will call every time a wiki page is requested, and that will in turn invoke all the MoinMoin components to handle the request. You need to put this file in a directory for which CGI scripts execution is enabled. By default, this should work: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
632
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
633 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
634 &gt; cd ~/public_html
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
635 &gt; mkdir cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
636 &gt; cp $SHARE/server/moin.cgi cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
637 &gt; chmod -R a+rx cgi-bin
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
638 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
639
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
640 <h3 id="head-408a7a283b2406c4e6b24646b25ec7996d5ff459-2">Configure moin.cgi</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
641
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
642 <p>When <tt>moin.cgi</tt> is launched, it imports a MoinMoin module (that in turn imports other modules and the configuration file). Since everything has been installed in your home directory, it is likely none of these will be found. Edit the <tt>moin.cgi</tt> script to correct that. Add these lines near the top of the file: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
643
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
644 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
645 import sys
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
646 sys.path.insert(0, '/home/mm/lib/python2.3')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
647 sys.path.insert(0, '/home/mm/lib/python2.3/site-packages')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
648 sys.path.insert(0, '/home/mm/share/moin/mywiki')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
649 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
650 <p>Of course, you need to adapt the paths to your situation. The first two lines should help locate the MoinMoin modules, the last one should help locate the <tt>wikiconfig.py</tt> file. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
651 <p><strong>Note:</strong> You might also need to edit the first line of the file, to point to the correct version of Python. The default should be fine, but a line like "<tt>#!&nbsp;/usr/bin/python2.3</tt>" might help you if the default does not work. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
652 <p><strong>Note 2:</strong> In this file there is a line reading <tt>request&nbsp;=&nbsp;RequestCGI()</tt>. If you have a complex mod_rewrite case, you might want to add <tt>properties&nbsp;=&nbsp;{'script_name':&nbsp;'/mywiki'}&nbsp;</tt> in the parenthesis. This will let <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> generate URLs that start with <tt>/mywiki</tt> and not the path that the webserver passed to <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a>. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
653
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
654 <h3 id="head-ffa39b171f9d130bb07a8481a5fff1a5a9065e86-2">Configure MoinMoin</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
655
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
656 <p>Finally, check that the <tt>wikiconfig.py</tt> file in the instance directory contains correct paths for the htdocs directory, the instance data directory, and the instance underlay directory. You can use relative paths for the directories, but note that they are relative to the CGI script, not the configuration file! You can also use absolute paths, and save yourself some headaches. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
657
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
658 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
659 data_dir = '/home/mm/share/moin/mywiki/data/'
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
660 data_underlay_dir = '/home/mm/share/moin/mywiki/underlay/'
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
661 url_prefix = '/~mm/wiki'
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
662 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
663
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
664 <h3 id="head-0f7a0fb8dccf6a13b6042fa17e0d7cda751fe3f3-2">Test the wiki</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
665
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
666 <p>Everything should work fine, now. It is time to perform the following steps: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
667 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
668 <li><p> Run the <em>MoinMoin CGI Diagnosis</em>: <tt>&gt;&nbsp;lynx&nbsp;-dump&nbsp;http://localhost/~mm/cgi-bin/moin.cgi?action=test</tt> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
669 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
670 <li><p> If it worked, try to access your new-born wiki with the URL "<tt>http://127.0.0.1/~mm/cgi-bin/moin.cgi</tt>". You should see the FrontPage. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
671 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
672 <li><p> If this is the case, try to edit it and save your changes. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
673 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
674 <li><p> If that works, see if your edit is reflected on the RecentChanges page. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
675 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
676 <li><p> If you see them, congratulations, you have a new wiki! <img src="wiki/htdocs/modern/img/smile.png" alt=":)" height="15" width="15"> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
677 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
678 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
679 <p>If something goes wrong, have a look at Troubleshooting, below. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
680
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
681 <h2 id="head-3f286acb05ce4ad64240f788c78a8f915f59e34e">Troubleshooting</h3>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
682
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
683 <p>See also <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/TroubleShooting">../TroubleShooting</a> for generic stuff. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
684 <p>The first thing to do when your wiki does not work as expected is to issue the command "<tt>tail&nbsp;/var/log/httpd/error_log</tt>" to display the most recent errors. Usually, you will get a hint on what went wrong, like missing file system permissions. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
685
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
686 <h3 id="head-b8c0d1c1aba9cd39d0d15f86ea33025f7f25d48d">Adding permission to serve the htdocs directory</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
687
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
688 <p>In some (sane) Linux distributions (like SuSE 9.0) serving directories other than the document-root "<tt>/srv/www/htdocs</tt>" with Apache is switched off by default for security reasons in "<tt>/etc/httpd/httpd.conf</tt>" (or for Apache2 "<tt>/etc/apache2/httpd.conf</tt>"): </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
689
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
690 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
691 # forbid access to the entire filesystem by default
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
692 &lt;Directory /&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
693 Options None
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
694 AllowOverride None
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
695 Order deny,allow
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
696 Deny from all
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
697 &lt;/Directory&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
698 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
699 <p>To allow Apache to serve directories outside of the document root you have to add these lines to "<tt>/etc/httpd/httpd.conf</tt>" (in SuSE it is recommended to create a new "<tt>http.conf.local</tt>" and include this file in "<tt>/etc/sysconfig/apache2</tt>"): </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
700
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
701 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
702 Alias /wiki/ "/usr/share/moin/htdocs/"
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
703 &lt;Directory "/usr/share/moin/htdocs/"&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
704 Order deny,allow
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
705 Allow from all
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
706 &lt;/Directory&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
707
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
708 ScriptAlias /mywiki "/usr/share/moin/mywiki/cgi-bin/moin.cgi"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
709 &lt;Directory "/usr/share/moin/mywiki/cgi-bin"&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
710 Order deny,allow
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
711 Allow from all
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
712 &lt;/Directory&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
713 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
714 <p>Of course, you need to adapt the paths to your particular situation. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
715 <a id="bottom_Include_HelpOnInstalling/ApacheOnLinux"></a>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
716 </div>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
717 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
718 <hr class="hr2">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
719 <p> <a id="fastcgi-install"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
720
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
721 <h1>FastCGI Setup using Apache</h1>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
722
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
723 <div lang="en" id="Include_HelpOnInstalling/ApacheWithFastCgi" dir="ltr">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
724 <a id="top_Include_HelpOnInstalling/ApacheWithFastCgi"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
725 <h2 id="head-6839f37b445b94c0c179f023498969fb53e3d925">Using MoinMoin with apache + mod_fastcgi</h3>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
726
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
727 <p><a class="external" href="http://fastcgi.com"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> FastCGI</a> is a method which enables apache to communicate with long-running scripts. This has the advantage that the script is only started and initialized one time, and that data could be cached in memory from request to request, enhancing the performance of the CGI application. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
728
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
729 <h3 id="head-a37ae17ad8fb640605fa790fcef7b8cbf0b29353">Deploying MoinMoin with apache + mod_fastcgi</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
730
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
731 <p>To deploy <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> using FastCGI you need an apache with mod_fastcgi. Please refer to the documentation of mod_fastcgi how to build it. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
732 <p>Follow the basic apache installation for your operating system as described in other parts of the <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> installation documentation. This is <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheOnLinux">HelpOnInstalling/ApacheOnLinux</a> in most cases. In places where the documentation refers to <tt>moin.cgi</tt> you use <tt>moin.fcg</tt> instead. Be sure that <strong>.fcg</strong> is handled by the FastCGI module (<tt>AddHandler&nbsp;fastcgi-script&nbsp;.fcg</tt> in your apache config). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
733 <p>Normally apache will start CGI scripts with its own user and group, or with the user and group of the VirtualHost if you are using the suexec wrapper. To enable this with FastCGI you need to use <tt>FastCgiWrapper&nbsp;On</tt> in your apache config (see FastCGI Documentation). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
734 <p>Be sure to restart your apache after you changed py files (i.e. the config) for a running FastCGI server, or you won't see any changes! </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
735
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
736 <h3 id="head-cd07429ac863a0a4bf393f5936fbccbffe17e9b4">Running as an external application and/or on Windows</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
737
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
738 <p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> Experimental. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
739 <p><a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> can be run as an external application that answers FastCGI request via a local TCP/IP socket. This works on Windows as well. All you need to do (after having installed <tt>mod_fastcgi</tt> and a working <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> instance) is this: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
740 <ol type="1">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
741 <li><p>Select a port number for the internal communication. It should be larger than 1023. For this example, we chose 8888 (just for fun). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
742 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
743 <li class="gap"><p>Add the following lines to your httpd.conf:
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
744 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
745 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
746 Alias /moin.fcg "/your/path/to/moin.fcg"
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
747 FastCgiExternalServer "/your/path/to/moin.fcg" -host localhost:8888
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
748 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
749 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
750 <li class="gap"><p>Edit <tt>moin.fcg</tt>. Replace
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
751 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
752 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
753 fcg = thfcgi.THFCGI(handle_request)
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
754 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
755 <p> with
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
756 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
757 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
758 fcg = thfcgi.THFCGI(handle_request, 0, 8888)
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
759 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
760 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
761 <li class="gap"><p>Start the file <tt>moin.fcg</tt> manually like a Python script:
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
762 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
763 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
764 python moin.fcg
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
765 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
766 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
767 <li class="gap"><p>Start Apache. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
768 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
769 <li class="gap"><p>Enjoy <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> running with FastCGI support! </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
770 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
771 </ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
772
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
773 <h3 id="head-4f0ae2079d5166e93d946467cf44f193f0c8e571">Add a safe fallback</h4>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
774
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
775 <p>Install and test <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> according to <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheOnLinux">HelpOnInstalling/ApacheOnLinux</a>. Then make and test the changes to run mod_fastcgi. If you are satisfied, you can add the following block to your apache config:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
776 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
777 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
778 &lt;IfModule !mod_fastcgi.c&gt;
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
779 ScriptAlias /mywiki "/your/path/to/moin.cgi"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
780 &lt;/IfModule&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
781 &lt;IfModule mod_fastcgi.c&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
782 AddHandler fastcgi-script .fcg
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
783 ScriptAlias /mywiki "/your/path/to/moin.fcg"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
784 &lt;/IfModule&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
785 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
786 <p>Now Apache will use mod_fastcgi if available and otherwise use the slow cgi script. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
787 <a id="bottom_Include_HelpOnInstalling/ApacheWithFastCgi"></a>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
788 </div>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
789 </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
790 <hr class="hr2">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
791 <p> <a id="modpy-install"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
792
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
793 <h1>mod_python Setup using Apache</h1>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
794
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
795 <div lang="en" id="Include_HelpOnInstalling/ApacheWithModPython" dir="ltr">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
796 <a id="top_Include_HelpOnInstalling/ApacheWithModPython"></a><ol>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
797 <li><a href="#head-4e6235e8e3535359b4aa9df9722961dfd62a685a">Why Use mod_python</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
798 <li><a href="#head-52f515a2448d32357136b23a188dd227330baeb2">Basic configuring</a><ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
799 <li><a href="#head-8cd6758d1fcc77b433f6584bcc34e24469568d75">Install mod_python</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
800 <li><a href="#head-671adcfb8441deb9daa6ba877d59cc69d5e9d25e">Set up a wiki instance</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
801 <li><a href="#head-08923628c7a5b449b5f210251334c431791adec9">Edit `wikiconfig.py`</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
802 <li><a href="#head-b628477f88ab294636a22af4ee665656a8897b3a">Changes to Apache `httpd.conf`</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
803 </ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
804 <li><a href="#head-2dba68d0d0ad069f1c4a2a46bcdbd07cb21d3887">Solving problems for non-root-mounted wikis</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
805 <li><a href="#head-e7e935fbfb5a81ceb0698ef82b5b7a897aa5e157">Configuring root wiki</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
806 <li><a href="#head-53a11a51ff1c262df8f1f287084f8700685446d4">Older mod_python versions</a><ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
807 <li><a href="#head-7b2283d5184932488fe551b2cee08e28fb18230c">Use a wrapper script</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
808 <li><a href="#head-f2a32b29f0aff0101a91c87d692d063a6e0a4ec2">Fix mod_python</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
809 </ol>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
810 <li><a href="#head-17313e33f7320af70773f484730b290d86b62ee5">Troubleshooting</a></li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
811 </ol>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
812 <p> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
813
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
814 <h1 id="head-4e6235e8e3535359b4aa9df9722961dfd62a685a">Why Use mod_python</h2>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
815
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
816 <p><a class="external" href="http://modpython.org/"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> mod_python</a> embeds the python interpreter into the apache server. This saves initialization time and the need of forking cgi scripts. It doesn't have the ability to run as different users. It will always run as the main apache user and group. Be sure that your wiki data files are accessible and writable by your apache server. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
817 <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" </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
818 <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 memory requirements considerably - especially as apache runs many separate processes which will each need to have their own copy of the python code and data in the process memory space. You may find that FastCGI, as detailed in <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/ApacheWithFastCgi">HelpOnInstalling/ApacheWithFastCgi</a> is rather more efficient in this respect. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
819
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
820 <h1 id="head-52f515a2448d32357136b23a188dd227330baeb2">Basic configuring</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
821
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
822 <ol type="1">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
823 <li><p>Install mod_python </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
824 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
825 <li><p>Set up a wiki instance </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
826 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
827 <li><p>Edit <tt>wikiconfig.py</tt> </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
828 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
829 <li><p>Changes to Apache <tt>httpd.conf</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
830 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
831 <li><p>Restart Apache </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
832 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
833 </ol>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
834 <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. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
835
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
836 <h2 id="head-8cd6758d1fcc77b433f6584bcc34e24469568d75">Install mod_python</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
837
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
838 <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="external" href="http://modpython.org/live/current/doc-html/"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> mod_python documentation</a>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
839 <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>). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
840 <p>Make sure you have this line in <tt>httpd.conf</tt> or mod_python will not work:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
841 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
842 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
843 LoadModule python_module modules/mod_python.so
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
844 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
845 <p>After this restart Apache and make sure that it starts successfully, and that the error log has a line similar to this:-
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
846 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
847 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
848 [Sat Jan 01 15:40:49 2005] [notice] mod_python: Creating 4 session mutexes based on 150 max processes and 0 max threads.
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
849 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
850 <p>You may need to change some environment variables on (eg) FreeBSD - this is detailed in the port installation message. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
851
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
852 <h2 id="head-671adcfb8441deb9daa6ba877d59cc69d5e9d25e">Set up a wiki instance</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
853
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
854 <p>This is done as shown in <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">WikiInstanceCreation</a>. Its recommended to first configure the wiki with cgi and check that it works, then change the configuratin to use mod_python. This allows you be sure that any problems are in the mod_python transition rather than the basic <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> installation. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
855 <ol type="1">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
856 <li><p>Copy moin.cgi into your wiki directory </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
857 </li>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
858 <li><p>Configure <tt>httpd.conf</tt> as cgi first: </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
859 <ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
860 <li style="list-style-type:none">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
861 <pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
862 Alias /wiki/ "/usr/share/moin/htdocs/"
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
863 ScriptAlias /mywiki "/var/www/moin/mywiki/moin.cgi"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
864 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
865 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
866 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
867 </li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
868 </ol>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
869 <p>Restart Apache and make test that your wiki works. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
870
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
871 <h2 id="head-08923628c7a5b449b5f210251334c431791adec9">Edit `wikiconfig.py`</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
872
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
873 <p>Make sure you use only absolute paths - relative paths will not work!
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
874 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
875 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
876 data_dir = '/var/www/moin/mywiki/data/'
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
877 data_underlay_dir = '/var/www/moin/mywiki/underlay/'
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
878 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
879 <p>If you do not want to use absolute paths, you can use Python's os module to construct the relative paths: </p>
137
cfbecd3400d3 make install-docs, intermap, underlay, ...
Thomas Waldmann <tw@waldmann-edv.de>
parents: 0
diff changeset
880 <pre>
cfbecd3400d3 make install-docs, intermap, underlay, ...
Thomas Waldmann <tw@waldmann-edv.de>
parents: 0
diff changeset
881 import os
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
882 data_dir = os.path.join(os.path.dirname(__file__), 'data/')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
883 data_underlay_dir = os.path.join(os.path.dirname(__file__), 'underlay/')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
884 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
885 <p>Test that the wiki works after this change. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
886 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
887 <li style="list-style-type:none"><p><img src="wiki/htdocs/modern/img/idea.png" alt="(!)" height="15" width="15"> In 1.2 and earlyer, the configuration file is called <tt>moin_config.py</tt>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
888 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
889 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
890
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
891 <h2 id="head-b628477f88ab294636a22af4ee665656a8897b3a">Changes to Apache `httpd.conf`</h3>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
892
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
893 <p>After your wiki is running as cgi script, convert it to run with mod_python. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
894 <p>If you run your wiki as cgi as we recommended before, remove or comment the <a class="nonexistent" href="http://moinmaster.wikiwikiweb.de/ScriptAlias">ScriptAlias</a> directive:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
895 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
896 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
897 #ScriptAlias /mywiki "/var/www/moin/mywiki/moin.cgi"
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
898 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
899 <p>Add a <tt>Location</tt> directive:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
900 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
901 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
902 &lt;Location /mywiki&gt;
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
903 SetHandler python-program
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
904 # Add the path of your wiki directory
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
905 PythonPath "['/var/www/moin/mywiki'] + sys.path"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
906 PythonHandler MoinMoin.request::RequestModPy.run
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
907 &lt;/Location&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
908 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
909 <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="external" href="http://modpython.org/live/current/doc-html/pyapi-interps.html"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> here</a> for details). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
910 <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:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
911 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
912 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
913 PythonPath "['/var/www/moin/mywiki', '/prefix/lib/python2.x/site-packages'] + sys.path"
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
914 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
915 <p>Restart Apache - everything should now work correctly. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
916
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
917 <h1 id="head-2dba68d0d0ad069f1c4a2a46bcdbd07cb21d3887">Solving problems for non-root-mounted wikis</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
918
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
919 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
920 <li style="list-style-type:none"><p><img src="wiki/htdocs/modern/img/alert.png" alt="/!\" height="15" width="15"> If your wiki does not have a root URL (like <tt>http://www.example.com/FrontPage</tt>), then you might need to follow the next steps: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
921 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
922 </ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
923 <p>On some installations, mod_python hands <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> incorrect script_name and path_info. It usually happens when using the Apache Location directive, with a wiki in an arbitary path:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
924 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
925 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
926 &lt;Location /farm/mywiki&gt;
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
927 ...
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
928 &lt;/Location&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
929 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
930 <p>This will not work, because its not clear what is the script name, since with location setup, there is no real script. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
931 <p>To solve this problem, use a <tt>PythonOption</tt> directive:
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
932 </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
933 <pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
934 &lt;Location /farm/mywiki&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
935 # Location value must match the Apache Location value!
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
936 PythonOption Location /farm/mywiki
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
937 ...
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
938 &lt;/Location&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
939 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
940 <ul>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
941 <li style="list-style-type:none"><p><img src="wiki/htdocs/modern/img/idea.png" alt="(!)" height="15" width="15"> New in release 1.3.5 </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
942 </li>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
943 </ul>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
944
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
945 <h1 id="head-e7e935fbfb5a81ceb0698ef82b5b7a897aa5e157">Configuring root wiki</h2>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
946
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
947 <p>You may wish to have your wiki appearing at the root of your webserver - for example so that <tt>http://wiki.example.com/</tt> will map to your wiki rather than having to use <tt>http://wiki.example.com/mywiki/</tt>. This requires a slightly different form of configuration using <tt>mod_rewrite</tt> - this is a standard module of recent Apache distributions, and is often enabled by default. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
948 <p>You need to set up your wiki instance as described above, and also copy <tt>moinmodpy.py</tt> from the Moin installation directory to the wiki instance directory (<tt>/var/www/moin/mywiki</tt> in these examples). </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
949 <p>The Apache configuration needs <tt>mod_rewrite</tt> enabled - so the line
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
950 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
951 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
952 LoadModule rewrite_module modules/mod_rewrite.so
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
953 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
954 <p>should appear in the first part of the <tt>httpd.conf</tt> configuration file. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
955 <p>The wiki and virtual host configuration sould look like this:-
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
956 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
957 <pre>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
958 &lt;VirtualHost *:80&gt;
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
959 ServerAdmin postmaster@example.com
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
960 DocumentRoot /var/www/html
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
961 ServerName wiki.example.com
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
962 Alias /wiki/ "/usr/share/moin/htdocs/"
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
963
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
964 # Rewrite urls
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
965 RewriteEngine On
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
966 RewriteLogLevel 0
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
967 # map /wiki static files to Moin htdocs
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
968 RewriteRule ^/wiki/(.*)$ /usr/share/moin/htdocs/$1 [last]
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
969 # map everything else to server script
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
970 RewriteRule ^(.*)$ /var/www/moin/mywiki/moinmodpy.py$1
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
971
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
972 &lt;Directory "/var/www/moin/testwiki"&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
973 # Modpy stuff
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
974 AddHandler python-program .py
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
975 # Add the path to the wiki directory, where
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
976 # moinmodpy.py and wikiconfig.py are located.
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
977 PythonPath "['/var/www/moin/mywiki'] + sys.path"
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
978 PythonHandler moinmodpy
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
979 &lt;/Directory&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
980 &lt;/VirtualHost&gt;
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
981 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
982 <p>Apache should be restarted, and the FrontPage of <tt>mywiki</tt> should now appear at <tt>http://wiki.example.com/</tt>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
983 <p>Other ways of handling root level wikis with Apache are detailed in the appropriately named <a href="http://moinmaster.wikiwikiweb.de/HelpOnConfiguration/ApacheVoodoo">HelpOnConfiguration/ApacheVoodoo</a>. </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
984
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
985 <h1 id="head-53a11a51ff1c262df8f1f287084f8700685446d4">Older mod_python versions</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
986
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
987 <p>mod_python versions 2.7.10, 3.0.4 and 3.1.2b have a bug in <tt>apache.resolve_object</tt>. This bug was reported to the mod_python maintainers and has been fixed in the 3.1.3 release. The best fix for this is to update to the current release. However if you are unable to do this there are 2 possible solutions: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
988
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
989 <h2 id="head-7b2283d5184932488fe551b2cee08e28fb18230c">Use a wrapper script</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
990
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
991 <p><a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> come with a <tt>moinmodpy.py</tt> wrapper script, and this could be used by changing the <tt>PythonPath</tt> and <tt>PythonHandler</tt> directives as shown in the <tt>moinmodpy.htaccess</tt> file. The wrapper was named <tt>moin_modpy.py</tt> in <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> 1.2. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
992
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
993 <h2 id="head-f2a32b29f0aff0101a91c87d692d063a6e0a4ec2">Fix mod_python</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
994
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
995 <p>mod_python has a small resolver bug in versions 2.7.10, 3.0.4 and 3.1.2b. The method <tt>resolve_object</tt> in <tt>mod_python/apache.py</tt> checks the wrong object, and so the lookup for <tt>RequestModPy.run</tt> fails. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
996 <p>To fix it you need to change the method <tt>resolve_object</tt> (around line 551 for mod_python 3.1.2b) from </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
997
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
998 <pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
999 if silent and not hasattr(module, obj_str):
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1000 return None
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1001 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1002 <p>to </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1003
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1004 <pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1005 if silent and not hasattr(obj, obj_str):
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1006 return None
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1007 </pre>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1008
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1009 <h1 id="head-17313e33f7320af70773f484730b290d86b62ee5">Troubleshooting</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1010
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1011 <p>Page access gives apache error:: </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1012 <ul>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1013 <li style="list-style-type:none"><p><tt>PythonHandler&nbsp;MoinMoin.request::RequestModPy.run:&nbsp;OSError:&nbsp;[Errno&nbsp;2]&nbsp;No&nbsp;such&nbsp;file&nbsp;or&nbsp;directory:&nbsp;'data/user'</tt> This appears to be caused by you not having an absolute path for <tt>data_dir</tt> in <tt>moin_config.py</tt>. There are several other lines of error traceback preceding this one in the apache error log. Fix the path in <tt>moin_config.py</tt>. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1014 </li>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1015 </ul>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1016 <a id="bottom_Include_HelpOnInstalling/ApacheWithModPython"></a>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1017 </div>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1018 </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1019 <hr class="hr2">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1020 <p> <a id="twisted-install"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1021
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1022 <h1>Setup using Twisted</h1>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1023
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1024 <div lang="en" id="Include_HelpOnInstalling/TwistedWeb" dir="ltr">
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1025 <a id="top_Include_HelpOnInstalling/TwistedWeb"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1026 <h1 id="head-aadc9ea90352d5b5ad5745583f12238abc07f6b1">Using MoinMoin with Twisted</h2>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1027
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1028 <p><a class="external" href="http://twistedmatrix.com"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> Twisted</a> is a standalone python framework for many kinds of applications. 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. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1029 <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>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1030 <p>Another advantage is that this is all based on Python. <img src="wiki/htdocs/modern/img/smile4.png" alt=";)" height="15" width="15"> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1031 <p>First do <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> and <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a>. </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1032
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1033 <h2 id="head-781019b7b4433e2b39a07387d381c1ca28eb9134">Install Twisted</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1034
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1035 <p>First, install Twisted (see URL above). Many Linux distributions have Twisted packages. Please refer to the documentation of Twisted for installation information. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1036
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1037 <h2 id="head-f377d8187c2c46a84ee4a6ae292b323853a6ae0c">Configuring the Twisted server</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1038
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1039 <p>Copy the file <tt>wiki/server/mointwisted.py</tt> to your wiki directory. Edit and adapt the settings to your needs. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1040
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1041 <h3 id="head-6cf160dca6339d0a63474b5e9d1c94115980d292">System path configuration</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1042
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1043 <p>If you did a standard install, and you are not a developer, you probably want to skip this section. Otherwise, you might want to add the path to moin and config file, like that: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1044
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1045 <pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1046 sys.path.insert(0, '/path/to/moin')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1047 sys.path.insert(0, '/path/to/wikiconfig')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1048 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1049
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1050 <h3 id="head-a51f43e6a56656fb4ff7b17d487afc09442427b5">Config class options</h4>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1051
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1052 <p>If you did a standard install, the default options might be just what you need. Check and change what you like: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1053 <div>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1054 <table>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1055 <tr>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1056 <td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1057 <p> <strong>Option</strong> </p>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1058 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1059 <td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1060 <p> <strong>Default</strong> </p>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1061 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1062 <td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1063 <p> <strong>Comment</strong> </p>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1064 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1065 </tr>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1066 <tr>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1067 <td>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1068 <p> docs </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1069 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1070 <td>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1071 <p> '/usr/share/moin/wiki/htdocs' </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1072 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1073 <td>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1074 <p> Path to moin shared files </p>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1075 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1076 </tr>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1077 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1078 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1079 <p> user </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1080 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1081 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1082 <p> 'www-data' </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1083 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1084 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1085 <p> If you run as root, the server will run as this user </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1086 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1087 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1088 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1089 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1090 <p> group </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1091 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1092 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1093 <p> 'www-data' </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1094 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1095 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1096 <p> If you run as root, the server will run as this group </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1097 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1098 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1099 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1100 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1101 <p> port </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1102 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1103 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1104 <p> 8080 </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1105 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1106 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1107 <p> Port to serve. To serve a privileged port below 1024 you will have to run as root </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1108 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1109 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1110 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1111 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1112 <p> interfaces </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1113 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1114 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1115 <p> <tt>['']</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1116 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1117 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1118 <p> A list of interfaces the server will listen to. If the list contains the entry <tt>''</tt> (like for the default configuration), all other entries are ignored and the server will listen to all interfaces. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1119 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1120 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1121 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1122 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1123 <p> logPath </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1124 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1125 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1126 <p> 'mointwisted.log' </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1127 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1128 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1129 <p> Log file. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1130 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1131 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1132 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1133 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1134 <p> profiler </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1135 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1136 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1137 <p> commented python code </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1138 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1139 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1140 <p> Useful only if you are a moin developer. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1141 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1142 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1143 </table>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1144 </div>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1145
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1146 <h2 id="head-e4c385b7866dfc82bdf390d00038d1e191cd6870">Configuring wikiconfig.py</h3>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1147
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1148 <p>The sample config file should be just fine. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1149 <div>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1150 <table>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1151 <tr>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1152 <td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1153 <p> <strong>Option</strong> </p>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1154 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1155 <td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1156 <p> <strong>Default</strong> </p>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1157 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1158 <td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1159 <p> <strong>Comment</strong> </p>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1160 </td>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1161 </tr>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1162 <tr>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1163 <td>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1164 <p> url_prefix </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1165 </td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1166 <td>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1167 <p> '/wiki' </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1168 </td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1169 <td>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1170 <p> You should not change this, or images and css file will not be available to the wiki! </p>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1171 </td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1172 </tr>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1173 </table>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1174 </div>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1175
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1176 <h2 id="head-828a44c0e867e6f0fb60395a972cb6003658f76f">Starting the server on Unix</h3>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1177
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1178 <p>On GNU/Linux, Mac OS X or another POSIX-like OS, copy <tt>wiki/server/mointwisted</tt> to your wiki directory. You might want to adapt <tt>PYTHONPATH</tt> and the path to <tt>twistd</tt>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1179 <p>Start the server with <tt>./mointwisted&nbsp;start</tt> and test your wiki at <a href="http://localhost:8080/"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> http://localhost:8080/</a>. Stop the server with <tt>./mointwisted&nbsp;stop</tt>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1180 <p>For more options run <tt>./mointwisted</tt> without arguments. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1181
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1182 <h2 id="head-0457c39c25e65945e29141fa8f207afe318806fe">Starting the server on Windows</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1183
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1184 <p>Copy <tt>wiki/server/mointwisted.cmd</tt> to your wiki directory. You might have to change the path pointing to the python-scripts directory. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1185 <p>Double click <tt>mointwisted.cmd</tt> to start the server. It will create a new terminal window. To stop the server, close the terminal window. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1186 <a id="bottom_Include_HelpOnInstalling/TwistedWeb"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1187 </div>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1188 </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1189 <hr class="hr2">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1190 <p> <a id="linuxstandalone-install"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1191
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1192 <h1>Linux Installation using standalone server</h1>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1193
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1194 <div lang="en" id="Include_HelpOnInstalling/StandaloneServer" dir="ltr">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1195 <a id="top_Include_HelpOnInstalling/StandaloneServer"></a><p><strong>Installing and configuring standalone server</strong> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1196 <p>See also: <a href="http://moinmaster.wikiwikiweb.de/HelpOnConfiguration/IntegratingWithApache">HelpOnConfiguration/IntegratingWithApache</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1197 <p>The standalone server is especially made for local wikis because it does not need a web server installed. Only Python and Moin are necessary! </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1198 <p>To install and run the standalone server: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1199 <ol type="1">
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1200 <li><p>If <a href="http://moinmaster.wikiwikiweb.de/MoinMoin">MoinMoin</a> is not installed yet, preform <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/BasicInstallation">../BasicInstallation</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1201 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1202 <li><p>Create a wiki instance as described in <a href="http://moinmaster.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation">../WikiInstanceCreation</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1203 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1204 <li><p>Copy <tt>moin.py</tt> to your wiki directory, where your <tt>wikiconfig.py</tt> is </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1205 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1206 <li><p>If you installed with <tt>--prefix</tt> option, you must edit moin.py and set <tt>docs</tt> to the correct path. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1207 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1208 <li><p>Run <tt>moin.py</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1209 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1210 <li><p>Access your wiki at <a href="http://localhost:8000/"><img src="wiki/htdocs/modern/img/moin-www.png" alt="[WWW]" height="11" width="11"> http://localhost:8000/</a> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1211 </li>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1212 </ol>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1213 <p>On most cases, the default settings will be just fine. You many want to edit <tt>moin.py</tt> and change some of the options, as described in the next section. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1214
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1215 <h1 id="head-b104ff56fc1c89199447f1f2756b65995534e032">Configuring moin.py</h2>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1216
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1217
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1218 <h2 id="head-5d2a2fc430a567acd72fcaa712af23333abca0df">System path configuration</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1219
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1220 <p>If you did a standard install, and you are not a developer, you probably want to skip this section. If not, you might want to add the path to moin and config file, like that: </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1221
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1222 <pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1223 import sys
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1224 sys.path.insert(0, '/path/to/moin')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1225 sys.path.insert(0, '/path/to/wikiconfig')
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1226 </pre>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1227 <a id="options"></a>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1228 <p> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1229
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1230 <h2 id="head-3cb7180f429490b9735cfc083869eaaa128ed64c">Config class options</h3>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1231
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1232 <div>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1233 <table>
0
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1234 <tr>
77665d8e2254 tag of nonpublic@localhost--archive/moin--enterprise--1.5--base-0
Thomas Waldmann <tw-public@gmx.de>
parents:
diff changeset
1235 <td>
176
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1236 <p> <strong>Option</strong> </p>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1237 </td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1238 <td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1239 <p> <strong>Default</strong> </p>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1240 </td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1241 <td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1242 <p> <strong>Comment</strong> </p>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1243 </td>
6ddcb13c0f4e make install-docs, interwiki, underlay
Thomas Waldmann <tw@waldmann-edv.de>
parents: 137
diff changeset
1244 </tr>
196
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1245 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1246 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1247 <p> name </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1248 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1249 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1250 <p> <tt>'moin'</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1251 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1252 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1253 <p> Server name, used by default for log and pid files. <img src="wiki/htdocs/modern/img/idea.png" alt="(!)" height="15" width="15"> New in 1.5 </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1254 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1255 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1256 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1257 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1258 <p> docs </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1259 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1260 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1261 <p> <tt>'/usr/share/moin/wiki/htdocs'</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1262 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1263 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1264 <p> Path to moin shared files. If you used <tt>--prefix</tt> install, the default path will not work, and you must set the path to <tt>'PREFIX/share/moin/wiki/htdocs'</tt>. </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1265 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1266 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1267 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1268 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1269 <p> user </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1270 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1271 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1272 <p> <tt>'www-data'</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1273 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1274 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1275 <p> If you run as root, the server will run with as this user </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1276 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1277 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1278 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1279 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1280 <p> group </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1281 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1282 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1283 <p> <tt>'www-data'</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1284 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1285 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1286 <p> If you run as root, the server will run with as this group </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1287 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1288 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1289 <tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1290 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1291 <p> port </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1292 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1293 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1294 <p> <tt>8000</tt> </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1295 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1296 <td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1297 <p> Port to serve. To serve privileged port under 1024 you will have to run as root </p>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1298 </td>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1299 </tr>
d0250ed0cd53 make interwiki underlay install-docs
Thomas Waldmann <tw@waldmann-edv.de>
parents: 176
diff changeset
1300 <tr>