installing MoinMoin on OS X
An install report of a succesfull install on a powermac G4 running mac OS X 10.2.6. In the examples you will see that the machine name is pm142 and the administrator account is giels. The wiki site that is created is called mgwiki.
before you begin
You should have activated the root user
You must not be afraid to use the terminal
- some practice with the pico editor might be useful as well
download
Download the source on the desktop: you should see a moin-x.x.tar.gz file. Extract this file on the desktop with Stuffit. You will get a folder moin-x.x.
install
All code examples are taken form a terminal session.
First check everything:
[pm142:~] giels% su root Password: [pm142:/Users/giels] giels# whoami root [pm142:/Users/giels] giels# python -c 'import sys; print sys.prefix' /usr [pm142:/Users/giels] giels# [pm142:/Users/giels] giels# cd Desktop/moin-1.0 [pm142:giels/Desktop/moin-1.0] giels# ls -al total 264 drwxr-xr-x 15 giels staff 510 May 10 2002 . drwxr-xr-x 9 giels staff 306 May 12 19:39 .. -rw-r--r-- 1 giels staff 19118 May 10 2002 CHANGES -rw-r--r-- 1 giels staff 17992 Jun 9 2001 COPYING -rw-r--r-- 1 giels staff 42827 May 9 2002 INSTALL.html -rw-r--r-- 1 giels staff 837 Feb 27 2002 MANIFEST.in drwxr-xr-x 37 giels staff 1258 May 10 2002 MoinMoin -rw-r--r-- 1 giels staff 553 May 10 2002 PKG-INFO -rw-r--r-- 1 giels staff 5831 Apr 17 2002 README -rw-r--r-- 1 giels staff 908 Jan 16 2002 TODO drwxr-xr-x 5 giels staff 170 May 10 2002 contributions -rw-r--r-- 1 giels staff 13878 Jul 5 2001 moinlogo.bmp -rw-r--r-- 1 giels staff 229 Jul 5 2001 setup.cfg -rw-r--r-- 1 giels staff 6586 May 9 2002 setup.py drwxr-xr-x 5 giels staff 170 May 10 2002 wiki [pm142:giels/Desktop/moin-1.0] giels#
the real install:
[pm142:giels/Desktop/moin-1.0] giels# python setup.py install --record=install.log running install running build running build_py creating build .... creating /usr/share/moin/htdocs/applets creating /usr/share/moin/htdocs/applets/TWikiDrawPlugin writing list of installed files to 'install.log'
Now installation is finished. You will find a file install.log on the desktop in the folder moin-x.x.
configuration
First make a copy of the original MoinMoin site:
[pm142:giels/Desktop/moin-1.0] giels# [pm142:giels/Desktop/moin-1.0] giels# egrep "^User|^Group" /etc/httpd/httpd.conf User www Group www [pm142:giels/Desktop/moin-1.0] giels# cd /usr/share/moin/ [pm142:/usr/share/moin] giels# ls -al total 0 drwxr-xr-x 5 root wheel 170 May 12 19:49 . drwxr-xr-x 44 root wheel 1496 May 12 19:49 .. drwxr-xr-x 4 root wheel 136 May 12 19:49 cgi-bin drwxr-xr-x 9 root wheel 306 May 12 19:49 data drwxr-xr-x 6 root wheel 204 May 12 19:49 htdocs [pm142:/usr/share/moin] giels# [pm142:/usr/share/moin] giels# mkdir mgwiki [pm142:/usr/share/moin] giels# cp -r data mgwiki [pm142:/usr/share/moin] giels# cp cgi-bin/* mgwiki [pm142:/usr/share/moin] giels# chown -R www.www mgwiki [pm142:/usr/share/moin] giels# chmod a+rx mgwiki/*.cgi [pm142:/usr/share/moin] giels#
Configure Apache. We'll use the pico editor:
[pm142:/usr/share/moin] giels# pico /etc/httpd/httpd.conf
Scroll to the end of the file and edit like the example below, (only the last two lines are added; use control-x to save the file):
RegisterDefaultSite </IfModule> Include /private/etc/httpd/users Alias /wiki/ "/usr/share/moin/htdocs/" ScriptAlias /mgwiki "/usr/share/moin/mgwiki/moin.cgi" ^G Get Help ^O WriteOut ^R Read File ^Y Prev Pg ^K Cut Text ^C Cur Pos ^X Exit ^J Justify ^W Where is ^V Next Pg ^U UnCut Text ^T To Spell
Restart Apache:
[pm142:/etc] giels# apachectl help
usage: /usr/sbin/apachectl (start|stop|restart|fullstatus|status|graceful|configtest|help)
start - start httpd
stop - stop httpd
restart - restart httpd if running by sending a SIGHUP or start if
not running
fullstatus - dump a full status screen; requires lynx and mod_status enabled
status - dump a short status screen; requires lynx and mod_status enabled
graceful - do a graceful restart by sending a SIGUSR1 or start if not running
configtest - do a configuration syntax test
help - this screen
[pm142:/etc] giels#
[pm142:/etc] giels# apachectl graceful
/usr/sbin/apachectl graceful: httpd gracefully restarted
[pm142:/etc] giels#
testing
In a web-browser surf to the site: pm142/mgwiki
Comments
Here are a couple of issues with my Mac OS X install I needed to fix:
The TWiki drawing jar file is not installed, so drawings do not work. You have to find the twikidraw.jar file (download the latest stable MoinMoin tar.gz file and uncompress like: tar xzvf moinmoin.tar.gz), and copy the twikidraw.jar file (under htdocs/applets/TWikiDrawPlugin) to this folder /usr/share/moin/htdocs/applets/TWikiDrawPlugin/. You'll probably need to use sudo:
sudo cp twikidraw.jar /usr/share/moin/htdocs/applets/TWikiDrawPlugin/
and set permissions:
sudo chmod 755 /usr/share/moin/htdocs/applets/TWikiDrawPlugin/twikidraw.jarThe RSS feed for your RecentChanges page may be broken. You need to install the most recent version of PyXML. Here's how I did so and the RSS feed was fixed.
curl -O http://aleron.dl.sourceforge.net/sourceforge/pyxml/PyXML-0.8.3.tar.gz
tar xzvf PyXML-0.8.3.tar.gz
cd PyXML-0.8.3
sudo python setup.py --without-xpath build
sudo python setup.py install
OS X users with a fink install need to chance the path /usr/share/moin to /sw/share/moin. see install.log.