INSTALL

   1 Installing NonameTV
   2 -------------------
   3
   4 PREREQUISITES
   5
   6 MySQL-server, at least version 4.0. This is necessary since transactions
   7 are used. The MySQL-server must be configured with support for InnoDB
   8 tables.
   9
  10 A lot of perl-modules... You will find out which ones along the way.
  11
  12 wvHtml from http://wvware.sourceforge.net/
  13
  14 sitecopy from http://www.lyra.org/sitecopy/
  15
  16 lwp (libwww-perl) 5.808 or later is preferred since if you have 5.805 or
  17 earlier, you will get a lot of harmless but annoying
  18 "Parsing of undecoded UTF-8 will give garbage when decoding entities".
  19
  20 INSTALLATION
  21
  22 Create a directory called /var/local/nonametv.
  23
  24 Create the following directories under /var/local/nonametv:
  25
  26 cache
  27 channels
  28 xmltv
  29 xmltv_staging
  30 xmltv_compare
  31 data
  32 override
  33 override/data
  34 override/delete
  35 override/new
  36 xmltv_old
  37
  38 Also create a directory /var/log/nonametv/
  39
  40 Make sure that the user you intend to run the scripts as can read/write the
  41 directories above.
  42
  43 Copy examples/nonametv.conf.public to /etc/nonametv.conf. Note that this file
  44 only contains configuration for the Importers that can be run without passwords
  45 etc. from the TV-companies.
  46
  47 Edit /etc/nonametv.conf to match your installation.
  48
  49 Create a new mysql database called listings (or whatever you wrote in
  50 nonametv.conf).
  51
  52 Run
  53
  54 perl -I lib tools/nonametv-populatedb --rebuild database se
  55
  56 to populate the database with sample data from the Swedish version of
  57 NonameTV.
  58
  59 Setup sitecopy to upload files from /var/local/nonametv/xmltv to your
  60 webserver. This is the data that is downloaded by tv_grab_se_swedb.
  61
  62 Explore the commands in tools/ and tools/se. Start by looking at
  63 tools/se/nonametv-cronjob.
  64
  65 The only command that isn't run from nonametv-cronjob is
  66
  67 perl -I lib tools/nonametv-export Xmltv --export-channels
  68
  69 (run from the nonametv-directory). It creates the channels.xml.gz file and
  70 should be run after you have added new channels or deleted old.
  71
  72 Most of the commands take one or several --verbose parameters.
  73
  74 Note that not all commands in tools/ are actually working...
  75
  76 Everytime data is imported or exported, an entry is written to
  77 /var/log/nonametv/nonametv.log.