INSTALL

   1 Installation guide
   2
   3 The following notes apply to alpha/beta releases. Some manual installation is
   4 required at this time.
   5
   6
   7 1. Requirements
   8         - Apache with mod-rewrite enabled and "Options All" so you can use a
   9 local .htaccess file
  10         - PHP > 5.1. The later the better. You'll need 5.3 for full openssl
  11 encryption support
  12         - PHP *command line* access with register_argc_argv set to true in the
  13 php.ini file
  14         - Mysql 5.x
  15         - cron
  16
  17         [Dreamhost.com offers all of the necessary hosting features at a
  18 reasonable price. If your hosting provider doesn't allow Unix shell access,
  19 you might have trouble getting everything to work.]
  20
  21 2. Edit htconfig.php and change system settings. Rename to .htconfig.php
  22
  23 3. Import database.sql into your database with mysql command line or via phpmyadmin
  24
  25 4. Import updates.sql (if it exists) to catch any late-breaking devel changes
  26
  27 5. Put this directory into the root of your web server document area.
  28         - To use a subdir of your main site, set the
  29         config variable $a->path to the relative subdir
  30         in .htconfig.php - for example to use http://example.com/test -
  31         set $a->path to 'test'.
  32         - Everything will work much better if you can dedicate a domain
  33         or subdomain so that you don't require an extra server path.
  34
  35 6. Navigate to your site with a web browser and register an account.
  36
  37 7. Set up a cron task to run "php include/poller.php http://my.domain.name" once every 5-10 minutes.
  38