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