iceplex

Copyright (c) 2003 Ivan Kohler
All rights reserved.
This program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.

ivan-iceplex@420.am

iceplex is a system for multiplexing on-demand broadcasts to multiple
backend icecast servers.

To use:

Database configuration:

  - Create the "iceplex_servers" table in your database
    (see create-mysql.sql or create-Pg.sql)
  - Populate the "iceplex_servers" table with your icecast server names.

On the central multiplexing server:

  - Copy the example iceplex.conf to /etc/iceplex.conf and modify the settings
    as appropriate:
    - Database location/user/pass
    - Path to mp3 file storage on the icecast servers.
    - Icecast Port number
  - Run iceplexd and configure your init scripts to start it upon boot.
  - Create an "iceplex" user.
  - Run "ssh-keygen -t dsa" as the "iceplex" user to genarate SSH keys.
    Use a blank passphrase.  (Press return when prompted for a passphrase)
  - Install Net::SSH from CPAN or <http://search.cpan.org/author/IVAN/Net-SSH/>
  - Install DBI from CPAN or <http://search.cpan.org/author/TIMB/DBI/>
  - Install the DBD for your database
    - MySQL: DBD::mysql from CPAN or
      <http://search.cpan.org/author/JWIED/DBD-mysql/>
    - PostgreSQL: DBD::Pg from CPAN or
      <http://search.cpan.org/author/DWHEELER/DBD-Pg/>
  - Install plex.pls in /cgi-bin/ on the central multiplexing server or main
    webserver.  This file can be installed as or linked to as "plex.m3u" if
    desired.

On each icecast server:

  - Create an "iceplex" user.
  - Copy "/home/iceplex/.ssh/id_dsa.pub" from the central multiplexing server
    to "/home/iceplex/.ssh/authorized_keys".
  - Verify that the 
  - Install libshout C library 1.0.9 and Shout perl interface:
    <http://developer.icecast.org/libshout/>
  - Install yashout from this archive in /usr/local/bin

On end-user webpages:

  - Link to:
      <http://multi.plexing.server/cgi-bin/plex.pls?customer=XXXXXX;user=YYYY>

Optional, improves stream start latency:

  - Install fsh <http://www.lysator.liu.se/fsh/> on the central multiplexing
    server and each icecast server.
  - Uncomment 
      $Net::SSH:ssh = 'fsh';
    in /etc/iceplex.conf