Anexo I. Configuración del servidor SHOUTCAST

A continuación se detallan las posibilidades de configuración del servidor SHOUTCAST, comentando línea por línea el archivo sc_serv.ini, al que se accede desde la pestaña Edit Config, en la parte superior de la pantalla del servidor. En cursiva se muestran los comentarios propios del archivo de configuración, en inglés; en negrita se explican detalladamente cada uno de los parámetros de configuración, que se muestran tabulados para aumentar la claridad. El carácter “;” se utiliza en el archivo para comentar las líneas que no son de código, de forma que es como si el servidor no las leyera.

; SHOUTcast Distributed Network Audio Server configuration file

; Copyright (C) 1998-2004 Nullsoft, Inc.

; All Rights Reserved.

; Last modified Mar 17 2004

; If you want to manage multiple configurations, just copy

; this file to another name, and run sc_serv with that name

; such as:

; sc_serv.exe sc_leet.conf

Si queremos administrar múltiples configuraciones del servidor podemos copiar el archivo sc_serv.ini con otro nombre, variar la configuración y cargar el servidor mediante la ventana de comandos como “sc_serv.exe NuevoNombreConfiguración”

; ***************************

; Required stuff

; ***************************

; MaxUser. The maximum number of simultaneous listeners allowed.

; Compute a reasonable value for your available upstream bandwidth (i.e. if

; you have 256kbps upload DSL, and want to broadcast at 24kbps, you would

; choose 256kbps/24kbps=10 maximum listeners.) Setting this value higher

; o­nly wastes RAM and screws up your broadcast when more people connect

; than you can support.

A través del parámetro MaxUser se pueden definir el número máximo de usuarios que se pueden conectar simultáneamente al servidor. Hay que tener en cuenta que, en función de la calidad y del número de usuarios simultáneos, el ancho de banda necesario para realizar la transmisión puede ser muy grande, de forma que necesitamos conocer de antemano el ancho de banda de subida que tenemos y la calidad a la que queremos transmitir para establecer el máximo número de usuarios. Por regla general, podemos calcular el número máximo de usuarios que se pueden conectar mediante la fórmula MaxUser = ancho_de_banda (kbps) / calidad (kbps). Por defecto, MaxUser = 32, pero se puede modificar fácilmente variando el siguiente parámetro:

MaxUser=32

; Password. While SHOUTcast never asks a listener for a password, a

; password is required to broadcast through the server, and to perform

; administration via the web interface to this server. This server should

; consist of o­nly letters and numbers, and is the same server your broadcaster

; will need to enter in the SHOUTcast Source Plug-in for Winamp. THIS VALUE

; CANNOT BE BLANK.

La contraseña que configure el servidor se puede modificarse a través de la opción Password. Por defecto el valor es changeme, pero se recomienda modificarla si queremos limitar el acceso a los contenidos. El usuario tiene que conocer la contraseña para poder conectarse al flujo de datos.

Password=changeme

; PortBase. This is the IP port number your server will run o­n. The

; value, and the value + 1 must be available. If you get a fatal error when

; the DNAS is setting up a socket o­n startup, make sure nothing else o­n the

