Ubuntu Wiki

Note: It's probably best to check GoogleCode. This page is intended for ubuntu/debian installations, but may not be as up to date: https://code.google.com/p/pygowave-server/wiki/PyGoWaveServerInstallation

To install PyGoWave, you'll need the following (version listing may be incomplete):

• Python >= 2.6.1

• Django >= 1.0.2

• Orbited >= 0.7.7

• RabbitMQ >= 1.6.0

Python libraries:

• lxml >= 2.2

• PIL >= 1.1.6

• carrot >= 0.5.0, <=0.5.1

Optional:

• django-rosetta 0.4.0

• JavaScript libraries:

• MooTools 1.2

• MochaUI 0.9.5

Installing

Prepare to install

sudo apt-get install python python-pip python-dev subversion mercurial

Django

sudo apt-get install python-django python-django-registration

OR

svn co http://code.djangoproject.com/svn/django/trunk/ django-trunk
ln -s $(pwd)/django-trunk/django SITE-PACKAGES-DIR/django
ln -s $(pwd)/django-trunk/django/bin/django-admin.py /usr/local/bin

Dependencies

sudo apt-get install mysql-server python-mysqldb python-lxml python-simplejson
sudo easy_install carrot==0.5.1
sudo easy_install pil

Orbited

sudo apt-get install python-twisted
hg clone https://bitbucket.org/desmaj/orbited
cd orbited/daemon
python setup.py install

RabbitMQ

Add the repository to the end of /etc/apt/sources.list

echo 'deb http://www.rabbitmq.com/debian/ testing main' | sudo tee -a /etc/apt/sources.list

Get the keys

wget http://www.rabbitmq.com/rabbitmq-signing-key-public.asc
sudo apt-key add rabbitmq-signing-key-public.asc

Update and install

sudo apt-get update
sudo apt-get install rabbitmq-server

OR

hg clone -r rabbitmq_v1_6_0 http://hg.rabbitmq.com/rabbitmq-stomp
cd rabbitmq-stomp
make RABBIT_SERVER_INCLUDE_DIR=/usr/lib/erlang/lib/rabbitmq_server-1.6.0/include
mkdir -p /usr/lib/erlang/lib/rabbitmq-stomp
cp -R * /usr/lib/erlang/lib/rabbitmq-stomp

Install Apache2 and mod_python

sudo apt-get install apache2 libapache2-mod-python libapache2-mod-proxy-html
sudo /etc/init.d/apache2 restart

PWG

sudo mkdir -p /srv/http/
cd /srv/http
svn checkout http://pygowave-server.googlecode.com/svn/tags/alpha_0.3 pygowave_project

Configuring

Mysql

install instrunctions: http://www.zolved.com/synapse/view_content/27986/How_to_install_MySQL_On_Ubuntu

mysql -u root -p
CREATE DATABASE `pygowave`;
CREATE USER 'pygowave'@'localhost' IDENTIFIED BY 'pygowave';
GRANT ALL PRIVILEGES ON `pygowave`.* TO 'pygowave'@'localhost' WITH GRANT OPTION;

Apache2

Sample file settings is be described below as per the GoogCode

The file you need to edit is apache2.conf

sudoedit /etc/apache2/sites-available/pygowave

Add these details. Be sure to update the PythonPath with the path to your pygowave_project folder. Perhaps move the code to /var/www ?

<Location /pygowave>
  SetHandler python-program
  PythonHandler django.core.handlers.modpython
  SetEnv DJANGO_SETTINGS_MODULE settings
  PythonOption django.root /pygowave
  PythonDebug On
  PythonInterpreter pygowave_django
  PythonPath "['/srv/http/pygowave_project'] + sys.path"
</Location>

Alias /pygowave/media /srv/http/pygowave_project/media
<Location "/pygowave/media">
  SetHandler None
  Options Indexes FollowSymLinks
  Order allow,deny
  Allow from all
</Location>

