Mirror set up how-to

From G8 TV Wiki

Jump to: navigation, search

Here is a quick step by step instruction of our testing enviroment we ran with Debian. Paths and commands may vary by the type of software you are using. If things dont work out, write to the g8-mirror at kanalB.org mailing list, we will help you. If you can help other people, please do so. Feel free to add information to this pages.

Contents

[edit]

Firewall

  • Open port 8000 (TCP) in your firewall.
[edit]

Icecast installation

  • Install icecast server 2.3.1 on your server (there may be problems with versions prior to 2.3.1). Download from http://www.icecast.org/ or with Debian type: 
$ apt-get install icecast2
[edit]

Icecast configuration

  • Edit icecast configuration file (with Debian it is /etc/icecast2/icecast.xml, if you compiled yourself: /usr/local/etc/icecast.xml): 
$ vi /etc/icecast2/icecast.xml
  • Here you configure how many clients you want to serve at maximum at once. You will need 360 MB traffic per client (also see Mirror bandwidth information. The total traffic bases on the number of clients + 1 (your server, downloading the stream from g8-tv-server) 
<clients>100</clients>
  • Change these passwords so nobody will abuse your server. 
<source-password>hackme</source-password>
<relay-password>hackme</relay-password>
<admin-password>hackme</admin-password>
  • Fill in your domain/host name. 
<hostname>your_domain</hostname>
  • Put these dates in the <relay> section. Delete "" behind </relay>, to activate relay 
<relay>
  <server>kanalB.tv</server>
  <port>8000</port>
  <mount>/g8-tv.ogg</mount>
  <local-mount>/g8-tv.ogg</local-mount>
  <on-demand>0</on-demand>
  <relay-shoutcast-metadata>0</relay-shoutcast-metadata>
</relay>
  • Save configuration file.
[edit]

Running icecast

  • Start your server, e.g. with Debian 
$ /etc/init.d/icecast2 start

(With Debian you have to set ENABLE=true in /etc/defaults/icecast2, when you have installed the icecast2 Debian package)

  • If you have compiled the source package yourself, you can start the server like this: 
$ /usr/local/bin/icecast -b -c /usr/local/etc/icecast.xml
  • Find the logfiles for your server in /var/log/icecast/ or /usr/local/var/log/icecast/
[edit]

Testing

  • To see, if test signal from g8-tv works do the following:

windows: start VLC >> File >> open network stream >> click HTTP fill in "kanalB.tv:8000/g8-tv.ogg" >> click OK

linux: vlc -vvv http://kanalB.tv:8000/g8-tv.ogg

  • To see, if your icecast server receives the test signal:

In your browser: http://your_domain:8000 Here you should already see the MOUNT POINT (/g8-tv.ogg) with the relating description texts in the overview.

If things don't work, the log files of your icecast server should give you advice, why the relay doesn't work.

  • To see, if your mirror works

windows: start VLC >> file >> open networkstream >> click http fill in "your_domain:8000/g8-tv.ogg" >> click OK

linux: vlc -vvv http://your_domain:8000/g8-tv.ogg

  • If everything works out, you should stop the icecast server in order to not let it use up bandwidth.
[edit]

Announce your mirror

This is important, otherwise we can't send you any viewers.

So, if everything works out, send an email with the following data to the g8-mirror at kanalB.org mailing list:

  1. the link to your mirror, e. g. http://your_domain:8000/g8-tv.ogg
  2. how many clients you want to serve at once
  3. which name your mirror should have on http://g8-tv.org/

If there are any problems, please write to the g8-mirror at kanalB.org mailing list. We will help you.

Retrieved from "http://wiki.g8tv.org/Mirror_set_up_how-to"
Personal tools