Verbatim:Deployment

From MozillaWiki
Revision as of 14:55, 4 November 2009 by Wenzel (talk | contribs) (→‎Setup)
Jump to navigation Jump to search

Verbatim » Deployment

Pre-Deployment Checklist

  • Prerequisites
    • Python >= 2.4
    • pip
    • (list of dependencies)
      • Some of these probably exist as RPMs, but they can also just be installed into the virtualenv
      • python-lxml
      • python-sqlite2
      • python-ldap
    • At least gettext version 0.15. This seems to upgrade cleanly in Redhat with no dependency issues (bug 438706)
    • At least SVN 1.5 (we make use of --with-revprop)

Setup

I've added some scripts etc. to github.

As the apache user, pick a dir where you want to deploy Pootle (pootle_dir), then:

  • Create and activate a virtualenv
    • cd pootle_dir
    • virtualenv --no-site-packages pootle_env
    • . pootle_env/bin/activate
  • Install all required packages using pip
    • wget .../requirements.txt (from github)
    • pip -E pootle_env ...
  • Download and extract Pootle itself (from the 1.3.0-beta4 snapshot directory) into pootle_env

Set up Apache and mod_python to properly run Pootle

  • wget .../modpython_wrapper.py (from github); chmod +x it

Configuration

  1. Create a Verbatim SSH account on the SVN server using an SSH key with no passphrase
  2. Copy the key to a .ssh directory in the home directory of the verbatim user on the verbatim server
  3. Add commit hooks to the SVN server for translate:author
  4. checkout https://translate.svn.sourceforge.net/svnroot/translate/src/branches/mozootle
  5. Copy pootle.prefs to a configuration directory and configure it
  6. The command to run the server is ./PootleServer --prefsfile=/path/to/pootle.prefs --port=80
    • note: the pootle tree must be owned by whatever user is running the pootle server

Post-deployment Checklist

todo: verification things are working, cron jobs, nagios checks, etc.