ProxyRequests Off
ProxyPass /static http://localhost:9000/static
ProxyPass /tcp http://localhost:9000/tcp


# To enable images and styles in Django's admin interface you might also need the following lines:

Alias /admin/media /usr/lib/python2.6/site-packages/django/contrib/admin/media
<Directory /usr/lib/python2.6/site-packages/django/contrib/admin/media>
  Order allow,deny
  Allow from all
</Directory>
<Location "/admin/media">
  SetHandler None
</Location>

Then link the site to enable it:

cd /etc/apache2/sites-enabled
ln -s ../sites-available/pygowave

Enable the proxy mods:

cd /etc/apache2/mods-enabled
sudo ln -s ../mods-available/proxy.conf .
sudo ln -s ../mods-available/proxy.load .

And restart apache2. Make sure there's no errors:

sudo /etc/init.d/apache2 restart

Perhaps browse to it, just to be sure.

Orbit

Need to edit:

sudoedit /etc/orbited.cfg

Add the lines below:

[global]
reactor=epoll
pid.location=/var/run/orbited.pid
user=www-data
group=www-data
proxy.enabled=1

[listen]
http://localhost:9000

[access]
* -> localhost:61613

[logging]
debug=SCREEN,/var/orbited/debug.log
info=SCREEN,/var/orbited/info.log
access=SCREEN,/var/orbited/info.log
warn=SCREEN,/var/orbited/error.log
error=SCREEN,/var/orbited/error.log

enabled.default=info,access,warn,error

[loggers]
Daemon=info,access,warn,error
TCPConnection=info,access,warn,error

Change "user=" and "group=" to your Apache's user and group. This is "www-data" on some systems. Check in the /etc/apache2/envvars file.

RabbitMQ

sudoedit /etc/rabbitmq/rabbitmq-env.conf

Add the lines below

NODENAME=rabbit
NODE_IP_ADDRESS=0.0.0.0
NODE_PORT=5672

LOG_BASE=/var/log/rabbitmq
MNESIA_BASE=/var/lib/rabbitmq/mnesia

SERVER_START_ARGS='
  -pa /usr/lib/erlang/lib/rabbitmq-stomp/ebin
  -rabbit
    stomp_listeners [{"0.0.0.0",61613}]
    extra_startup_steps [{"STOMP-listeners",rabbit_stomp,kickstart,[]}]'

Double check your configuration with sudo rabbitmq-server and if there's no errors (your configuration is fine) go ahead and restart it.

sudo /etc/init.d/rabbitmq-server restart

Set persimossions, add user and change password

sudo rabbitmqctl change_password guest $RANDOM$RANDOM$RANDOM
sudo rabbitmqctl add_user pygowave_client pygowave_client
sudo rabbitmqctl add_user pygowave_server pygowave_server
sudo rabbitmqctl set_permissions pygowave_client '^[^.]+\.[^.]+\.waveop$|^wavelet.direct$' '^[^.]+\.[^.]+\.(waveop|clientop)$|^wavelet.topic$' '^[^.]+\.[^.]+\.(clientop|waveop)$|^wavelet.direct$'
sudo rabbitmqctl set_permissions pygowave_server '^[^.]+\.[^.]+\.waveop$|^wavelet_rpc_singlethread$|^wavelet\.(topic|direct)$' '^[^.]+\.[^.]+\.waveop$|^wavelet_rpc_singlethread$|^wavelet\.direct$' '^[^.]+\.[^.]+\.waveop$|^wavelet_rpc_singlethread$|^wavelet\.(topic|direct)$'

PGW

Change the settings as per your DB

sudoedit settings.py
python manage.py syncdb
chown www-data media/gadgets media/avatars pygowave_client/cache locale pygowave_client/locale

Make sure to chown the files as whatever apache is running as. Check in /etc/apache2/envvars

Start up Orbited, RabbitMQ and Apache.

./launch-pygowave-rpc

That's it !! PyGoWave Server at http://localhost/pygowave.

CategoryNeedsExpansion