Table of Contents

Installing Zine

Here are some notes I made while installing Zine on OS X Server 10.6.2

First caveat to these notes is that I had already installed a replacement Python readline and iPython.

Requirements

SQLAlchemy (0.5)

This is the database abstraction layer. SQLAlchemy installs with a 'sudo easy_install sqlalchemy'. This picked up 0.5.7.

Jinja2

The template engine from the guys that wrote Zine. Once again an easy_install got me 2.2.1

Werkzeug

The WSGI module from the same guys. easy_install again. Version 0.5.1

Well, this is getting tedious. Suffice to say that html5lib, pytz, Babel and lxml all go on using easy_install with no problems.

We also need to install 'flup' for FastCGI support. Once again, easy_install.

Installing

I followed the install instructions, sort of. I downloaded the package and moved the untarred folder into my Documents folder. From there I ran

./configure –prefix /usr/local && make install

(Rather than /usr - I felt /usr/local was 'safer')

Create The Blog

I then created a folder /Library/WebServer/Documents/zine/test and made it world readable, group writeable and world executable. Changed ownership to root:_www

Copy the file zine.fcgi into it and make it world executable.

Edit zine.fcgi and change 'INSTANCE_FOLDER'

Configuring OS X Server

In Server Admin go to the 'Web' section and 'Sites'. Add a new site. Change the Port away from 80, I used 800. Then hit the “Choose…” button on the Web Folder and point it at the folder we created above.

Add 'zine.fcgi' as a Default Index File.

Now under 'Options' turn on CGI Execution.

Configuring Zine

Point your browser at http://127.0.0.1:800/zine.fcgi

This should reveal the Zine setup page and we are away. The only thing to note is that I used SQLite.