Changes between Initial Version and Version 1 of MoinInstall


Ignore:
Timestamp:
05/08/06 13:34:25 (12 years ago)
Author:
trac
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • MoinInstall

    v1 v1  
     1A huge variety of Wiki software exists, each package having different features and system requirements. I chose [http://moinmoin.wikiwikiweb.de/ MoinMoin ] for the SIG Wiki because it provides good support for code samples which is essential to system documentation. It is also relatively user-friendly (for example, you can set editing textbox size and custom stylesheets in UserPreferences). [http://www.mediawiki.org/ MediaWiki] also provides a good user experience but has higher system requirements that I considered unnecessary. 
     2 
     3== Installation Procedure == 
     4I downloaded the tar file and build an rpm according to instructions at http://moinmoin.wikiwikiweb.de/MoinMoinPackages 
     5 
     6{{{ 
     7wget 'http://heanet.dl.sourceforge.net/sourceforge/moin/moin-1.3.4.tar.gz' 
     8rpmbuild -tb moin-1.3.4.tar.gz  
     9rpm -Uhv /usr/src/redhat/RPMS/noarch/moin-1.3.4-1.noarch.rpm 
     10mkdir /usr/local/moin 
     11}}} 
     12 
     13This installs the python modules and Wiki templates. I then set up an instance of the wiki as detailed at http://moinmoin.wikiwikiweb.de/HelpOnInstalling/WikiInstanceCreation using this script: 
     14 
     15{{{ 
     16#!/bin/sh 
     17export PREFIX=/usr           
     18export SHARE=$PREFIX/share/moin 
     19export WIKILOCATION=/usr/local/moin 
     20export INSTANCE=sigwiki         
     21 
     22export USER=apache 
     23export GROUP=apache            
     24 
     25cd $WIKILOCATION 
     26mkdir $INSTANCE                   # make a directory for this instance 
     27cp -R $SHARE/data $INSTANCE       # copy template data directory 
     28cp -R $SHARE/underlay $INSTANCE   # copy underlay data directory 
     29cp $SHARE/config/wikiconfig.py $INSTANCE   # copy wiki configuration sample file 
     30 
     31chown -R $USER.$GROUP $INSTANCE   # check that USER and GROUP are correct 
     32chmod -R ug+rwX $INSTANCE         # USER.GROUP may read and write 
     33chmod -R o-rwx $INSTANCE          # everybody else is rejected 
     34}}} 
     35 
     36The final step was to set up Apache with these configuration directives 
     37 
     38{{{ 
     39# See http://moinmoin.wikiwikiweb.de/HelpOnInstalling/ApacheWithModPython 
     40#  
     41 
     42# The system templates 
     43Alias /wiki "/usr/share/moin/htdocs/" 
     44ScriptAlias /sigwiki "/usr/local/moin/sigwiki/moin.cgi" 
     45}}} 
     46 
     47After making sure it worked correctly, I also added a spellchecker dictionary at {{{mywiki/data/dict/en_us.ascii}}} and removed the non-English help files to speed up searches using the [http://moinmoin.wikiwikiweb.de/ScriptMarket/RemovingUnwantedLanguages?action=AttachFile&do=get&target=move_non-english.bash move_non-english.bash] script at http://moinmoin.wikiwikiweb.de/ScriptMarket/RemovingUnwantedLanguages . 
     48 
     49 
     50== Multiple wikis == 
     51 
     52Of course, if you want multiple wikis on one server it gets more complicated. The installation guide is 
     53at http://moinmoin.wikiwikiweb.de/FarmQuestions but basically you create one shared configuration `farmconfig.py` 
     54and then set a few variables in a separate `mywiki.py` file and create only the `mywiki/data/` directory. 
     55 
     56== Using pubcookie == 
     57 
     58I found it worked fine when using the mod_python backend to Moin. One gotcha is that mod_python 
     59must have full paths, where the CGI used paths relative to itself. 
     60 
     61{{{ 
     62Alias /wiki "/usr/share/moin/htdocs/" 
     63# below line not needed, using mod_python instead 
     64#ScriptAlias /sigwiki "/usr/local/data/www/moin/moin.cgi" 
     65 
     66<Location /sigwiki> 
     67    Options +FollowSymlinks 
     68    Include /etc/httpd/local_htaccess 
     69    Require valid-user 
     70    SetHandler python-program 
     71    PythonPath "['/usr/local/data/www/moin/']+sys.path" 
     72    PythonHandler MoinMoin.request::RequestModPy.run 
     73</Location> 
     74 
     75<Location /birswiki> 
     76    AuthType UWNetID 
     77    Require valid-user 
     78    Options +FollowSymlinks 
     79    SetHandler python-program 
     80    PythonPath "['/usr/local/data/www/moin/']+sys.path" 
     81    PythonHandler MoinMoin.request::RequestModPy.run 
     82</Location> 
     83}}}