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
  20 Apache mod_perl is recommended. Memories can also be run as a CGI
  21 application, but you're on your own.
  22
  23 You will also need a MySQL database. Again, in theory other databases
  24 can be used, but in practice, you're on your own again.
  25
  26 Configure /etc/memories/Config.pm to your site, and follow the instructions in
  27 there - it will require you to set other things up as well.
  28
  29 Test that everything works:
  30
  31     perl -MMemories -e1
  32
  33 If this produces no errors, you're good to configure Apache. I have
  34 Memories living in "/home/simon/maypole-sites/memories", and my photo
  35 storage in "/opt/store/", and so my configuration looks like this:
  36
  37     <Perl>
  38         use lib qw( /home/simon/maypole-sites/memories/ );
  39     </Perl>
  40
  41     PerlModule Memories
  42     Alias /memories/static/ /home/simon/maypole-sites/memories/templates/static/
  43     Alias /memories/store/ /opt/store/
  44
  45     <Location /memories>
  46         PerlHandler Memories
  47         SetHandler perl-script
  48     </Location>
  49
  50 Restart Apache, register yourself and get uploading!
  51
  52
  53 Updating Memories 1.0 to 1.1
  54 ----------------------------
  55
  56 1) Create the system_tags and system_taggings table as in memories.sql
  57
  58 2) Run the tag_dates script.
  59