Foswiki on Mac OS X Leopard

Overview

This topic provides an installation of Foswiki on MacOS 10.5.x (Leopard) and 10.6.x (Snow Leopard) under /Library/Webserver/Documents/foswiki.

---

Download Installer Package

• Foswiki-1.0.9-1.dmg: Foswiki-1.0.9-1 disk image for MacOS 10.5/10.6 ( GPG signature)
  • To verify: $ gpg --verify Foswiki-1.0.9-1.dmg.asc Foswiki-1.0.9-1.dmg

Installation Instructions

• Mount disk image
• Click Foswiki-1.0.9-1.pkg and follow installation instructions
• Point your browser to http://127.0.0.1/foswiki/bin/view and fire away

This is a basic installation, perfect for personal use on a local computer.

This installation is NOT meant to be run on a public server, accessible by everybody on the internet. In order to set the appropriate security level of your installation please refer to http://127.0.0.1/foswiki/bin/view/System/InstallationGuide.

To make the installation as simple as possible, a couple of configuration settings have already been applied by the installer:

• LoginManager and EnableNewUserRegistration have been switched off
• Adjusted some pathes
• To change your configuration point your browser to http://127.0.0.1/foswiki/bin/configure
• Configure password is set to foswiki

-- MatthiasWientapper

---

Troubleshooting

Error: Can't install extensions (Insecure dependency in open while running with -T switch)

The fix is to update CPAN and CPAN:IO::File:

1. Run sudo cpan Bundle::CPAN IO::File (entering your super user password)
2. Restart the web server, return back to configure and repeat the install steps

(See Tasks.Item786)

Leopard problems continued

By ArthurClemens - 01 Mar 2009

The Mac OS security update has broken perl, and it broke cpan so that you cannot use it to update CPAN:IO::File. The solution I have followed (with advice on IRC):

1. Use MacPorts to install a separate version of perl: sudo port install perl5.8
2. Let Foswiki use the new perl location with the tools script rewriteshebang.pl:
   • cd yourinstallation/bin
   • sudo perl ../tools/rewriteshbang.pl
     • Enter /opt/local/bin/perl
   • cd yourinstallation/tools
   • sudo perl rewriteshbang.pl
     • Enter /opt/local/bin/perl
3. Set CPANBASE in bin/LocalLib.cfg to empty: $CPANBASE = '...';

Error: Can't install extensions (Undefined subroutine &Compress::Zlib::gzopen)

• Install LWP: sudo port install p5-libwww-perl
• See Tasks.Item1178

Further instructions (I have not tested them): cpan does not wok - Undefined subroutine &Compress::Zlib::gzopen

Install Zlib.pm from http://search.cpan.org/~pmqs/Compress-Zlib/ and copy to your lib.

Making your Foswiki automatically findable by bonjour

If you would like your Foswiki to be findable by bonjour, for example from the bonjour section in Safari's bookmarks window, you can add a directive to your foswiki apache config file:

<IfModule bonjour_module>
    RegisterResource "My Foswiki" "/foswiki/bin/view" 80
</IfModule>

Note, the bonjour apache module in Leopard is broken, and doesn't let you register multiple resources. If you need this ability, see http://habilis.net/mod-bonjour-fix/ for a fixed module.

-- GavinBaker - 20 Jul 2009

-- Authors: MatthiasWientapper, WillNorris