setting-up-a-pylowiki-site

Setting up a pylowiki site ……………………………..

This page will outline the steps needed to setup a production pylowiki site.

If you are interested in running a demo or local version of pylowiki, check out the minimal pylowiki setup instructions </pylowiki#installation-and-setup>_.

In this tutorial we will be configuring pylowiki to run:

• on ubuntu linux
• as a wsgi application
• with an apache2 webserver
• in a python virtualenv
• with a mysql database backend

.. contents::

Get the Pylowiki sourcecode

The pylowiki sourcecode is hosted at bitbucket.org. You will need mecurial (hg) revision control to download the source.

For debian or ubuntu

.. code-block:: shell

sudo apt-get install mercurial

Once you have mercurial you need to clone the pylowiki sourcecode

.. code-block:: shell

hg clone http://bitbucket.org/russellballestrini/pylowiki

mv pylowiki mysite

Now you should have the sourcecode in local filesystem. You might want to come up with a workflow to maintain your changes and still accept revisions from the upstream pylowiki repository. I’ll leave that up to you.

Fix file permissions

The web server account only needs access to a few directories. All the other files may be owned by your id.

Run the following commands from the root of your Pylowiki project directory to correct permissions.

.. code-block:: apache

mkdir egg-cache data

sudo chgrp -R www-data pylowiki/public/attachment sudo chmod -R 774 pylowiki/public/attachment

sudo chgrp -R www-data egg-cache sudo chmod -R 774 egg-cache

sudo chgrp -R www-data data sudo chmod -R 774 data

Get a Pylons virtual environment

Official Pylons setup notes: http://pylonshq.com/docs/en/1.0/gettingstarted/

.. code-block:: apache

wget http://www.pylonshq.com/download/1.0/go-pylons.py

python go-pylons.py virtpy

To enable the virtual environment run:

.. code-block:: apache

source virtpy/bin/activate

Install your Pylowiki application

Make sure your currently inside your virtual python environment. Your shell should look like this:

.. code-block:: php

(virtpy)user@host$ python setup.py develop

Notice the (virtpy)? The above command will install Pylowiki and all its dependencies into your virtual pythons site-lib.

Configure Pylowiki - prod.ini

The following command should be run in the root of your pylowiki project. This will create a configuration ini named prod.ini:

.. code-block:: php

(virtpy)user@host$ paster make-config Pylowiki prod.ini

Open prod.ini for editing and make changes to reflect your environment. Database settings, public wiki registration, all the tweak-able settings are declared in the ini.

Prepare mySQL Database

Login to mySQL as root.

.. code-block:: mysql

mysql -u root -p

mysql>

CREATE DATABASE mysite

GRANT ALL PRIVILEGES ON mysite.* TO username@localhost IDENTIFIED BY ‘passw0rd’ WITH GRANT OPTION

Now make sure the prod.ini reflects these database settings:

.. code-block:: ini

sqlalchemy.url = mysql://username:password@127.0.0.1/mysite?charset=utf8 sqlalchemy.pool_recycle = 3600

Now we can let Pylowiki create all the database tables by issuing the following command:

.. code-block:: php

(virtpy)user@host$ paster setup-app prod.ini

Configure mod_wsgi dispatch file

First step is to create the mod_wsgi dispatch file.

From the root directory of the Pylowiki project, create a dispatch.wsgi file with the following content:

.. code-block:: python

# Add the virtual Python environment site-packages directory to the path import sys sys.stdout = sys.stderr

import site site.addsitedir(‘/absolute/path/to/virtpy/lib/python2.6/site-packages’)

# Avoid [Errno 13] Permission denied: '/var/www/.python-eggs' messages import os os.environ[‘PYTHON_EGG_CACHE’] = ‘/absolute/path/to/pylowiki/egg-cache’

# Load the Pylons application from paste.deploy import loadapp application = loadapp(‘config:/absolute/path/to/pylowiki/prod.ini’)

Configure apache2 virtualhost

Create a domain file under /etc/apache2/sites-enabled.

.. code-block:: apache

sudo vi 002-mysite

#mysite.net

#pylons embeded mod_wsgi <VirtualHost *:80> ServerName www.mysite.net ServerAlias mysite.net ServerAdmin admin@mysite.com

# ReWrite URL to WWW
    RewriteEngine On
    RewriteCond %{HTTP_HOST} ^mysite.net
    RewriteRule (.*) http://www.mysite.net$1 [R=301,L]

    # Log Files
    ErrorLog /var/log/apache2/error-mysite.log
    CustomLog /var/log/apache2/access-mysite.log combined

    # Setup mod_wsgi
    WSGIScriptAlias / /absolute/path/to/pylowiki/dispatch.wsgi

Restart the apache2 service:

.. code-block:: apache

sudo service apache2 restart

foxhop — Oct 08, 2010 03:23 pm

Please contribute to this installation documentation.