==========================
setting-up-a-pylowiki-site
==========================


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.