Update:Archive/2.0/Installation

Update: Home Page » Installation Guide

Check out code from CVS

• v1: /mozilla/webtools/update -rMOZILLA_UPDATE_1_0_BRANCH
• v2: /mozilla/webtools/addons

For CVS instructions, see the devmo page on CVS.

v2 Installation

Core

Without these, the application will not run.

• A server
• mysqld
• apache2
• php4.x
• php-mysql
• PEAR::DB
• Smarty

Enhancements

Without these, the app will still run, but it will be slower than optimal. We should plan on managing these, even if it is a PITA.

• APC 3.x.x
• memcached
• PECL PHP memcache extension (--enable-memcache[=DIR])

Server Config

• Apache
  • Prod
    • Copy contents of ./public/htaccess.dist into vhost conf file.
  • Dev/Testing
    • If you are using a singular vhost to test multiple instances of AMO, you'll have to adjust the vhost to use .htaccess files, so you'd have to add "AllowOverride FileInfo" then restart httpd.
  • Make sure mod_rewrite is installed
• MySQL
  • 4.1.x+
  • When we move things forward we will need to import a mysqldump from production
  • We then will need to run ./shared/sql/v2.sql -- This was already completed in the v2 release, so if you have an access to the chameleon dump, using that should be adequate.
• PHP
  • php-mysql - PHP packages for mysql support, this is a basic package
  • APC (optional, production only)
  • PECL memcache extension (optional, production only)
    • This involves adding a C extension to PHP and recompiling it.
    • The INSTALL file offers instructions on how to do this using PHP utils and make.
  • PEAR::DB -- This is a basic package.
  • Smarty -- https://intranet.mozilla.org/AMO -- Only the /lib directory is needed, the rest doesn't really need to be extracted.
    • In the past, it was helpful to just make symlink that was /usr/local/share/php/Smarty --> /usr/local/share/php/Smarty-2.x.x
    • When you configure the application, you will point at the lib directory not the base directory for Smarty -- so be aware of the distinction.
  • zzlib (optional, for v1 only -- iguana)
    • zzlib is required for extraction of XPIs for the v1 developers tools, and probably only needs to be installed on Iguana for use with these tools.
    • As we plan out the rewrite for the developer tools, removing this dependency is a primary goal... :)

Application Config

The application is split into sections on purpose. The goal here was to:

• segregate public, private and backend pieces
• hide non-public scripts from the world by not having php includes in the webroot

Directory Structure

The main directories we should be aware of:

• ./shared/bin - backend scripts are stored here, and use the config.php in this directory
• ./shared/sql - sql structure along with a v2.sql for migrating v1 to the new structure live here
• ./shared/lib - all php libs and dependencies that are central live here (class defninitions, etc.)
• ./public/inc - wrappers live here, like config.php, init.php and finish.php
• ./public/htdocs - this should be the webroot of the site
• ./public/tpl - this is the template directory, not stored in the webroot
• ./public/templates_c - this is where smarty stores compiled templates
• ./public/cache - this is the smarty cache dir, not really needed but config requires it
• ./public/configs - this is the smarty configs dir, not really needed but config requires it

Setting things up, permissions, etc.

• ./public/(templates_c, cache, and configs)
  • These should be writeable by apache
• ./public/inc/config.php
  • Copy config-dist.php to config.php and follow the instructions in the comments.
• ./public/htdocs/htaccess.dist
  • Copy to .htaccess then set the rewrite base to the proper value.
• ./shared/bin/config.php
  • Copy config-dist.php to config.php and provide writeable DB information (don't use the SLAVE!).