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   - setup SSH keys:
  27     As the freeside user (on your freeside machine), generate an authentication key using ssh-keygen. Since this is for unattended operation, use a blank passphrase.
  28 Append the newly-created identity.pub file to ~root/.ssh/authorized_keys on the remote machine(s).
  29 Some new SSH v2 implementation accept v2 style keys only. Use the -t option to ssh-keygen, and append the created id_dsa.pub or id_rsa.pub to ~root/.ssh/authorized_keys2 on the remote machine(s).
  30 You may need to set PermitRootLogin without-password (meaning with keys only) in your sshd_config file on the remote machine(s).
  31
  32   - on the central database machine, run:
  33         iceaccess_server icecast.machine /path/to/icecast/access.log 0
  34     for each remote icecast.machine
  35   - on each icecast.machine, after rotating your icecast access.log, HUP the
  36     iceaccessd process
  37   - if the central database machine goes down, you can restart the parsing from
  38     a particular position in the logfile using the command:
  39         iceaccess_server icecast.machine /path/to/icecast/access.log position
  40     You can ask the database for the position log parsing left off at with
  41     a query like:
  42         SELECT MAX(logpos) FROM icelog
  43           WHERE logdate > <timestamp> AND logmachine = "icecast.machine";
  44     where <timestamp> is the UNIX timestamp when you last rotated your logs,
  45     and icecast.machine is the machine in question.
  46