HelpOnInstalling/ApacheOnMacOsx

From BRF-Software
Jump to navigation Jump to search

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:

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