MozillaWiki

Update:Archive/2.0/Installation

< Update:Archive
Revision as of 06:24, 7 June 2006 by Morgamic (talk | contribs) (→‎v2 Installation)

Update: Home Page » Installation Guide

Check out code from CVS

v1

cvs co -dP v1 -rMOZILLA_UPDATE_1_0_BRANCH /mozilla/webtools/update

v2

cvs co -dP v2 /mozilla/webtools/addons

For CVS instructions, see the devmo page on CVS.

Server Requirements

v1 and v2

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

v1

  • zzlib PHP extension (for inflating xpi's in additem.php)

v2

  • Smarty

v2 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])

v2 Server Notes

  • 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.

v1 Installation

  • copy core/config-dist.php -> core/config.php
  • Fill in the proper variables, see the comments in config.php for help
  • Your server needs to have a previews directory containing add-on previews
  • Find this directory (or contact morgamic if you don't have it)
  • Symlink the previews directory from ./images:
$ ln -s /data/amo/previews/ previews
  • Your server needs to have a files directory containing the right .xpi's
  • You'll want to do something similar to set up the xpi directory:
$ ln -s /data/amo/files/ files

v2 Installation

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!).

Previews

  • As with v1 you will have to create a symlink to the previews directory from images/:
$ cd public/htdocs/images
$ ln -s /data/amo/previews/ previews
Retrieved from "https://wiki.allizom.org/index.php?title=Update:Archive/2.0/Installation&oldid=27338"