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::Size
  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     Apache::Session::File
  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 If you want to support RAW files, then you'll need to install
  32 imagemagick and dcraw.
  33
  34 You will also need a MySQL database. Again, in theory other databases
  35 can be used, but in practice, you're on your own again.
  36
  37 Configure /etc/memories/Config.pm to your site, and follow the instructions in
  38 there - it will require you to set other things up as well.
  39
  40 Test that everything works:
  41
  42     perl -MMemories -e1
  43
  44 If this produces no errors, you're good to configure Apache. I have
  45 Memories living in "/home/simon/maypole-sites/memories", and my photo
  46 storage in "/opt/store/", and so my configuration looks like this:
  47
  48     <Perl>
  49         use lib qw( /home/simon/maypole-sites/memories/ );
  50     </Perl>
  51
  52     PerlModule Memories
  53     Alias /memories/static/ /home/simon/maypole-sites/memories/templates/static/
  54     Alias /memories/store/ /opt/store/
  55
  56     <Location /memories>
  57         PerlHandler Memories
  58         SetHandler perl-script
  59     </Location>
  60
  61 Restart Apache, register yourself and get uploading!
  62
  63
  64 Updating Memories 1.0 to 1.1
  65 ----------------------------
  66
  67 1) Create the system_tags and system_taggings table as in memories.sql
  68
  69 2) Run the tag_dates script.
  70
  71 Updating Memories 1.1 to 1.2
  72 ----------------------------
  73
  74 No changes.