INSTALL

   1
   2                    Deployment instructions for my.gpodder.org
   3                    ------------------------------------------
   4
   5 Dependencies:
   6
   7   * python (>= 2.5)
   8   * MySQL Server (>= 5.0)
   9   * python-mysqldb
  10   * lighttpd
  11   * python-feedparser
  12   * python-dateutil
  13   * python-simplejson
  14   * python-flup
  15   * python-imaging
  16
  17 It's recommended that you use the development version of the following
  18 libraries, as we're living on the bleeding edge here:
  19
  20   * django
  21     svn co http://code.djangoproject.com/svn/django/trunk/ django
  22
  23   * django-registration
  24     hg clone http://bitbucket.org/ubernostrum/django-registration/
  25
  26   * django-haystack
  27     git clone git://github.com/toastdriven/django-haystack.git
  28
  29   * whoosh
  30     hg clone http://bitbucket.org/mchaput/whoosh/
  31
  32 You can set up the repositories in this source tree by creating a
  33 "upstream" directory in which you checkout the above code bases.
  34
  35 Then, you create a "lib" folder and symlink the packages from the
  36 "upstream" directory there:
  37
  38   cd lib/
  39   ln -s ../upstream/django/django
  40   ln -s ../upstream/whoosh/src/whoosh
  41   ln -s ../upstream/django-haystack/haystack
  42   ln -s ../upstream/django-registration/registration
  43   cd ..
  44
  45 1. Creating the database
  46
  47 In MySQL, do the following (the SUPER grant is needed for
  48 triggers to work in MySQL 5.0):
  49
  50   CREATE DATABASE mygpo;
  51   GRANT ALL ON mygpo.* TO mygpo@localhost WITH GRANT OPTION;
  52   GRANT SUPER ON *.* TO mygpo@localhost;
  53   GRANT ALL ON mygpo.* TO mygpo@'%' WITH GRANT OPTION;
  54   GRANT SUPER ON *.* TO mygpo@'%';
  55   FLUSH PRIVILEGES;
  56
  57 Make sure that MySQL listens only on localhost, or if in
  58 doubt, assign a password to the "mygpo" user!
  59
  60 2. Initialize the database
  61
  62 Run in the mygpo/ subdirectory (possibly after setting the
  63 DB parameters in mygpo/settings.py):
  64
  65   python manage.py syncdb
  66
  67 When asked to create a superuser, you can say YES.
  68
  69 Now, run every SQL-Script in the install/ subdirectory, starting
  70 with "create.sql" and working your way all the way through the
  71 update scripts (these are split because we are doing incremental
  72 schema updates on the production server).
  73
  74 If you are really doing an initial installation, you can also use
  75 the "install.sh" script which runs all scripts on the local MySQL
  76 server in the correct order. You should not use this script to
  77 upgrade the database, as data loss may occur. You have been warned.
  78
  79
  80 3. Setup the web server using lighttpd
  81
  82 There is a mygpo.lighttpd.conf file shipped with the source. Please
  83 customize it to your needs, and then include it from your lighttpd
  84 main configuration file, for example like this:
  85
  86   include "/srv/mygpo/mygpo.lighttpd.conf"
  87
  88 4. Enable lighttpd modules
  89
  90 The modules you need to enable are: rewrite, fastcgi. On Debian,
  91 you can enable these using the "lighty-enable-mod" command:
  92
  93   lighty-enable-mod rewrite fastcgi
  94
  95 5. Restart lighttpd
  96
  97 On Debian:
  98
  99   /etc/init.d/lighttpd restart
 100
 101