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

[[http://www.sqlalchemy.org|SQLAlchemy (0.5)]]

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

[[http://jinja.pocoo.org/2/|Jinja2]]

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

[[http://werkzeug.pocoo.org|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.