<<TableOfContents>>
----

= die Debian-Ecke =
 * aktuelle moin Pakete und apache aus etch installieren: {{{
apt-get install apache moinmoin-common python-moinmoin
}}}
 * evtl. noch das fastcgi Modul für den apache bzw. die freie fcgid Variante: {{{
apt-get install libapache-mod-fcgid
}}}
  * in der moin.conf wird dafür ein entsprechender ''AddHandler'' eingetragen (siehe unten)
  * beim apache2 wird das Modul (libapache2-mod-fcgid) so aktiviert: {{{
a2enmod fcgid
}}}

= Vorlagen einrichten =
 * die ''/etc/moin/farmconfig.py'' anpassen: {{{
        data_underlay_dir = '/usr/share/moin/underlay'
        url_prefix = '/moin-base'
        allowed_actions aktivieren
        mail_smarthost = 'mail.sao'
        mail_from = 'wikis-noreply@admin.systemausfall.org'
        show_hosts = 0
        chart_options = None
        shared_intermap = '/data/moin/intermap.txt'
        auth_http_enabled = 1
        page_front_page = 'Start'
        nonexist_qm = 1}}}
 * ausserdem muss in der Definition der Variable "wikis" folgende Zeile eingefügt werden:{{{
        # MARKER4NEWWIKI}}} (für die automatisierte Wiki-Einrichtung)

 * die Muster-Konfiguration ''/etc/moin/moinmaster.py'' anpassen: {{{
        unique_name = 'WIKINAME'
        sitename = 'WIKINAME'
        interwikiname = 'WIKINAME'
        data_dir = '/data/moin/sites/' + unique_name

        # theme_default = 'rightsidebar'

        # page_front_page = 'HautpSeite'

        # attachments = { 'dir': data_dir + '/uploads',
        #               'url': '/moin-uploads/' + unique_name } }}}

 * dabei ist ''WIKINAME'' exakt so gemeint, wie es dort steht - das ist für das spätere Einrichtungs-Skript erforderlich

= unsere wiki-Verzeichnisstruktur =
{{{
mkdir /data/moin
mv /etc/moin /data/moin/config
ln -s /data/moin/config /etc/moin
mv /usr/share/moin/data/intermap.txt /data/moin}}}

 * dort koennen sicherlich einige raus:{{{
apt-get install libapache-mod-fcgid   (leider aus non-free)
chown -R www-data /usr/share/moin/underlay}}}
 * notwendig, weil moin dort auch was mit cache-Dateien tun will:{{{
mkdir /data/moin/sites}}}
 * unser zukuenftiges Wiki-Datenverzeichnis{{{
mkdir /data/moin/htaccess-conf.d}}}
 * dort kommen die http-auth-Informationen und das ScriptAlias fuer jedes Wiki rein

= apache-Konfiguration =
 * eine neue ''/etc/apache/conf.d/moin.conf'' mit folgendem Inhalt anlegen: {{{
Alias           /moin-base      /usr/share/moin/htdocs

AliasMatch      /moin-uploads/([^/]*)/(.*)      /data/moin/sites/$1/uploads/$2
# ScriptAliasMatch ^/wikis/[^/]+/?(.*) /usr/share/moin/server/moin.fcg/$1
# geschickt, aber nicht fuer unseren gemischten moin/usemod-Server geeignet :)
# ich lasse es mal als Beispiel stehen

AddHandler fcgid-script .fcg
Include /data/moin/htaccess-conf.d }}}

 * außerdem fehlt noch eine Vorlage für die htaccess-Datei eines Wikis: ''/data/moin/htaccess.sample'' {{{
ScriptAliasMatch        /wikis/WIKINAME(/.*)?$  /usr/share/moin/server/moin.fcg$1

<LocationMatch /wikis/WIKINAME(/.*)?$>
        AuthName         systemausfall.org
        AuthType         Basic
        AuthLDAPUrl      ldap://ldap.sao/o=neofaxe,dc=systemausfall,dc=org?cn?sub?(objectClass=webAccount)
        AuthLDAPGroupAttribute          userOfService
        AuthLDAPGroupAttributeIsDN      On
        #require          group cn=WIKINAME,sc=wiki,ou=Services,o=neofaxe,dc=systemausfall,dc=org
</LocationMatch> }}}