TWikiOnMacOSXLeopard

Manual installation

apache2 webserver

• Start Leopard's apache2 httpd daemon:

$ sudo apachectl start

or check System Preferences --> Sharing --> Web Sharing

• Browse to http://127.0.0.1 - It should say "It works!"

Installing TWiki

• DownloadTWiki (I used TWikiRelease04x02x02)

$ sudo mkdir /Library/WebServer/Documents/twiki
$ sudo cp whereveryouputit/TWiki-4.2.2.tgz /Library/WebServer/Documents/twiki
$ cd /Library/WebServer/Documents/twiki
$ sudo tar xzvf TWiki-4.2.2.tgz
$ cd ..
$ sudo chown -R www:www twiki

• Browse to http://127.0.0.1/twiki/INSTALL.html
• Continue following the basic installation, step 4:
  • Copy and edit bin/LocalLib.cfg
  • Copy twiki_httpd_conf.txt to /etc/apache2/other/twiki.conf
  • Replace all home/httpd with Library/WebServer/Documents/twiki, leave the other parts of the paths intact
  • Comment out twiki.conf, line 125 (php_admin_flag)
• When done, check webserver configation

$ sudo apachectl configtest

• Restart webserver

$ sudo apachectl restart

• It's always a good idea to check the apache logfile if anything is not working as expected:

$ tail -f /var/log/apache2/error_log 

• Fire up the configure tool at http://127.0.0.1/twiki/bin/configure
  • Hit 'next', enter password
  • Go back to configure
  • Check warnings:
    • Security: Safe path is /bin:/usr/bin
    • grep path is /usr/bin/grep
  • Save changes
• Have fun with http://127.0.0.1/twiki/bin/view
  • Go to http://127.0.0.1/twiki/bin/view/Main/TWikiAdminGroup

Installer package

I created a first installer package that can be downloaded here.

The package contains

• TWiki-4.2.2 installed at /Library/WebServer/Documents/twiki
• twiki.conf copied to /private/etc/apache2/other
• First configure run, fixed secure path, fixed grep path
• configure password is empty and has to be set by user!

This package is considered beta. I works on my machine (tm). Use at your own risk and please provide feedback.

-- Contributors: MatthiasWientapper - 16 Aug 2008

Discussion

Why not use the apache2 that comes with OSX Leopard? it seems a bit weird to install a second webserver/

-- SvenDowideit - 16 Aug 2008

Errrm, yes - Good point. I was not aware of OSX Leopard coming already with apache installed. (It's my first mac...) I fixed the description - Thanks.

-- MatthiasWientapper - 16 Aug 2008

1. Be careful when replacing all home/httpd above. The very FIRST entry in the twiki.conf file for ScriptAlias? should be /Library/WebServer/Documents/twiki/bin/.
2. There is no "others" directory. It should be other
3. My version of twiki/bin/LocalSite.cfg is actually called twiki/bin/LocalLib.cfg

-- DuaneTharp - 17 Aug 2008

Regarding 1: If only home/httpd is replaced (without the leading and trailing slashes and without modifying the rest of the path) you should be fine.

• e.g. / home/httpd /twiki/bin --> / Library/WebServer/Documents /twiki/bin

Regarding 2: fixed

Regarding 3: fixed

-- MatthiasWientapper - 18 Aug 2008

Everything here seems to be working just fine except I get 52 RCS errors suggesting that I should use RCSLite instead. Should I? And the other thing is I get an error when attempting to register a new user with the error message of: There has been a problem adding your user id to the Password system. And the user is not registered, and I get no entries in the .htpasswd file.

-- DaveHorne - 21 Sep 2008

I have it running using RCS.

-- ArthurClemens - 10 Oct 2008

Before I installed the optional Developer Tools from the Leopard DVD, I got the RCS errros and had to go with RCSLite. Once I installed them, I was able to switch to RCS (RCSWrapper in the menu).

-- RichardBondi - 14 Oct 2008