Airtime 2.0 para estaciones de radio

Instalación manual

Generalmente, no es necesario que instales Airtime manualmente, a menos que estés probando una versión en desarrollo del programa. Las versiones de Airtime más recomendables para usos de producción están disponibles para descarga y actualización por medio de secure apt, como lo muestra el capítulo Instalación automática

Instalación completa

El libreto airtime-full-install ha sido probado en servidores Ubuntu GNU/Linux y está diseñado para configurar un servidor por ti, usando las preferencias preestablecidas.

1. En la consola o terminal del servidor, descarga Airtime desde https://sourceforge.net/projects/airtime/files/ con wget. Por ejemplo, para descargar la version 2.0.3, puedes usar el comando:

$ wget http://downloads.sourceforge.net/project/airtime/2.0.3/airtime-2.0.3.tar.gz

2. Extrae el archivo descargado en tu directorio raíz. Esto creará un subdirectorio llamado  airtime-2.0.3:

$ sudo tar -xvzf airtime-2.0.3.tar.gz -C ~/

3. Ejecuta el código airtime-full-install

$ sudo ~/airtime-2.0.3/install_full/ubuntu/airtime-full-install

El código de instalación indicará qué archivos están siendo instalados en tu equipo, y los directorios en que están siendo extraídos. Finalmente, ejecutará el código airtime-check-system para confirmar que tu servidor esté funcionando correctamente.

AIRTIME_STATUS_URL             = http://localhost/api/status/format/json/api_key/%%api_key%%
AIRTIME_SERVER_RESPONDING      = OK
KERNEL_VERSION                 = 2.6.32-38-generic
MACHINE_ARCHITECTURE           = x86_64
TOTAL_MEMORY_MBYTES            = 6128220
TOTAL_SWAP_MBYTES              = UNKNOWN
AIRTIME_VERSION                = 2.0.3
OS                             = Ubuntu 10.04.4 LTS x86_64
CPU                            = Dual Core AMD Opteron(tm) Processor 170
WEB_SERVER                     = Apache/2.2.14 (Ubuntu)
PLAYOUT_ENGINE_PROCESS_ID      = 13723
PLAYOUT_ENGINE_RUNNING_SECONDS = 2681
PLAYOUT_ENGINE_MEM_PERC        = 0.2%
PLAYOUT_ENGINE_CPU_PERC        = 0.0%
LIQUIDSOAP_PROCESS_ID          = 13732
LIQUIDSOAP_RUNNING_SECONDS     = 2681
LIQUIDSOAP_MEM_PERC            = 0.4%
LIQUIDSOAP_CPU_PERC            = 24.9%
MEDIA_MONITOR_PROCESS_ID       = 13818
MEDIA_MONITOR_RUNNING_SECONDS  = 2665
MEDIA_MONITOR_MEM_PERC         = 0.2%
MEDIA_MONITOR_CPU_PERC         = 0.0%
RABBITMQ_PROCESS_ID            = 14622
RABBITMQ_RUNNING_SECONDS       = 2553
RABBITMQ_MEM_PERC              = 0.3%
RABBITMQ_CPU_PERC              = 0.0%

-- Your installation of Airtime looks OK!

********************** Install Complete ***********************
Estás listo para proceder al capítulo de Configuración.

Instalación mínima   

El código alternativo airtime-install no configura tu servidor, dándote más opciones para fijar tus requerimientos.

1. En la consola o terminal del servidor, instala la lista de dependencias. Por ejemplo, en Ubuntu 10.04 (Lucid Lynx) LTS puedes ejecutar el comando:

sudo apt-get install apache2 curl ecasound gzip icecast2 lame \
libao-ocaml libapache2-mod-php5 libcamomile-ocaml-data libesd0 \
libmad-ocaml libmp3lame-dev libportaudio2 libpulse0 libsamplerate0 \
libsoundtouch-ocaml libtaglib-ocaml libvorbis-ocaml lsb-release \
monit mpg123 multitail odbc-postgresql patch php-pear php5-curl php5-gd \
php5-pgsql postgresql python2.6 python-virtualenv rabbitmq-server sudo \
tar vorbis-tools

2. Revisa que los módulos del servidor web Apache que usa Airtime estén habilitados: 

$ sudo a2enmod php5 rewrite

El servidor debe responder:

Module php5 already enabled
Module rewrite already enabled

3. Crea un directorio para contener la interfaz web de Airtime:

$ sudo mkdir -p /usr/share/airtime/public

4. Luego, crea un archivo de configuración virtual de Airtime para  Apache:

$ sudo nano /etc/apache2/sites-available/airtime

