Configuring moin as a regular CGI script or with mod_python
===========================================================

Note: the preferred way to use moin is as a dynamic FastCGI application using
mod_fcgid - see fastcgi/README.fastcgi

Steps to setup moin for your apache server:

#!/bin/sh
DESTDIR=/var/www/mywiki
mkdir -p $DESTDIR/cgi-bin
cp -a /usr/share/moin/{data,underlay} $DESTDIR
cp -a /usr/share/moin/server/moin.cgi $DESTDIR/cgi-bin
cp -a /usr/share/moin/config/wikiconfig.py $DESTDIR/cgi-bin
chown -R apache:apache $DESTDIR/{data,underlay}
cat > /etc/httpd/conf.d/mywiki.conf <<EOF
ScriptAlias /mywiki "$DESTDIR/cgi-bin/moin.cgi"
<Directory "$DESTDIR/cgi-bin/">
    Options Indexes FollowSymLinks ExecCGI
    AllowOverride None
    Order allow,deny
    Allow from all
</Directory>
# To use mod_python disable all above, enable the following lines and
# also change wikiconfig.py to have absolute paths for data/underlay dirs.
#
#Alias /moin_static163 "/usr/share/moin/htdocs/"
#
#<Directory "/usr/share/moin/htdocs/">
#    Options Indexes FollowSymLinks
#    AllowOverride None
#    Order allow,deny
#    Allow from all
#    <IfModule mod_expires.c>
#         ExpiresActive On
#         ExpiresDefault "access plus 1 year"
#    </IfModule>
#</Directory>
#
#<Location /mywiki>
#    SetHandler python-program
#    PythonPath "['$DESTDIR/cgi-bin'] + sys.path"
#    PythonHandler MoinMoin.request.request_modpython::Request.run
#</Location>
EOF

Then edit /etc/httpd/conf/httpd.conf to include "AddHandler cgi-script .cgi"
and edit /var/www/mywiki/cgi-bin/wikiconfig.py and finally do
a "service httpd restart".

SELinux users should fix the context of the wiki files so that httpd can
access them:
# cd /var/www/mywiki
# chcon -R -t httpd_sys_script_rw_t data underlay
# chcon -R -t httpd_sys_script_exec_t cgi-bin
To use mod_python, it's necessary to set the httpd_builtin_scripting boolean:
# setsebool -P httpd_builtin_scripting 1


Upgrading from previous versions
================================

See README.migration for full details. You will need to run one or more
migration scripts.

To upgrade from a pre-1.5.3 version, or from a wiki created using moin 1.5.3,
you will need to run one or more "old-style" migration scripts, ending with
152_to_1050300.py. This is done as follows:

# cd /var/www/mywiki
(substitute the actual location of your wiki instance for /var/www/mywiki)

# runuser -s /bin/sh -c "python /usr/lib/python2.*/site-packages/MoinMoin/script/old/migration/152_to_1050300.py" apache
(use the same approach to run any migration scripts, in order, as indicated in
README.migration; 152_to_1050300.py should be the *last* one)

For a wiki previously updated to 1.5.3, or created in 1.5.4 or later, only one
migration script needs to be run:

# runuser -s /bin/sh -c "moin --config-dir=/var/www/mywiki/cgi-bin --wiki-url=www.example.com/mywiki/ migration data" apache
(substitute the actual location of your wiki configuration directory for
/var/www/mywiki/cgi-bin, and your wiki's URL [minus the protocol part] for
www.example.com/mywiki/)