UserPreferences

HelpOnInstalling/ApacheOnMacOsx


The following 272 words could not be found in the dictionary of 550 words (including 550 LocalSpellingWords) and are highlighted below:

account   activated   added   administrator   afraid   al   aleron   Alias   All   An   and   Apache   apachectl   applets   Apr   are   as   be   before   begin   below   bin   bmp   broken   build   by   called   cd   cfg   chance   Changes   check   chmod   chown   code   Comments   conf   configtest   configuration   Configure   contributions   control   copy   couple   cp   created   creating   Cur   curl   Cut   data   Default   Desktop   desktop   did   dl   do   download   Download   Draw   drawing   drawings   drwxr   dump   edit   editor   egrep   enabled   end   etc   everything   example   examples   Exit   Extract   Feb   feed   File   file   files   find   finished   fink   First   fix   fixed   folder   for   form   full   fullstatus   G4   get   Get   giels   graceful   gracefully   Group   gz   have   help   Help   Here   how   htdocs   httpd   if   If   import   in   In   Include   install   installation   installed   installing   is   issues   Jan   jar   Jul   Jun   Justify   last   latest   like   lines   list   ll   log   ls   lynx   mac   Mac   machine   make   mgwiki   might   mkdir   mod   Module   moinlogo   most   must   my   name   need   needed   net   Next   not   Now   of   on   only   or   original   Out   page   Password   path   permissions   Pg   pico   Plugin   pm142   Pos   powermac   practice   prefix   Prev   print   private   probably   projects   python   pyxml   R1   Read   real   Recent   recent   record   Register   report   requires   restart   Restart   restarted   root   running   rw   rx   save   sbin   screen   Script   Scroll   see   sending   session   set   setup   share   short   should   site   Site   so   some   source   sourceforge   Spell   stable   staff   start   status   stop   Stuffit   su   succesfull   sudo   surf   sw   syntax   sys   taken   tar   terminal   test   testing   Text   that   The   the   this   to   To   total   twikidraw   two   Un   uncompress   under   usage   use   useful   User   user   Users   users   usr   version   was   We   web   well   wheel   Where   whoami   will   with   without   work   Write   writing   xpath   xr   xzvf   You   you   your  

Clear message

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

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

  2. The RSS feed for your RecentChanges 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.