Line 1: |
Line 1: |
| + | <noinclude>{{TOCright}}</noinclude> |
| + | |
| =Activities.sugarlabs.org= | | =Activities.sugarlabs.org= |
| Over the last several months, there have been on and off discussions about how to adapt the addons.mozilla.org server software to manage Sugar activities. | | Over the last several months, there have been on and off discussions about how to adapt the addons.mozilla.org server software to manage Sugar activities. |
Line 13: |
Line 15: |
| * A.m.o is written in cake-php (yet another web framework) | | * A.m.o is written in cake-php (yet another web framework) |
| | | |
− | == Installing activities.sugarlabs.org == | + | == Sources == |
| | | |
− | Mozilla.org runs a.m.o on CentOS5.0. For capability reasons these instructions will also use CentOS5.2.
| + | http://git.sugarlabs.org/projects/slo-activities |
| | | |
− | ===Install centOS5.2 as server===
| + | Branches structure: |
− | It is handy to set up a development system as a server-gui in a virtual machine.
| + | * ''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 |
| | | |
− | ===Set up Apache=== | + | == Install server == |
− | Apache is pre-installed on CentOS.
| |
| | | |
− | Configure Apache to start on system boot.
| + | '''NOTE''' The followed instructions tested on Ubuntu 9.04(Jaunty). |
| | | |
− | <code>
| + | Install apache, php and mysql. |
− | chkconfig --levels 235 httpd on
| + | sudo apt-get install apache2 mysql-server |
− | </code>
| + | sudo apt-get install php5 php5-dev php5-gd php5-cli php-pear php5-mysql |
− | | |
− | ===Create Apache test page===
| |
− |
| |
− | <code>
| |
− | vim /var/www/html/index.php
| |
− | | |
− | <?php phpinfo(); ?>
| |
− | </code>
| |
− | | |
− | ===Start Apache===
| |
− | | |
− | <code>
| |
− | service httpd start
| |
− | </code>
| |
− | | |
− | ===Install Firefox===
| |
− | | |
− | <code>
| |
− | yum install firefox
| |
− | </code>
| |
− | | |
− | ===Test 127.0.0.1===
| |
− | | |
− | verify mod_rewrite and mod_expires are loaded
| |
− | | |
− | ===Set up php===
| |
− | | |
− | look for PHP5.1.6
| |
− | | |
− | <code>
| |
− | rpm -q php | |
− | </code>
| |
− | | |
− | look for php-gettext ( in php-common)
| |
− | | |
− | <code>
| |
− | rpm -q php-common | |
− | </code>
| |
− | | |
− | install required php modules | |
− | | |
− | <code>
| |
− | yum install php-pear php-gd php-mbstring
| |
| | | |
| + | Install required php modules. |
| pear config-set preferred_state beta | | pear config-set preferred_state beta |
| pear install Archive_Zip | | pear install Archive_Zip |
− | </code>
| |
− |
| |
− | ===Install git===
| |
− |
| |
− | <code>yum install git</code>
| |
− |
| |
− | ===Checkout our fork===
| |
− | The repo with the latest sources is http://git.sugarlabs.org/projects/activities-sugarlabs-org/repos/aso-tomeu
| |
− |
| |
− | <code>git-clone git://git.sugarlabs.org/activities-sugarlabs-org/aso-tomeu.git /var/www</code>
| |
− |
| |
− | ==Set up server==
| |
− |
| |
− | ===Set permissions===
| |
− |
| |
− | <code>
| |
− | chown -R apache:apache /var/www/site
| |
− | </code>
| |
− |
| |
− | ===Edit DocumentRoot===
| |
− |
| |
− | <code>
| |
− | vim /etc/httpd/conf/httpd.conf
| |
− |
| |
− | Edit DocumentRoot /var/www/site/app/webroot
| |
− | Edit AllowOverride All
| |
− | </code>
| |
− |
| |
− | ===Add to hosts===
| |
− |
| |
− | <code>
| |
− | vim /etc/hosts
| |
− | 127.0.0.1 activities.sugarlabs.org
| |
− | </code>
| |
− |
| |
− | ==Test server==
| |
− |
| |
− | <code>
| |
− | service httpd restart
| |
− | </code>
| |
− |
| |
− | <code>
| |
− | mv /var/www/site/app/webroot/index.php /var/www/site/app/webroot/index.php.old
| |
− | mv /var/www/html/index.php /var/www/site/app/webroot/index.php
| |
− | </code>
| |
− |
| |
− | ===Open===
| |
− |
| |
− | Open activities.sugarlabs.org in firefox
| |
− |
| |
− | ===Install mysql===
| |
− | <code>
| |
− | yum install mysql-server php-mysql
| |
− | </code>
| |
− |
| |
− | ===start mysql on system boot===
| |
− |
| |
− | <code>
| |
− | chkconfig --levels 235 mysqld on
| |
− | </code>
| |
| | | |
− | ===Start mysqld===
| + | To check out sources you need git and subversion. |
| + | sudo apt-get install git subversion |
| | | |
− | <code>
| + | Checkout our fork. |
− | service mysqld start | + | git-clone git://git.sugarlabs.org/slo-activities/mainline.git /var/www |
− | </code>
| |
| | | |
− | ===Test server===
| + | Fetch external dependencies: |
| + | cd /var/www/site/vendors/ |
| + | svn co http://svn.mozilla.org/libs/product-details |
| + | svn co http://svn.mozilla.org/libs/fizzypop.mozdev fizzypop |
| + | svn co http://svn.mozilla.org/libs/phorms |
| + | svn co http://svn.mozilla.org/libs/zxtm-api |
| | | |
− | <code>
| + | == Set up server == |
− | service httpd restart
| |
− | </code>
| |
| | | |
− | open activities.sugarlabs.org in firefox. Make sure mysql is enabled
| + | 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> |
| | | |
− | ===Setup mysql===
| + | Enable all apache mods. |
| + | cd /etc/apache2/mods-enabled |
| + | ln -s ../mods-available/* . |
| | | |
− | <code>
| + | Setup mysql(you need to enter mysql root password for these commands). |
| mysqladmin -u root password remora | | mysqladmin -u root password remora |
| mysqladmin -u root -p create remora | | mysqladmin -u root -p create remora |
− | mysqladmin -u root -p create remora-test
| |
| mysql -u root -p | | mysql -u root -p |
− | | + | |
| GRANT ALL ON *.* TO 'remora'@'localhost' IDENTIFIED BY 'remora'; | | GRANT ALL ON *.* TO 'remora'@'localhost' IDENTIFIED BY 'remora'; |
| exit; | | exit; |
− | </code>
| |
| | | |
− | ===Populate tables===
| + | Add our server to /etc/hosts file. |
− | <code>
| + | 127.0.0.1 a.sl.o |
− | mysql -u remora --pasword=remora -D remora </var/www/site/app/config/sql/remora.sql
| |
− | mysql -u remora --pasword=remora -D remora </var/www/site/app/tests/data/remora-test-data.sql | |
− | mysql -u remora --pasword=remora -D remora </var/www/site/app/tests/data/sugar-test-data.sql
| |
− | </code>
| |
| | | |
− | ===Configure aso===
| + | To test server create /var/www/site/app/webroot/php.php: |
− | | + | <?php phpinfo(); ?> |
− | ===Edit config.php===
| + | Open http://a.sl.o/php in browser and make sure mysql is enabled. |
− | | |
− | <code>
| |
− | cp /var/www/site/app/config/config.php.default /var/www/site/app/config/config.php
| |
− | vim /var/www/site/app/config/config.php | |
− | </code>
| |
− | | |
− | <code><pre>
| |
− | | |
− | <?php | |
− | /* ***** BEGIN LICENSE BLOCK *****
| |
− | * Version: MPL 1.1/GPL 2.0/LGPL 2.1
| |
− | *
| |
− | * The contents of this file are subject to the Mozilla Public License Version
| |
− | * 1.1 (the "License"); you may not use this file except in compliance with
| |
− | * the License. You may obtain a copy of the License at
| |
− | * http://www.mozilla.org/MPL/
| |
− | *
| |
− | * Software distributed under the License is distributed on an "AS IS" basis,
| |
− | * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
| |
− | * for the specific language governing rights and limitations under the
| |
− | * License.
| |
− | *
| |
− | * The Original Code is addons.mozilla.org site.
| |
− | *
| |
− | * The Initial Developer of the Original Code is
| |
− | * The Mozilla Foundation.
| |
− | * Portions created by the Initial Developer are Copyright (C) 2006
| |
− | * the Initial Developer. All Rights Reserved.
| |
− | *
| |
− | * Contributor(s):
| |
− | * Wil Clouser <wclouser@mozilla.com> (Original Author)
| |
− | * Mike Morgan <morgamic@mozilla.com>
| |
− | * Justin Scott <fligtar@gmail.com>
| |
− | * Frederic Wenzel <fwenzel@mozilla.com>
| |
− | *
| |
− | * Alternatively, the contents of this file may be used under the terms of
| |
− | * either the GNU General Public License Version 2 or later (the "GPL"), or
| |
− | * the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
| |
− | * in which case the provisions of the GPL or the LGPL are applicable instead
| |
− | * of those above. If you wish to allow use of your version of this file only
| |
− | * under the terms of either the GPL or the LGPL, and not to allow others to
| |
− | * use your version of this file under the terms of the MPL, indicate your
| |
− | * decision by deleting the provisions above and replace them with the notice
| |
− | * and other provisions required by the GPL or the LGPL. If you do not delete
| |
− | * the provisions above, a recipient may use your version of this file under
| |
− | * the terms of any one of the MPL, the GPL or the LGPL.
| |
− | *
| |
− | * ***** END LICENSE BLOCK ***** */
| |
− | | |
− | | |
− | | |
− | /**
| |
− | * Global configuration document.
| |
− | *
| |
− | * This document covers both the CakePHP based site (/site) and its service scripts.
| |
− | * Unless otherwise noted, trailing slashes should not be used.
| |
− | * @package amo
| |
− | */
| |
− | | |
− | /**
| |
− | * Site URL
| |
− | * Example: http://addons.mozilla.org
| |
− | * Example: http://khan-vm.mozilla.org (dev)
| |
− | * Example of getting a full controller url:
| |
− | * echo SITE_URL.$html->url('/users/register');
| |
− | * Will default to http://addons.mozilla.org unless defined below
| |
− | */
| |
− | // define('SITE_URL', '');
| |
− | | |
− | /**
| |
− | * Services URL.
| |
− | * Example: http://addons.mozilla.org/services
| |
− | * Example: http://khan-vm.mozilla.org/amo/services (dev)
| |
− | */
| |
− | define('SERVICE_URL','htp://activities.sugarlabs.org');
| |
− | | |
− | /**
| |
− | * Site State
| |
− | * Example: production
| |
− | * Example: staging
| |
− | * Example: dev
| |
− | * All uses should default to dev
| |
− | */
| |
− | define('SITE_STATE', 'dev');
| |
− |
| |
− | /**
| |
− | * Files
| |
− | * The application uses these paths to piece together the URL for files.
| |
− | *
| |
− | * HOST and URL are separated because CakePHP has $html->webroot, and only appends
| |
− | * FILES_URL while the services need both since it doesn't have
| |
− | * Cake's context.
| |
− | *
| |
− | * No trailing slashes.
| |
− | */
| |
− | | |
− | /**
| |
− | * Host, including http://. Should be everything leading up to addon ids.
| |
− | * Example: http://releases.mozilla.org/addons
| |
− | */
| |
− | define('FILES_HOST', 'http://activities.sugarlabs.org');
| |
− | | |
− | /**
| |
− | * Relative web path of the files directory. Tacking this on to FILES_HOST should get you
| |
− | * the complete URL where your files are. This is the location of the downloads controller
| |
− | * and it should not normally need to be changed, the default is set in constants.php,
| |
− | * and shown commented out here.
| |
− | *
| |
− | * Example: downloads/file
| |
− | */
| |
− | define('FILES_URL', 'downloads');
| |
− | | |
− | /**
| |
− | * File path for storing XPI/JAR files (or any files associated with an add-on).
| |
− | * Example: /data/www/app/webroot/files
| |
− | */
| |
− | define('REPO_PATH', '/var/www/files');
| |
− | | |
− | /**
| |
− | * File path for storing public files to be rsynced for updates
| |
− | * If left commented out, files will not be copied there and will use only REPO_PATH
| |
− | */
| |
− | //define('PUBLIC_STAGING_PATH', '');
| |
− | | |
− | /**
| |
− | * The path to the gnu diff program (or any diff program able to create a unified diff).
| |
− | * If left commented out, it will use the xdiff package
| |
− | */
| |
− | //define('DIFF_PATH', '/usr/bin/diff');
| |
− | | |
− | /**
| |
− | * This is the number of seconds for which repeat downloads will not
| |
− | * be counted, since Firefox does multiple gets during a single install process.
| |
− | */
| |
− | define('DL_COUNT_DELAY', '10');
| |
− | | |
− | /**
| |
− | * Path to directory where detailed logfiles are kept. Files will be created in
| |
− | * this directory in the format: {DETAILED_LOG_PATH}/Y-M-D.txt
| |
− | */
| |
− | //define('DETAILED_LOG_PATH', '');
| |
− | | |
− | /**
| |
− | * Path to directory for misc. AMO storage accessible by all webheads.
| |
− | */
| |
− | define('NETAPP_STORAGE', '');
| |
− | | |
− | /**
| |
− | * Facebook Configuration
| |
− | */
| |
− | // Whether the Facebook controller is enabled
| |
− | define('FB_ENABLED', 'false');
| |
| | | |
− | // Facebook API keys
| + | == Configure ASLO == |
− | define('FB_API_KEY', '');
| |
− | define('FB_API_SECRET', '');
| |
| | | |
− | // Facebook App URL | + | cd /var/www |
− | define('FB_URL', 'http://apps.facebook.com/add-ons');
| + | aslo/db-create-stub.sh |
| | | |
− | // Facebook Image site - where images are pulled from
| + | Open a.sl.o in browser. To login use: |
− | define('FB_IMAGE_SITE', 'https://addons.mozilla.org');
| + | ''login'' admin@sugarlabs.org |
| + | ''password'' test |
| | | |
− | // Facebook Install site - where the add-on install page goes
| + | == Optional steps == |
− | define('FB_INSTALL_SITE', 'https://addons.mozilla.org');
| |
| | | |
− | // Facebook Bounce Percentage - percent of hits to bounce
| + | ====Install php-memcache==== |
− | //define('FB_BOUNCE_PERCENTAGE', 0);
| |
− | | |
− | /**
| |
− | * Database configuration.
| |
− | */
| |
− | | |
− | /**
| |
− | * DB_USER, DB_PASS, DB_NAME, DB_HOST, DB_PORT
| |
− | * This database has read/write capabilities. Host and port default to localhost and 3306.
| |
− | */
| |
− | define('DB_USER','remora');
| |
− | define('DB_PASS','remora');
| |
− | define('DB_NAME','remora');
| |
− | | |
− | /**
| |
− | * SHADOW_DB_USER, SHADOW_DB_PASS, SHADOW_DB_NAME, SHADOW_DB_HOST, SHADOW_DB_PORT
| |
− | * Array of shadow databases that have read-only access.
| |
− | * - If left alone, will default to DB_* above.
| |
− | * - DB_WEIGHTs must sum to 1. i.e., a weight of 0 will never get hit, a weight
| |
− | * of .50 will get hit half of the time, and a weight of 1 will always get hit.
| |
− | * - The array keys need not be numeric and could be used for descriptive purposes
| |
− | * that would appear in the monitor script.
| |
− | */
| |
− | global $shadow_databases;
| |
− | $shadow_databases = array(
| |
− | 0 => array(
| |
− | 'DB_HOST' => '',
| |
− | 'DB_PORT' => 3306,
| |
− | 'DB_NAME' => '',
| |
− | 'DB_USER' => '',
| |
− | 'DB_PASS' => '',
| |
− | 'DB_WEIGHT' => 0
| |
− | )
| |
− | );
| |
− | | |
− | /**
| |
− | * TEST_DB_USER, TEST_DB_PASS, TEST_DB_NAME, TEST_DB_HOST, TEST_DB_PORT
| |
− | * The test database. All fields default to their DB_* counterparts, except
| |
− | * for TEST_DB_NAME, which is DB_NAME . "-test".
| |
− | */
| |
− | | |
− | /**
| |
− | * memcache configuration.
| |
− | *
| |
− | * The memcache_config array lists all possible memcached servers to use in case the default server does not have the appropriate key.
| |
− | */
| |
− | global $memcache_config;
| |
− | $memcache_config = array(
| |
− | 'localhost' => array(
| |
− | 'port' => '11211',
| |
− | 'persistent' => true,
| |
− | 'weight' => '1',
| |
− | 'timeout' => '1',
| |
− | 'retry_interval' => 15
| |
− | )
| |
− | );
| |
− | | |
− | /**
| |
− | * Recaptcha (recaptcha.net) configuration
| |
− | */
| |
− | define('RECAPTCHA_ENABLED', false);
| |
− | define('RECAPTCHA_PRIVATE_KEY', '...');
| |
− | define('RECAPTCHA_PUBLIC_KEY', '...');
| |
− | | |
− | /**
| |
− | * Compatibility Center Versions
| |
− | */
| |
− | define('COMPAT_DEFAULT_VERSION', '3.1');
| |
− | global $compatibility_versions;
| |
− | $compatibility_versions = array(
| |
− | '3.0', '3.1'
| |
− | );
| |
− | | |
− | ?>
| |
− | </pre></nowiki>
| |
− | | |
− | ===Edit config-local.php===
| |
− | | |
− | <code>
| |
− | vim /var/www/site/app/config/config-local.php
| |
− | </code>
| |
− | | |
− | <code>
| |
− | <?php
| |
− | define('DEBUG', 1);
| |
− | define('DEV', true);
| |
− | ?>
| |
− | </code>
| |
− | | |
− | <code>
| |
− | chown apache:apache /var/www/site/app/config/config-local.php
| |
− | </code>
| |
− | | |
− | This is necessary to generate debug message. Without it you get a somewhat disconcerting blankscreen.
| |
− | | |
− | Open activities.sugarlabs.org in firefox.
| |
− | | |
− | | |
− | | |
− | ===Create download directory===
| |
− | | |
− | <code>
| |
− | mkdir /var/www/downloads
| |
− | chown -R apache:apache /var/www/downloads
| |
− | </code>
| |
− | | |
− | ===Create repo directories===
| |
− | | |
− | <code>
| |
− | mkdir /var/www/files
| |
− | mkdir /var/www/files/temp
| |
− | mkdir /var/www/files/extracted
| |
− | chown -R apache:apache /var/www/files
| |
− | </code>
| |
− | | |
− | ===Install php-memcache=== | |
| | | |
| <code> | | <code> |
Line 468: |
Line 102: |
| </code> | | </code> |
| | | |
− | ===Install memcached=== | + | ====Install memcached==== |
| | | |
| <code> | | <code> |
Line 477: |
Line 111: |
| </code> | | </code> |
| | | |
| + | == TODO == |
| | | |
− | ===Test activities.sugarlabs.org===
| + | * Fix search |
− | | + | * Fix downloads |
− | open activities.sugarlabs.org/tests?case=installation.test.php in firefox.
| + | * 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 |