Support/SUMO install process

From MozillaWiki
< Support
Revision as of 21:40, 4 September 2009 by Paulc (talk | contribs) (SUMO installation process)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This document explains how to install a fresh checkout of SUMO on your server. Note: Currently SUMO only works well if set up at the root of the domain. You may experience layout or links issues if your setup is different. Note2: The instructions below have not been tested on a Windows machine.

Requirements

  • An up-to-date version of LAMP/MAMP/WAMP stack
    • PHP 5+ preferred, but PHP 4 may do (untested)
  • php-memcache and memcached for Memcache use (can be enabled from the admin->features panel)
  • Sphinx search engine installed for SUMO tiki-newsearch.php (preferred to older search). See Support/Sphinx_Installation

Check out SUMO

Start with a fresh checkout of trunk or our production branch

Note: using the trunk checkout below

svn co https://svn.mozilla.org/vc/projects/sumo/trunk/ sumo

Now create the required configuration files:

cd sumo

To enable sphinx search:

cp scripts/sphinx/search.conf.php.dist scripts/sphinx/search.conf.php

To enable showfor: (without this, knowledge base pages may show up blank)

cp scripts/showfor/config.php.dist scripts/showfor/config.php

To enable minify: (without this, pages may show up without CSS and JS)

cp scripts/minify/minify.conf.php.dist scripts/minify/minify.conf.php
touch webroot/files/minify.conf

On *nix based systems, you must allow permissions for the server scripts (often apache/www-data user) to write to minify.conf For example:

sudo chmod 775 webroot/files/minify.conf

Here you must configure the databsase user, host, pass, etc. To set up the database connection:

cp webroot/db/local.php.dist webroot/db/local.php
vim webroot/db/local.php

$host_tiki='localhost'; // change this to your host
$user_tiki='mysqluser'; // change this to your db user
$pass_tiki='mysqluserpw'; // change this to your db password
$dbs_tiki='mysqldbname'; // change this to your db name

Now create the templates directory for Smarty:

./setup.sh

Depending on your permissions, the output of setup.sh will explain which specific command you need to run.

Finally, to set up URL rewrites:

cd webroot
./htaccess.sh

To log in as an admin, you may use the user/pass: admin/admin on a clean schema. If you're using a dump, you can change the `password` column to 'admin' in the users_users table for the user 'admin' and then log in.


Database setup

We set up a clean schema in bug 502089.

  • To use Sphinx search, enable it at tiki-admin.php?page=features
  • To use Memcache, enable it at tiki-admin.php?page=features
  • To use Minify, enable it at tiki-admin.php?page=general


More information

If you would like more information, you can contact the SUMOdev team at sumo-dev@mozilla.com