[icecast] install doc v0.00001

Wed May 29 12:38:55 UTC 2002

I'll add our init script for redhat to it then:

note: it does work, but restarting is not always working, due to ports still being open :-(

---------------------------------------------------------------------
#!/bin/sh
#
# description: starts/stops the ices audioencoder
#
# chkconfig: 345 99 20
#
# Source function library.
. /etc/rc.d/init.d/functions

ICES_BIN="/opt/ices2/bin/ices"
ICES_CONF="/opt/ices2/etc/ices-live.xml"
PID_FILE="/var/run/ices2_station.pid"

# See how we were called.
case "$1" in
  start)
        echo "Setting line in mixer value's"
        action /usr/bin/aumix -L -f /root/.aumixrc >> /dev/null
        echo "Starting Ices station encoder"
        ${ICES_BIN} ${ICES_CONF} & >> /dev/null
        ICESPID=$!
        echo "Writing process ID ${ICESPID} in ${PID_FILE}"
        echo "${ICESPID}" > ${PID_FILE}
        ;;
  stop)
        echo "Shutting down Ices station encoder"
        killproc ${ICES_BIN}
        rm -rf ${PID_FILE}
        ;;
  restart)
        $0 stop
        sleep 6
        $0 start
        ;;
  *)
        echo "Usage: $0 {start|stop|restart}"
        exit 1
esac

exit 0

Maarten

<p>-----Original Message-----
From:	adam [mailto:adam at xs4all.nl]
Sent:	Wed 5/29/2002 2:09 PM
To:	icecast at xiph.org
Cc:	
Subject:	[icecast] install doc v0.00001
hey all,

maybe i am dumb but it took me a few hours to work out which cvs was
which and where ogg went etc etc...so i am completing some documentation
(the icantcode site was down too when i checked last time, is it still
alive?)

anyway, I am going to make some good documentation for my site soon but
heres a skeleton including some snippets from docs online already - appologies
in advance for plagarism, when i put it online proper i will credit
each part(if you see any mistakes please tell me, also i will include
a description when i get time on how to use cvs etc for those that have
never done it before)

also, for those that are interested i have just been part of setting up a
small FM network in NYC using Icecast and some home built transmitters :
http://fm.thing.net

anyways, i hope the steps i provide below will help someone

adam
"'free' as in 'radio'"
http://www.radioqualia.net

Steps to compile Icecast on Linux.
1. create a icecast directory on your machine
2. using cvs download the sources from http://cvs.xiph.org/cvs.html
The log-in information for cvs is available here. You need the Icecast
source, so:

Set CVSROOT in your environment to:
:pserver:anoncvs at xiph.org:/usr/local/cvsroot
Log into the CVS repository using:
cvs login
When prompted for a password, reply anoncvs.
Then access modules using the typical:
cvs -z 1 co module
...substituting the specific desired module for module. The modules you
need are:
icecast
ogg
vorbis

Then change dir to icecast/src/

Then download the following modules from the same cvs:
avl
httpp
log
net
thread
timing

3. Build and Install Ogg and Vorbis in that order.
To do this either read the README in the Ogg or Vorbis directories. Or
follow these steps:
a. change directory to Ogg. Run the autogen.sh file by typing this:
./autogen.sh

b.      run the make file my typing this:
make

c.      run the make install process by typing this:
make install

Then do the same within the Vorbis directory.

4. Compile and install icecast.
a. make sure libxml or libxml2 and their development libraries are
installed. These are standard libraries and may exist on your machine
already, to find out if they are there type:
locate libxml

If there no results then goto google and find the distributions, download,
and install. We were using redhat so we found the rpms at:

ftp://ftp.redhat.com/pub/redhat/linux/7.1/en/os/i386/RedHat/RPMS/

and download and install the following:
libxml2-2.4.19-4.i386.rpm
libxml2-devel-2.4.19-4.i386.rpm

We also had a problem when compiling Icecast that parser.h, tree.h, and
xmlmemory.h (from xmllib) were in the wrong directories so we copied them
to:
/usr/include/libxml
b. run autogen.sh in the Icecast directory by typing:
./autogen.sh

