README

   1 icelog
   2
   3 Copyright (c) 2002 Ivan Kohler
   4 All rights reserved.
   5 This program is free software; you can redistribute it and/or modify it under
   6 the same terms as Perl itself.
   7
   8 ivan-icelog@420.am
   9
  10 iceaccessd/iceaccess_server is a client/server program for collecting logging
  11 data from multiple, possibly remote icecast servers in a central SQL database.
  12
  13 icecounter.cgi is a CGI to query the SQL database and displaytotal elapsed
  14 minutes (live vs. archived) for a single customer or all customers, total or
  15 broken down by month.
  16
  17 create-Pg.sql and create-mysql.sql contain the SQL to create the
  18 required table.
  19
  20 To use:
  21
  22   - create the database table as defined in create-Pg.sql or create-mysql.sql
  23   - copy iceaccessd to /usr/local/bin/iceaccessd on the icecast server(s)
  24   - chmod a+rx /usr/local/bin/iceaccessd on the icecast server(s)
  25   - set the parameters in icelog.conf and copy it to /etc/icelog.conf
  26   - on the central database machine, run:
  27         iceaccess_server icecast.machine /path/to/icecast/access.log 0
  28     for each remote icecast.machine
  29   - on each icecast.machine, after rotating your icecast access.log, HUP the
  30     iceaccessd process
  31   - if the central database machine goes down, you can restart the parsing from
  32     a particular position in the logfile using the command:
  33         iceaccess_server icecast.machine /path/to/icecast/access.log position
  34     You can ask the database for the position log parsing left off at with
  35     a query like:
  36         SELECT MAX(logpos) FROM icelog
  37           WHERE logdate > <timestamp> AND logmachine = "icecast.machine";
  38     where <timestamp> is the UNIX timestamp when you last rotated your logs,
  39     and icecast.machine is the machine in question.
  40