; machine is running o­n the same port (telnet localhost portnumber -- if you

; get connection refused then you're clear to use that port). Ports < 1024

; may require root privledges o­n *nix machines. The default port is 8000.

El parámetro PortBase es el puerto IP a través del que se ejecutará el servidor. El valor por defecto es PortBase = 8000, válido en la mayoría de los casos. Sin embargo, si tenemos otro servicio activado que utiliza ese puerto (por ejemplo, otro servidor), un firewall, antivirus u otro programa que impida las conexiones a ese puerto, el parámetro debe modificarse para poder aceptar peticiones de conexión, o han de modificarse las reglas del firewall/antivirus. Se recomienda utilizar un puerto superior al 1024 –los valores inferiores pueden requerir permisos de administrador-.

PortBase=8000

; ***************************

; Optional Parameters

; ***************************

; ***************************

; Logging configuration

; ***************************

; LogFile: file to use for logging. Can be '/dev/null' or 'none'

; or empty to turn off logging. The default is ./sc_serv.log

; o­n *nix systems or sc_serv_dirsc_serv.log o­n win32.

; Note: o­n win32 systems if no path is specified the location is

; in the same dir as the executable, o­n *nix systems it is in the

; current directory.

Cuando se ejecuta el servidor, todas las acciones que se realicen se van guardando en un archivo *.log que permite monitorizar cuando se desee la actividad del servidor. El parámetro LogFile permite cambiar el archivo en el que se guardará dicha actividad. Por defecto el valor es sc_serv.log. Si deseamos modificarlo debemos crear un archivo de texto vacío y guardarlo como Nuevo_nombre.log. Si éste se ha creado en el mismo directorio que el archivo de configuración podemos poner únicamente el nombre del archivo. Si se encuentra en otro directorio hemos de especificar la ruta completa del archivo.

LogFile=sc_serv.log

; RealTime displays a status line that is updated every second

; with the latest information o­n the current stream (*nix and win32

; console systems o­nly)

El tiempo de refresco del archivo de actividad anterior puede controlarse desde el parámetro binario RealTime. Si RealTime = 1 el log se actualiza cada segundo, si RealTime = 0 no se graban las acciones del servidor. El valor por defecto es RealTime = 1

RealTime=1

; ScreenLog controls whether logging is printed to the screen or not

; o­n *nix and win32 console systems. It is useful to disable this when

; running servers in background without their own terminals. Default is 1

En ocasiones puede resultar útil poder ver el log de la actividad sin necesidad de abrir el archivo asociado. Para mostrar en la pantalla del servidor la actividad del mismo existe un parámetro binario que permite activar esta opción. El valor por defecto es 1, lo que implica que se mostrará la actividad del servidor en pantalla. Un valor 0 desactiva esta opción.

ScreenLog=1

; ShowLastSongs specifies how many songs to list in the /played.html

; page. The default is 10. Acceptable entries are 1 to 20.

Cuando hemos lanzado la aplicación de radio y estamos emitiendo, los usuarios pueden ver las últimas pistas que se han reproducido en la transmisión. El parámetro ShowLastSongs permite configurar cuántas canciones puede ver el usuario. El valor por defecto es 10, y los valores válidos se mueven entre 1 y 20.

ShowLastSongs=10

; W3CEnable turns o­n W3C Logging. W3C logs contain httpd-like accounts

; of every track played for every listener, including byte counts those listeners

; took. This data can be parsed with tools like Analog and WebTrends, or given

; to third parties like Arbitron and Measurecast for their reporting systems.

; Default is Yes (enabled).

La opción W3CEnable permite almacenar las estadísticas de cada canción –o pista sonora- que se está emitiendo, de forma que se puedan controlar el número de usuarios que están escuchando en cada momento. El valor por defecto es Yes.

W3CEnable=Yes

; W3CLog describes the name of the logfile for W3C logging. Default logfile is

; sc_w3c.log, in the same directory wherever the DNAS gets started from.

Al igual que se hacía con la actividad del servidor, se puede crear un archivo *.log que incluya el monitoreo de las estadísticas del servidor, si la opción anterior está activada. El valor por defecto del parámetro W3CLog es sc_w3c.log, pudiéndose modificar de manera análoga al parámetro LogFile.

W3CLog=sc_w3c.log

; ***************************

; Network configuration

; ***************************

; SrcIP, the interface to listen for source connections o­n (or to make relay

; connections o­n if relaying). Can and usually will be ANY or 127.0.0.1

; (Making it 127.0.0.1 will keep other machines from being able to

; broadcast using your shoutcast server )

SrcIP configure las direcciones IP que se admitiràn en el servidor si realizan una petición. El parámetro por defecto, ANY, admite cualquier dirección IP que intente conectarse. Si queremos limitar el acceso a un rango de direcciones IP, o admitir sólo a algunas, debemos modificar este parámetro.

SrcIP=ANY

; DestIP, IP to listen for clients o­n (and to contact yp.shoutcast.com)

; can and usually will be be ANY. If your machine has multiple IP addresses,

; set this to the o­ne you want it to be accessed by.

Un equipo puede disponer de múltiples direcciones IP. A través de DestIP podemos definir a qué IP accederá el usuario cuando intente conectarse. En el caso típico una máquina sólo dispone de una IP, de forma que podemos dejar el valor por defecto, DestIP = ANY.

DestIP=ANY

; Yport, port to connect to yp.shoutcast.com o­n. For people behind caching

; webproxies, change this to the alternate port (666 is what it might be,

; check www.shoutcast.com if you have problems). Otherwise, leave this at 80.

; We're actively working o­n re-opening port 666, but as of release the o­nly

; working port is port 80.

El usuario puede acceder a la página web yp.shoutchast.com para acceder al servicio de radio o­n-line. Yport configura el puerto a través del cual se entra en la página web. El valor por defecto es 80 y, en general, no debe cambiarse.

Yport=80

; NameLookups. Specify 1 to perform reverse DNS o­n connections.

; This option may increase the time it takes to connect to your

; server if your DNS server is slow. Default is 0 (off).

Cuando un usuario se conecta a una dirección, un servidor DNS traduce los valores de la dirección –alias- para redirigir el contenido a una dirección IP concreta. El parámetro NameLookups permite las conexiones DNS inversas. Los valores del parámetro NameLookups pueden ser 1 (encendido) y 0 (apagado). Por defecto, esta opción está apagada.

NameLookups=0

; ***************************

; Server configuration

; ***************************

; AdminPassword. This password (if specified) changes the

; behavior of Password to be a broadcast-only password, and

; limits HTTP administration tasks to the password specified

; here. The broadcaster, with the password above, can still

; log in and view connected users, but o­nly the AdminPassword

; will grant the right to kick, ban, and specify reserve hosts.

; The default is undefined (Password allows control for both

; source and admin)

Al margen de la contraseña que utiliza el usuario para conectarse, el administrador puede configurar otra contraseña para expulsar o prohibir la entrada de determinaos usuarios. El valor por defecto, desactivado –el carácter “;” permite que esta opción no se tome en consideración-, es adminpass.

; AdminPassword=adminpass

; AutoDumpUsers controls whether listeners are disconnected if the source

; stream disconnects. The default is 0.

A través de AutoDumpUsers se puede configurar si los usuarios son desconectados de la emisora si el flujo de datos se desconecta. Se trata de un valor binario que, por defecto, vale 0.

AutoDumpUsers=0

; AutoDumpSourceTime specifies how long, in seconds, the source stream is

; allowed to be idle before the server disconnects it. 0 will let the source

; stream idle indefinately before disconnecting. The default is 30.

Cuando el servidor deja de recibir datos por parte del emisor puede esperar cierto tiempo antes de desconectarse. Este parámetro se maneja desde la opción AutoDumpSourceTime. Este valor numérico, que vale por defecto 30 segundos, puede establecerse como 0 si queremos que el servidor no se desconecte cuando el flujo de datos lo haga.

AutoDumpSourceTime=30

; ContentDir specifies the directory location o­n disk of where to stream

; o­n-demand content from. Subdirectories are supported as of DNAS 1.8.2.

; Default is ./content, meaning a directory named content in the same directory

; as where sc_serv was invoked from.

El servidor SOUTHCAST permite ofrecer contenidos bajo demanda. El directorio que contiene los flujos de datos se especifica mediante el parámetro ContentDir, desactivado –comentado- por defecto con el valor ./content

; ContentDir=./content

; IntroFile can specify a mp3 file that will be streamed to listeners right

; when they connect before they hear the live stream.

; Note that the intro file MUST be the same samplerate/channels as the

; live stream in order for this to work properly. Although bitrate CAN

; vary, you can use '%d' to specify the bitrate in the filename

; (i.e. C:intro%d.mp3 would be C:intro64.mp3 if you are casting at 64kbps).

; The default is no IntroFile

Podemos programar, también, que la radio reproduzca un archivo *.mp3 introductorio cuando un usuario se conecta a la emisora. Dicho archivo puede configurarse desde la opción IntroFile, desactivada por defecto.

; IntroFile=c:intro%d.mp3

; BackupFile can specify a mp3 file that will be streamed to listeners over

; and over again when the source stream disconnects. AutoDumpUsers must be

; 0 to use this feature. When the source stream reconnects, the listeners

; are rejoined into the live broadcast.

; Note that the backup file MUST be the same samplerate/channels as the

; live stream in order for this to work properly. Although bitrate CAN

; vary, you can use '%d' to specify the bitrate in the filename

; (i.e. C:ackup%d.mp3 would be C:ackup32.mp3 if you are casting at 32kbps).

; The default is no BackupFile

Si la emisora se desconecta podemos transmitir continuamente un archivo *.mp3.Este archivo se configura mediante el parámetro BackupFile, desactivado por defecto. Si queremos usar esta opción, es necesario que AutoDumpUsers = 0. Cuando el flujo de datos de la emisora se reestablezca los usuarios dejarán de escuchar este archivo y volverán a la emisión normal.

; BackupFile=C:intro%d.mp3

; TitleFormat specifies a format string for what title is sent to the listener.

; For example, a string of 'Justin Radio' forces the title 'Justin Radio' even

; when the source changes the title. You can use up to o­ne '%s' in the string

; which lets you contain the title from the source. For example, if your

; TitleFormat is 'Justin Radio: %s', and the source plug-in's title is

; 'Billy plays the blues', then the net title is

; 'Justin Radio: Billy plays the blues'. Note: o­nly works o­n non-relay servers.

; The default is no format string.

Por defecto podemos establecer el título de la emisión desde el Winamp. Sin embargo, a veces precisamos de un mismo título para todas las transmisiones que se realicen, independientemente de la fuente. Si este es el caso, el título puede modificarse desde TitleFormat. Por defecto esta opción está desactivada.

; TitleFormat=Justin Radio: %s

; URLFormat specifies a format string for what url is sent to the listener.

; Behaves like TitleFormat (see above).

; The default is no format string.

Lo mismo puede decirse de la URL que el usuario introduce para conectarse al flujo de datos. I queremos que ésta sea la misma independientemente de la transmisión que se realice, podemos especificar el formato de la misma a través del parámetro, desactivado por defecto, URLFormat.

; URLFormat=http://www.server.com/redirect.cgi?url=%s

; PublicServer can be always, never, or default (the default, heh)

; Any setting other than default will override the public status

; of the source plug-in or of a SHOUTcast server that is being relayed.

La opción PublicServer puede ser configurada como always (siempre), never (nunca) o default (por defecto). Si se activa un valor que no sea por defecto se modificará el servidor, en tanto que la transmisión será o no pública para que otros servidores puedan retransmitir el flujo de datos.

PublicServer=default

; AllowRelay determines whether or not other SHOUTcast servers will be

; permitted to relay this server. The default is Yes.

Si el parámetro AllowRelay está configurado como Yes –valor por defecto-, cualquier otro servidor SHOUTcast puede retransmitir el flujo de datos que estamos emitiendo.

AllowRelay=Yes

; AllowPublicRelay, when set to No, will tell any relaying servers not

; to list the server in the SHOUTcast directory (non-public), provided

; the relaying server's Public flag is set to default. The default is

; Yes.

La opción AllowPublicRelay permite que otros servidores listen nuestra transmisión en el directorio SHOUTcast (directorio no público) para que puedan conectarse. El valor por defecto es afirmativo, Yes.

AllowPublicRelay=Yes

; MetaInterval specifies how often, in bytes, metadata sent.

; You should really leave this at the default of 8192, but the option is

; provided anyway.

El parámetro MetaInterval especifica cada cuanto tiempo, en bytes, se envían los metadatos de la transmisión. El valor por defecto es 8192, y se recomienda encarecidamente no modificarlo.

MetaInterval=8192

; *****************************

; Access Control

; *****************************

; ListenerTimer is a value in minutes of maximum permitted time for

; a connected listener. If someone is connected for longer than this

; amount of time, in minutes, they are disconnected. When undefined,

; there is no limit defined. Default is undefined.

También podemos definir cuánto tiempo máximo permitimos a un usuario escuchar la transmisión. El valor por defecto es indefinido –el valor ListenerTimer está comentado, nótese el carácter “;”-, pero podemos poner un número máximo en minutos.

; ListenerTimer=600

; BanFile is the text file sc_serv reads and writes to/from

; for the list of clients prohibited to connect to this

; server. It's automatically generated via the web

; interface.

El archive sc_serv.ban, generado por una interfaz web, proporciona la lista de clientes que tienen prohibido el acceso al servidor. Por defecto, este archivo se encuentra desactivado –comentado-.

; BanFile=sc_serv.ban

; RipFile is the text file sc_serv reads and writes to/from

; for the list of client IPs which are *ALWAYS* permitted

; to connect to this server (useful for relay servers).

; This file is automatically generated via the web

; interface. Note that if your server is FULL, and someone

; from a Reserved IP connects, the DNAS will force the person

; listening for the longest time off to make room for the new

; connection.

Generado de la misma forma que el archivo anterior, otro fichero, sc_seerv.rip, permite definir aquellas IPs que se permiten siempre. Si el servidor está lleno y una IP reservada incluida en ese fichero se conecta, se fuerza a la persona que lleva más tiempo escuchando a desconectarse. Por defecto, ese fichero no se lee.

; RipFile=sc_serv.rip

; RIPOnly, when set to Yes, will o­nly allow IP addresses listed in the Reserved

; IP list to connect and relay. All other connections for listening will be denied.

; This is really o­nly useful for servers whose sole purpose is to provide the

; primary feed to all public relays. Setting this value to Yes also forces the

; server into Private mode, since listing this server in the directory would

; be pointless. Default is No.

Si se ha creado un archivo con las direcciones IP reservadas –ver parámetro RipFile-, podemos especificar que sean sólo estas las que se puedan conectar o retransmitir el flujo de datos. Para ello podemos variar el valor por defecto de RIPOnly = No.

; RIPOnly=No