Activity Library/Devel/Installing

From Sugar Labs
Jump to navigation Jump to search

Over the last several months, there have been on and off discussions about how to adapt the server software to manage Sugar activities.


Information about Remora, the codename for a.m.o version 3, is at

Why base a.s.o on a.m.o


  • The function of a.m.o is exactly the same as the desired functionality of a.s.o.


  • A.m.o is currently only used by mozilla.
  • A.m.o is written in cake-php (yet another web framework)


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 9.04(Jaunty).

Install apache, php and mysql.

sudo apt-get install apache2 mysql-server
sudo apt-get install php5 php5-dev php5-gd php5-cli php-pear php5-mysql

Install required php modules.

pear config-set preferred_state beta 
pear install Archive_Zip

To check out sources you need git and subversion.

sudo apt-get install git subversion

Checkout our fork.

git-clone git:// /var/www

Fetch external dependencies:

cd /var/www/site/vendors/
svn co
svn co fizzypop
svn co
svn co

Set up server

Setup apache. Add followed lines to the end of VirtualHost section in /etc/apache2/sites-enabled file:

DocumentRoot /var/www/site/app/webroot
<Directory /var/www/>AllowOverride All</Directory>

Enable all apache mods.

cd /etc/apache2/mods-enabled
ln -s ../mods-available/* .

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';

Add our server to /etc/hosts file.

To test server create /var/www/site/app/webroot/php.php:

<?php phpinfo(); ?>

Open in browser and make sure mysql is enabled.

Configure ASLO

cd /var/www

Open in browser. To login use:

password test

Optional steps

Install php-memcache

yum install php-devel gcc zlib-devel

pecl install memcache
vim /etc/php.ini

You should add "" to php.ini

service httpd restart

Install memcached

rpm -Uhv
yum install memcached
service memcached start
chkconfig --levels 235 httpd on


  • Fix search
  • Fix downloads
  • Lots of testing, debugging and fixing
  • Upstream all patches that can make easier future rebases (and have a chance of being accepted)
  • Translate our new strings
  • Change the design accordingly to the Sugar image