Differences between revisions 3 and 4
Revision 3 as of 2005-02-05 00:19:48
Size: 4110
Editor: GuyHarris
Comment:
Revision 4 as of 2008-04-12 17:51:23
Size: 4130
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 9: Line 9:
This page describes the installation procedure applying to MoinMaster:MoinMoin version 1.1 and up. In the next section, there is a list of real-world [#installscenarios Installation Scenarios] that help you to understand how to apply the instructions in different environments. This page describes the installation procedure applying to MoinMaster:MoinMoin version 1.1 and up. In the next section, there is a list of real-world [[#installscenarios|Installation Scenarios]] that help you to understand how to apply the instructions in different environments.
Line 11: Line 11:
[#basic-install Basic Installation] explains the "`setup.py`" step of the installation in more detail. This applies equally to all scenarios, and you should read it before trying a live installation. [[#basic-install|Basic Installation]] explains the "`setup.py`" step of the installation in more detail. This applies equally to all scenarios, and you should read it before trying a live installation.
Line 13: Line 13:
[#trouble-shooting Trouble-shooting] helps with fixing any general problems you might encounter, which apply to any installation platform. [[#trouble-shooting|Trouble-shooting]] helps with fixing any general problems you might encounter, which apply to any installation platform.
Line 20: Line 20:
[[Anchor(installscenarios)]] <<Anchor(installscenarios)>>
Line 26: Line 26:
 * [#unix-install UNIX Installation]  * [[#unix-install|UNIX Installation]]
Line 29: Line 29:
 * [#win32apache-install Windows Installation using Apache]
 * [#win32iis-install Windows Installation using IIS]
 * [[#win32apache-install|Windows Installation using Apache]]
 * [[#win32iis-install|Windows Installation using IIS]]
Line 33: Line 33:
 * [#macosx-install Mac OS X Installation]  * [[#macosx-install|Mac OS X Installation]]
Line 36: Line 36:
 * [#fastcgi-install FastCGI Setup using Apache]
 * [#modpy-install mod_python Setup using Apache]
 * [#twisted-install Setup using twisted]
 * [[#fastcgi-install|FastCGI Setup using Apache]]
 * [[#modpy-install|mod_python Setup using Apache]]
 * [[#twisted-install|Setup using twisted]]
Line 40: Line 40:
[[Anchor(basic-install)]]
[[Include(HelpOnInstalling/BasicInstallation)]]
<<Anchor(basic-install)>>
<<Include(HelpOnInstalling/BasicInstallation)>>
Line 43: Line 43:
[[Anchor(trouble-shooting)]] <<Anchor(trouble-shooting)>>
Line 45: Line 45:
[[Include(HelpOnInstalling/TroubleShooting, "Trouble-shooting", 1)]] <<Include(HelpOnInstalling/TroubleShooting, "Trouble-shooting", 1)>>
Line 47: Line 47:
[[Anchor(unix-install)]] <<Anchor(unix-install)>>
Line 49: Line 49:
[[Include(HelpOnInstalling/ApacheOnUnix, "UNIX Installation", 1)]] <<Include(HelpOnInstalling/ApacheOnUnix, "UNIX Installation", 1)>>
Line 51: Line 51:
[[Anchor(win32apache-install)]] <<Anchor(win32apache-install)>>
Line 53: Line 53:
[[Include(HelpOnInstalling/ApacheOnWin32, "Windows Installation using Apache", 1)]] <<Include(HelpOnInstalling/ApacheOnWin32, "Windows Installation using Apache", 1)>>
Line 55: Line 55:
[[Anchor(win32iis-install)]] <<Anchor(win32iis-install)>>
Line 57: Line 57:
[[Include(HelpOnInstalling/InternetInformationServer, "Windows Installation using IIS", 1)]] <<Include(HelpOnInstalling/InternetInformationServer, "Windows Installation using IIS", 1)>>
Line 59: Line 59:
[[Anchor(macosx-install)]] <<Anchor(macosx-install)>>
Line 61: Line 61:
[[Include(HelpOnInstalling/ApacheOnMacOsx, "Mac OS X Installation using Apache", 1)]] <<Include(HelpOnInstalling/ApacheOnMacOsx, "Mac OS X Installation using Apache", 1)>>
Line 63: Line 63:
[[Anchor(fastcgi-install)]] <<Anchor(fastcgi-install)>>
Line 65: Line 65:
[[Include(HelpOnInstalling/ApacheWithFastCgi, "FastCGI Setup using Apache", 1)]] <<Include(HelpOnInstalling/ApacheWithFastCgi, "FastCGI Setup using Apache", 1)>>
Line 67: Line 67:
[[Anchor(modpy-install)]] <<Anchor(modpy-install)>>
Line 69: Line 69:
[[Include(HelpOnInstalling/ApacheWithModPython, "mod_python Setup using Apache", 1)]] <<Include(HelpOnInstalling/ApacheWithModPython, "mod_python Setup using Apache", 1)>>
Line 71: Line 71:
[[Anchor(twisted-install)]] <<Anchor(twisted-install)>>
Line 73: Line 73:
[[Include(HelpOnInstalling/TwistedWeb, "Setup using Twisted", 1)]] <<Include(HelpOnInstalling/TwistedWeb, "Setup using Twisted", 1)>>

This HTML page contains the basic install docs that can be found on http://moinmaster.wikiwikiweb.de/MoinMoin/InstallDocs. 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.

After following the procedures on this page, you should have a working wiki and can browse the rest of the online docs there.

How to install your own MoinMoin Wiki

This page describes the installation procedure applying to MoinMoin version 1.1 and up. In the next section, there is a list of real-world Installation Scenarios that help you to understand how to apply the instructions in different environments.

Basic Installation explains the "setup.py" step of the installation in more detail. This applies equally to all scenarios, and you should read it before trying a live installation.

Trouble-shooting helps with fixing any general problems you might encounter, which apply to any installation platform.

After a successful installation, you might want to read more about configuration and other options that you, as the wiki administrator, can set up. HelpOnAdministration contains links to pages that cover these topics. Especially, the HelpOnConfiguration and HelpOnUpdating pages provide additional information regarding wiki setup and maintenance. MoinMoinWinCvs and MoinMoinUnixCvs describe how to run your wiki using the current development version from the SourceForge CVS repository.

Please make sure that you do not accidently put your wiki's data/ directory under a directory directly accessible by your web server (like below document root). Or at least forbid your web server serving anything below data/ to a user - this is neither needed nor wanted! Your web server needs to serve moin.cgi and the stuff below htdocs only.

Sample Installation Scenarios

The following links lead you to concrete examples of installation sessions, showing the commands used and explaining what they do. It is highly recommended that you first read the general information on installing (especially the next section of this page) before choosing an installation scenario that best fits your intended use of MoinMoin.

UNIX:

Windows:

Mac OS X:

Long-Running-Process Setup:

Basic Installation

Before you can integrate MoinMoin into your web environment, you have to do the basic installation using the standard Python distutils mechanism. We'll explain the usual steps you need to take to do this. For more details on the distutils installation process, consult the Installing Python Modules document of your Python manual.

  • /!\ NOTE: You will need the Python Development package installed on UNIX systems for distutils to work correctly.

The first step is to unpack the distribution archive, which you have done already when you loaded this instructions from your disk. If you read this on the web, the distribution comes in a versioned ZIP or TAR archive, which you can unpack in the usual ways, into a temporary directory (/tmp on UNIX, C:\TEMP on Windows). The distribution archive will always unpack into a directory named moin-<version>, for example moin-1.1. To download the distribution archive, go to the download area.

After unpacking, to install into a specific directory (C:\moin in our example), call setup.py after changing your current directory to the distribution directory. The following commands can be used to complete theses steps:

  •     unzip moin-1.1.zip
        cd moin-1.1
        python setup.py --quiet install --prefix=C:\moin

This creates the following directories in "C:\moin" (note that on a UNIX system, the directory layout will be slightly different):

  •     MoinMoin
        MoinMoin/action
        MoinMoin/formatter
        MoinMoin/i18n
        MoinMoin/macro
        MoinMoin/parser
        MoinMoin/scripts
        MoinMoin/support
        MoinMoin/twisted
        MoinMoin/webapi
        Scripts
        share
        share/moin
        share/moin/cgi-bin
        share/moin/data
        share/moin/data/backup
        share/moin/data/cache
        share/moin/data/pages
        share/moin/data/plugin
        share/moin/data/plugin/action
        share/moin/data/plugin/macro
        share/moin/data/text
        share/moin/data/user
        share/moin/htdocs
        share/moin/htdocs/css
        share/moin/htdocs/img

You will likely see the following warning:

  • warning: install: modules installed to 'C:\moin\', which is not in Python's module search path (sys.path) -- you'll have to change the search path yourself

This means exactly what it says, you need to add your install directory to the search path of Python. There are several ways to do this:

Environment variable

Change PYTHONPATH in a way that is persistent (/etc/profile.d on UNIX, AUTOEXEC.BAT on W9x, the Properties item in the context menu of My Computer on NT4 and W2K)

Apache "httpd.conf"

Use the SetEnv directive to set PYTHONPATH to a suitable value, for example:

    SetEnv PYTHONPATH "C:\moin"
"moin.cgi"
Directly add your installation directory to

the CGI driver script, like this:

    import sys
    sys.path.append('C:/moin')

If you use the following default installation command, MoinMoin will be installed to the Python directory:

  •     python setup.py --quiet install

You won't need to change your PYTHONPATH then, but depending on your system environment you might not be able to use that command, especially when you are not the root user on a UNIX system. If you don't know where your Python directory is, this command will tell you:

  •     python -c "import sys; print sys.prefix"

The directory structure we showed above will then be created in that directory. If you're interested in the exact list of files that are installed, use the --record option of distutils.



Trouble-shooting

Built-in test

There's a built-in diagnostic mode that's useful when doing an install; just append "?test" to the URL of your wiki:

lynx --dump http://`hostname`/mywiki?test

If you see an import error here, but "python -c "import MoinMoin"" works, it's likely a result of missing file permissions or a wrong PYTHONPATH setting within the web server environment.















MoinMoin/InstallDocs (last edited 2008-04-12 17:51:23 by localhost)