README

   1 Updating from an earlier release? Read the bit at the bottom!
   2
   3 Installing the Memories photo sharing application
   4 -------------------------------------------------
   5
   6 First, Perl modules. This is the hard part. You will need:
   7     Maypole (good luck)
   8     Class::DBI
   9     DBI
  10     DBD::mysql
  11     Class::DBI::mysql
  12     Image::Info
  13     Image::Imlib2 (requires libimlib2 and libimlib2-dev packages)
  14     Time::Piece
  15     Cache::Cache
  16     Maypole::Plugin::Upload
  17     Maypole::Plugin::Authentication::UserSessionCookie
  18     HTML::TagCloud
  19     XML::RSS
  20
  21 Apache mod_perl is recommended. Memories can also be run as a CGI
  22 application, but you're on your own.
  23
  24 You will also need a MySQL database. Again, in theory other databases
  25 can be used, but in practice, you're on your own again.
  26
  27 Configure /etc/memories/Config.pm to your site, and follow the instructions in
  28 there - it will require you to set other things up as well.
  29
  30 Test that everything works:
  31
  32     perl -MMemories -e1
  33
  34 If this produces no errors, you're good to configure Apache. I have
  35 Memories living in "/home/simon/maypole-sites/memories", and my photo
  36 storage in "/opt/store/", and so my configuration looks like this:
  37
  38     <Perl>
  39         use lib qw( /home/simon/maypole-sites/memories/ );
  40     </Perl>
  41
  42     PerlModule Memories
  43     Alias /memories/static/ /home/simon/maypole-sites/memories/templates/static/
  44     Alias /memories/store/ /opt/store/
  45
  46     <Location /memories>
  47         PerlHandler Memories
  48         SetHandler perl-script
  49     </Location>
  50
  51 Restart Apache, register yourself and get uploading!
  52
  53
  54 Updating Memories 1.0 to 1.1
  55 ----------------------------
  56
  57 1) Create the system_tags and system_taggings table as in memories.sql
  58
  59 2) Run the tag_dates script.
  60
  61 Updating Memories 1.1 to 1.2
  62 ----------------------------
  63
  64 No changes.