c. run configure, and specify where the Ogg and Vorbis directories are, do
this by typing the following:
./configure .with-ogg-prefix=/usr/include/ogg
.with-vorbis-prefix=/usr/include/vorbis

d. then run make:
make

e. then run make install:
make install

This will put Icecast in /usr/local/bin/f. Then use this default config
file:
http://www.xiph.org/archives/icecast/att-1110/01-icecast.xml

You should have a file that looks like this:
- <icecast>
  <location>Linux-speakup.org</location>
  <admin>geoff at braille.uwo.ca</admin>
- <limits>
  <clients>100</clients>
  <sources>10</sources>
  <threadpool>5</threadpool>
  <client-timeout>15</client-timeout>
  </limits>
  <source-password>audio</source-password>
- <directory>
  <touch-freq>5</touch-freq>
- <server>
  <host>yp.icecast.org</host>
  <touch-freq>15</touch-freq>
  </server>
  </directory>
  <hostname>bumpy.braille.uwo.ca</hostname>
  <port>9000</port>
- <!--
<bind-address>129.100.109.31</bind-address>
  -->
- <paths>
  <basedir>/usr/friends/geoff/ice2</basedir>
  <logdir>/usr/friends/geoff/ice2</logdir>
  </paths>
- <logging>
  <accesslog>access.log</accesslog>
  <errorlog>error.log</errorlog>
  </logging>
  </icecast>

Call it, icecast.xml and save it wherever you like.
The things to change in this file are:
i) change <hostname>bumpy.braille.uwo.ca</hostname>
by replacing bumpy.braille.uwo.ca with the domainname of your server.

ii) change <logdir>/usr/friends/geoff/ice2</logdir> by replacing
/usr/friends/geoff/ice2 with a path to where you want your logs to be
kept.

iii) change   <port>9000</port> to whatever port you want to use for
streaming (important for when you configure your encoder)

iv) change the password for the encoder at
<source-password>audio</source-password>

5. run Icecast by typing:
icecast .c pathname

where pathname is the location of your icecast.xml file, remember to
include the filename in the path. For example:

icecast .c /usr/local/icecast.xml

that.s it!

<p><p><p><p>On Wed, 29 May 2002, Michael Smith wrote:

> At 01:43 PM 5/29/02 +0200, you wrote:
> >I use the cvs version:
> >cvs -d :pserver:anonymous at cvs.icecast.org:/cvsroot login
> >cvs -d :pserver:anonymous at cvs.icecast.org:/cvsroot checkout ice2
> >cd ice2
> >cvs -d :pserver:anonymous at cvs.icecast.org:/cvsroot checkout avl
> >cvs -d :pserver:anonymous at cvs.icecast.org:/cvsroot checkout log
> >cvs -d :pserver:anonymous at cvs.icecast.org:/cvsroot checkout httpp
> >cvs -d :pserver:anonymous at cvs.icecast.org:/cvsroot checkout net
> >cvs -d :pserver:anonymous at cvs.icecast.org:/cvsroot checkout thread
> >./autogen.sh
>
> Wrong cvs module. Wrong cvs server. xiph.org, and the module is
> called icecast.
>
> Michael
>
>
> --- >8 ----
> List archives:  http://www.xiph.org/archives/
> icecast project homepage: http://www.icecast.org/
> To unsubscribe from this list, send a message to 'icecast-request at xiph.org'
> containing only the word 'unsubscribe' in the body.  No subject is needed.
> Unsubscribe messages sent to the list will be ignored/filtered.
>

<p><p><p>Adam Hyde
XS4ALL Internet B.V.
mobile : + (31) 06 2903 6248

Eekholt 42
1112 XH
Diemen
Amsterdam

"free, as in 'radio'"

--- >8 ----
List archives: http://www.xiph.org/archives/
icecast project homepage: http://www.icecast.org/
To unsubscribe from this list, send a message to 'icecast-request at xiph.org'
containing only the word 'unsubscribe' in the body. No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.

<p><p><p>
-------------- next part --------------
A non-text attachment was scrubbed...
Name: winmail.dat
Type: application/ms-tnef
Size: 6163 bytes
Desc: winmail.dat
URL: <http://lists.xiph.org/pipermail/icecast/attachments/20020529/87222dfc/attachment.bin>