e ingresa la información siguiente, sustituyendo el nombre de tu servidor con airtime.example.com y la dirección de tu administrador con admin@example.com. Asegúrate de fijar los comandos de DocumentRoot y Directory correctamente. Estos deberían coincidir con el directorio público en que el instalador extraerá la interfaz web, que, de forma predeterminada, es el directorio /usr/share/airtime/public/.

<VirtualHost *:80>
   ServerName airtime.example.com
   ServerAdmin admin@example.com
   DocumentRoot /usr/share/airtime/public
   php_admin_value upload_tmp_dir /tmp

  <Directory /usr/share/airtime/public>
      DirectoryIndex index.php
      AllowOverride all
      Order allow,deny
      Allow from all
  </Directory>
</VirtualHost>

Presiona Ctrl+O para guardar el archivo, luego Ctrl+X para salir del editor nano.

5. Crea el archivo de configuración PHP /etc/airtime/airtime.ini en nano:

$ sudo nano /etc/airtime/airtime.ini

con los siguientes contenidos: 

[PHP]
memory_limit = 512M
magic_quotes_gpc = Off
file_uploads = On
upload_tmp_dir = /tmp

Guarda y cierra nano. Luego, une este archivo a la configuración PHP del sistema con el comando:

$ sudo ln -s /etc/airtime/airtime.ini /etc/php5/conf.d/airtime.ini

6. Habilita la nueva configuración con el comando:

$ sudo a2ensite airtime

El servidor debe responder:

Enabling site airtime.
Run '/etc/init.d/apache2 reload' to activate new configuration!

Puede que necesites deshabilitar la configuración predeterminada del sitio, porque puede interferir con tu instalación de Airtime:

$ sudo a2dissite default

Como sugiere el comando anterior, vuelve a cargar la configuración del servidor web.

$ sudo /etc/init.d/apache2 reload

El servidor debe responder:

 * Reloading web server config apache2
7. Descarga Airtime de https://sourceforge.net/projects/airtime/files/ con wget. Por ejemplo, para descargar la versión 2.0.3, puedes usar el comando:
$ wget http://downloads.sourceforge.net/project/airtime/2.0.3/airtime-2.0.3.tar.gz

8. Extrae el archivo descargado en el directorio raíz. Esta acción creará un subdirectorio llamado airtime-2.0.3:

$ sudo tar -xvzf airtime-2.0.3.tar.gz -C ~/
9. Monit es una utilidad de Airtime que supervisa la ejecución adecuada del sistema. Habilítala abriendo el archivo /etc/default/monit en el editor nano:  
$ sudo nano /etc/default/monit

Encuentra la línea que comience con startup y cambia el valor a 1:

startup=1

Guarda el archivo con Ctrl+O y cierra nano con Ctrl+X. Ahora copia la configuración Monit del directorio de instalación de Airtime en el directorio /etc/monit/conf.d/

$ sudo cp ~/airtime-2.0.3/python_apps/monit/airtime-monit.cfg /etc/monit/conf.d/

Abre el archivo /etc/monit/monitrc en nano:

$ sudo nano /etc/monit/monitrc

Al final del archivo, agrega:

include /etc/monit/conf.d/*
Guarda el archivo con Ctrl+O y cierra con Ctrl+X. Luego, inicia Monit con:
$ sudo invoke-rc.d monit start

Encontrarás más información sobre Monit en el capítulo Usando Monit.

10. En Debian squeeze, asegúrate que el daemon rabbitmq-server halla iniciado:

$ sudo invoke-rc.d rabbitmq-server start

11. Finalmente, ejecuta el código airtime-install:  

$ sudo ~/airtime-2.0.3/install_minimal/airtime-install 

Una vez el código airtime-check-system confirme que la instalación fue exitosa, puedes proceder al capítulo Configuración.

Instalar opciones de código

De forma predeterminada, el código airtime-install preserva cualquier configuración o instalación existente en el servidor. Sin embargo, también es posible dictar la conducta del código con la opción de comando siguiente: 

--help|-h            Displays usage information.
--overwrite|-o       Overwrite any existing config files.
--preserve|-p        Keep any existing config files.
--no-db|-n           Turn off database install.
--reinstall|-r       Force a fresh install of this Airtime version

Desinstalación manual

Para desinstalar manualmente Airtime de tu servidor, ejecuta el código airtime-uninstall en el directorio original de instalación, por ejemplo: 

$ sudo ~/airtime-2.0.3/install_minimal/airtime-uninstall

Optionalmente, también puedes eliminar los archivos de almacenamiento y configuración de Airtime. Si tienes copias, no necesitarás esta información dentro de este servidor particular. El comando rm debe usarse con cuidado, pues no hay manera de revertirlo. 

$ sudo rm -r /srv/airtime
$ sudo rm -r /etc/airtime