UserPreferences

Help On Installing/ Apache On Mac Osx


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

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 Moin Moin 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:

  1. 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 Moin Moin 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.jar

  2. The RSS feed for your Recent Changes page may be broken. You need to install the most recent version of [WWW]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.