[Summary view] [Print] [Text view]

   1  Zoph 0.5 installation
   2  21 Jan 2006
   3  
   4  1. Requirements
   5  
   6     The following need to be installed before Zoph will function.  For
   7     details on installing these, read the REQUIREMENTS document.
   8  
   9     - MySQL
  10     - Apache
  11     - PHP 4
  12     - Perl 5
  13     - Perl DBI, DBD::mysql, Image::Size
  14     - ImageMagick
  15     - Jhead (http://www.sentex.net/~mwandel/jhead/)
  16  
  17     You may also have to install mod_php and the MySQL PHP module to get
  18     MySQL, PHP and Apache to play together.
  19  
  20  2. Creating the database
  21  
  22     2.1 Create a database and import the tables
  23  
  24         $ mysqladmin -u root -p create zoph
  25         $ mysql -u root -p zoph < sql/zoph.sql
  26  
  27     2.2 Create users for zoph
  28  
  29         I created two users: zoph_rw is used by the application and
  30         zoph_admin is used when I work directly in mysql so I don't
  31         have to use root.
  32  
  33         $ mysql -u root -p
  34         mysql> grant select, insert, update, delete on zoph.* to zoph_rw@localhost identified by 'PASSWORD';
  35  
  36         mysql> grant all on zoph.* to zoph_admin identified by 'PASSWORD';
  37  
  38  3. Configure the PHP templates
  39  
  40     The values to be configured are in the php/config.inc.php file.
  41  
  42     You will have to edit the following:
  43  
  44     - DB_HOST : your database host (localhost, for example)
  45     - DB_NAME : zoph (unless you used something else above)
  46     - DB_USER : zoph_rw, using the above example
  47     - DB_PASS : the password you set
  48  
  49     - USE_IMAGE_SERVICE : see the section on the image service below.
  50         the default is no (0).
  51     - IMAGE_DIR : where your images are stored.  this is the absolute file
  52         system path.  keep the trailing slash.
  53     - WEB_IMAGE_DIR : the path to the the images off you web server's doc root.
  54         if you enable the image service, this is ignored.
  55  
  56     The following 6 parameters should always match their equivalents in
  57     zophImport.pl.  If you edit one, edit the other too.
  58  
  59     - THUMB_SIZE : max width or height of thumbnails (default 120 pixels)
  60     - MID_SIZE : max width or height of mid size images (default 480 pixels)
  61     - THUMB_PREFIX : thumbnail prefix (default 'thumb')
  62     - MID_PREFIX : mid size prefix (default 'mid')
  63     - MIXED_THUMBNAILS : the default is 1 which enables the Zoph 0.3 to behave
  64         like previous versions.  Setting this to 0 means that Zoph will
  65         assume all thumbnails have the extension specified in THUMB_EXTENSION.
  66         This setting should match what is in zophImporter.pl.
  67         If you are installing Zoph for the first time, I recommend you set
  68         this to 0 and change zophImport.pl accordingly.
  69         If you are upgrading, see the UPGRADE document for more information
  70         about this.
  71     - THUMB_EXTENSION : the extension to use for thumbnails.  This setting is
  72         ignored if MIXED_THUMBNAILS is set.
  73  
  74  4. Install the templates
  75  
  76     4.1 Pick a location to put Zoph
  77  
  78         Create a zoph/ directory off the doc root of your web server, or
  79         create a Virtual Host with a new doc root.
  80  
  81         $ mkdir /var/www/html/zoph
  82  
  83     4.2 Copy the templates
  84  
  85         $ cp -r php/* /var/www/html/zoph/
  86  
  87  5. Install the perl scripts
  88  
  89     5.1 Check the path to perl
  90  
  91         The perl scripts points to /usr/bin/perl.  If your perl is
  92         in a different place, edit the first line of the script.
  93  
  94     5.2 Configure the database variables
  95  
  96         Edit bin/zophImport.pl and bin/zophExport.pl so that the following
  97         variables match the values you put in config.inc.php:
  98         $db_name = 'zoph';
  99         $db_user = 'zoph_rw';
 100         $db_pass = 'password';
 101  
 102         In addtion, in zophExport.pl set $image_dir to you image directory.
 103  
 104     5.3 Copy bin/zophImport.pl and bin/zophExport.pl to /usr/local/bin
 105  
 106         Or some other directory in your PATH.
 107  
 108     5.4 Install the man page
 109  
 110         A man page for zophImport.pl is in the man/ directory.  Copy this
 111         to somewhere in your manpath, /usr/local/man/man1 for example.
 112  
 113  6. Test it
 114  
 115     Try hitting http://localhost/zoph/logon.php.  You should be presented
 116     with the logon screen.
 117  
 118     If you get a 404 error...
 119     + make sure the zoph/ folder and templates can be seen by the web
 120       server.
 121  
 122     If you see a bunch of code...
 123     + make sure Apache is configured to handle PHP (see the REQUIREMENTS
 124       file)
 125  
 126     If you see a MySQL access denied error...
 127     + make sure the DB_USER you specified in config.inc.php actually has
 128       access to the database.  If your database is not on localhost, you
 129       will need to grant permissions to zoph_rw@hostname for that host.
 130  
 131  7. Add some photos
 132  
 133     See the MANUAL to get started.