Changes

m
rough draft
<noinclude>{{TOCright}}</noinclude>

== Sources ==

http://git.sugarlabs.org/projects/slo-activities

Branches structure:
* ''master'' branch, last ASLO codebase
* ''master-theme'' rebased to ''master'' branch, last ASLO codebase with sugar theme
* ''v<version>'' branch, released ASLO version
* ''v<version>-theme'' rebased to ''v<version>'' branch, released ASLO version with sugar theme
* ''production'' tag to last stable branch

== Install server ==
'''NOTE''' The followed instructions tested on Ubuntu 10.10(Maverick).

Install apache, mysql, and -dev packages.
sudo aptitude install apache2 libapache2-mod-wsgi mysql-server python-dev libxml2-dev libxslt1-dev libmysqlclient-dev libmemcached-dev

Create user
mkdir /srv/activities.sugarlabs.org
sudo adduser --home /srv/activities.sugarlabs.org/aslo aslo

To check out sources you need git and subversion.
sudo aptitude install git subversion

Checkout our fork.
git clone --recursive git://github.com/jbalogh/zamboni.git /srv/activities.sugarlabs.org/zamboni

Fetch external dependencies:
cd /srv/activities.sugarlabs.org/zamboni
git clone --recursive git://github.com/jbalogh/zamboni-lib.git vendor

== Set up server ==

Setup apache. Add followed lines to the end of VirtualHost section in /etc/apache2/sites-enabled file:
<VirtualHost *:80> #
ServerName aslo1.rit.edu
WSGIScriptAlias / /srv/activities.sugarlabs.org/zamboni/wsgi/zamboni.wsgi
WSGIDaemonProcess zamboni processes=8 threads=1
WSGIProcessGroup zamboni
Alias /media "/srv/activities.sugarlabs.org/zamboni/media"
<location "/media/">
SetHandler None
Order deny,allow
Allow from all
</location>
<Directory /srv/activities.sugarlabs.org/zamboni>
Order deny,allow
Allow from all
</Directory>
# <locationmatch "\.(jpg|gif|png)$">
# SetHandler None
# </locationmatch>
</virtualhost>

Setup mysql(you need to enter mysql root password for these commands).
mysqladmin -u root password remora
mysqladmin -u root -p create remora
mysql -u root -p

GRANT ALL ON *.* TO 'remora'@'localhost' IDENTIFIED BY 'remora';
exit;

To test server create /var/www/site/app/webroot/php.php:
<?php phpinfo(); ?>
Open http://a.sl.o/php in browser and make sure mysql is enabled.

== Configure ASLO ==

settings_local.py

$#$#$#$#$#$#$#$#$#
from settings import *

DEBUG = True
TEMPLATE_DEBUG = DEBUG
DEBUG_PROPAGATE_EXCEPTIONS = DEBUG

# These apps are great during development.
INSTALLED_APPS += (
'debug_toolbar',
'django_extensions',
'fixture_magic',
)

# You want one of the caching backends. Dummy won't do any caching, locmem is
# cleared every time you restart the server, and memcached is what we run in
# production.
# CACHE_BACKEND = 'caching.backends.memcached://localhost:11211?timeout=500'
# CACHE_BACKEND = 'caching.backends.locmem://'
CACHE_BACKEND = 'dummy://'

DATABASES = {
'default': {
'NAME': 'zamboni',
'ENGINE': 'django.db.backends.mysql',
'USER': 'zamboni',
'PASSWORD': 'remora',
'OPTIONS': {'init_command': 'SET storage_engine=InnoDB'},
'TEST_CHARSET': 'utf8',
'TEST_COLLATION': 'utf8_general_ci',
},
}

LOG_LEVEL = logging.DEBUG
HAS_SYSLOG = False

# For debug toolbar.
if DEBUG:
INTERNAL_IPS = ('127.0.0.1',)
MIDDLEWARE_CLASSES += ('debug_toolbar.middleware.DebugToolbarMiddleware',)
DEBUG_TOOLBAR_CONFIG = {
'HIDE_DJANGO_SQL': False,
'INTERCEPT_REDIRECTS': False,
}

# If you're not running on SSL you'll want this to be False.
SESSION_COOKIE_SECURE = False

# Run tasks immediately, don't try using the queue.
CELERY_ALWAYS_EAGER = True

#@#@#@#@#@#@#@@#


cd /var/www
aslo/db-create-stub.sh

Open a.sl.o in browser. To login use:
''login'' admin@sugarlabs.org
''password'' test

== Optional steps ==

====Install php-memcache====

<code>
yum install php-devel gcc zlib-devel

pecl install memcache
vim /etc/php.ini
</code>

You should add "extension=memcache.so" to php.ini

<code>
service httpd restart
</code>


== TODO ==
2,751

edits