Changes between Initial Version and Version 1 of MoinInstall

05/08/06 13:34:25 (12 years ago)



  • MoinInstall

    v1 v1  
     1A huge variety of Wiki software exists, each package having different features and system requirements. I chose [ 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). [ MediaWiki] also provides a good user experience but has higher system requirements that I considered unnecessary. 
     3== Installation Procedure == 
     4I downloaded the tar file and build an rpm according to instructions at 
     7wget '' 
     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 
     13This installs the python modules and Wiki templates. I then set up an instance of the wiki as detailed at using this script: 
     17export PREFIX=/usr           
     18export SHARE=$PREFIX/share/moin 
     19export WIKILOCATION=/usr/local/moin 
     20export INSTANCE=sigwiki         
     22export USER=apache 
     23export GROUP=apache            
     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/ $INSTANCE   # copy wiki configuration sample file 
     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 
     36The final step was to set up Apache with these configuration directives 
     39# See 
     42# The system templates 
     43Alias /wiki "/usr/share/moin/htdocs/" 
     44ScriptAlias /sigwiki "/usr/local/moin/sigwiki/moin.cgi" 
     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 [ move_non-english.bash] script at . 
     50== Multiple wikis == 
     52Of course, if you want multiple wikis on one server it gets more complicated. The installation guide is 
     53at but basically you create one shared configuration `` 
     54and then set a few variables in a separate `` file and create only the `mywiki/data/` directory. 
     56== Using pubcookie == 
     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. 
     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" 
     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 
     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