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 1.9.4, puedes usar el comando:

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

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

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

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

$ sudo ~/airtime-1.9.4/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.

 *** Verifying your system environment ***
CPU                            = Dual Core AMD Opteron(tm) Processor 170
Total RAM                      = 6128244 kB
Free RAM                       = 167276 kB
OS                             = Ubuntu 10.04.3 LTS x86-64
AIRTIME_CONFIG_FILES           = OK
POSTGRESQL_DATABASE            = OK
PYTHON_KOMBU_VERSION           = 1.2.0
PYTHON_POSTER_VERSION          = 0.8.1
PYTHON_MUTAGEN_VERSION         = 1.20
PYTHON_PYINOTIFY_VERSION       = 0.9.2
RABBITMQ_SERVER                = OK
AIRTIME_VERSION_URL            = http://localhost:80/api/version/api_key/%%api_key%%
APACHE_CONFIGURED              = YES
AIRTIME_VERSION                = 1.9.4
PLAYOUT_ENGINE_PROCESS_ID      = 24021
PLAYOUT_ENGINE_RUNNING_SECONDS = 7
LIQUIDSOAP_PROCESS_ID          = 24025
LIQUIDSOAP_RUNNING_SECONDS     = 7
MEDIA_MONITOR_PROCESS_ID       = 24078
MEDIA_MONITOR_RUNNING_SECONDS  = 7
SHOW_RECORDER_PROCESS_ID       = 24055
SHOW_RECORDER_RUNNING_SECONDS  = 7
ICECAST_PROCESS_ID             = 23649

  -- System setup looks OK!

********************** Install Complete ***********************

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 libao-ocaml \
libapache2-mod-php5 libcamomile-ocaml-dev libesd0 libmad-ocaml \
libmp3lame-dev libportaudio2 libsamplerate0 libsoundtouch-ocaml \
libtaglib-ocaml libvorbis-ocaml-dev monit mpg123 odbc-postgresql \
patch php-pear php5-curl php5-gd php5-pgsql python2.6 \
python-virtualenv rabbitmq-server sudo tar unzip

La otra dependencia que debes instalar es phing (asegúrate de anotar el número de versión correspondiente):

$ sudo pear channel-discover pear.phing.info
$ sudo pear install phing/phing-2.4.2

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

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

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

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

$ 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-1.9.4/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/*

$ 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-1.9.4/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-1.9.4/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