Airtime 2.3 for Broadcasters
Automated installation
This installation method is intended for computers running Ubuntu or Debian GNU/Linux, and is the recommended method for production Airtime systems. If you have previously performed a manual installation of Airtime on the server, you should run the airtime-uninstall script to remove it before setting up the server for automated installation.
Set up repositories for Ubuntu
When installing on an Ubuntu server, a few of the packages that Airtime relies on are in the Ubuntu universe or multiverse repositories. If either of these repositories is disabled, you can enable them in the /etc/apt/sources.list file, by opening the nano editor in your server's console. The nano editor should be installed by default, but if not, you can install it with the command:
sudo apt-get install nano
Then open the sources.list file with the command:
sudo nano /etc/apt/sources.listFor an Ubuntu 10.04 Lucid server, find the lines which begin deb and end with lucid universe or lucid-updates universe, adding multiverse to the end of these lines, if it is not there already. Other versions of Ubuntu will have similar lines. The multiverse repository is required for the libmp3lame0 library, which is an MP3 encoder.
The exact repository mirror URLs in your sources.list file will differ from the above screenshot, depending on your location.
The Sourcefabric repository contains packages for Airtime, and any other packages which Airtime requires. To add the Sourcefabric repository to an Ubuntu Lucid server, scroll to the end of the sources.list file and add the following line:
deb http://apt.sourcefabric.org/ lucid main
For Ubuntu 12.04 Precise or 12.10 Quantal substitute precise or quantal in place of lucid in the line above.
Press Ctrl+O (the Ctrl key and the letter O together) to save the file, then Ctrl+X to exit the nano editor.
Set up repositories for Debian
On a Debian squeeze server, you can edit the /etc/apt/sources.list file as root with the command:
nano /etc/apt/sources.list
Packages for MP3 encoding are not included in the Debian squeeze repositories. You can obtain the necessary libmp3lame0 package by adding the following repository to the end of the file:
deb http://backports.debian.org/debian-backports squeeze-backports main
To add the Sourcefabric repository to a Debian squeeze server, add the following line to the end of the file:
deb http://apt.sourcefabric.org/ squeeze main
Press Ctrl+O (the Ctrl key and the letter O together) to save the file, then Ctrl+X to exit the nano editor.
Install the Sourcefabric signing key
Reload the system's package list with:
sudo apt-get update
You will see an error message about a missing public key.
To fix this system error, you need to install the sourcefabric-keyring package, which contains the package signing key. This encryption key is a security measure which helps ensure that the Airtime packages you will be downloading in future have not been tampered with by a third party. You can install the key with the command:
sudo apt-get install sourcefabric-keyring
When prompted, press the y key on your keyboard to install the sourcefabric-keyring package without verification. If you wish to verify the authenticity of the package signing key, please contact Sourcefabric for assistance.
sudo apt-get updateYou should no longer see the error message about the missing public key.
Install the database management system
Airtime uses a PostgreSQL database to keep track of media assets and associated metadata in its storage server. Depending on the scale of your Airtime installation and the hardware available, you may wish to install PostgreSQL on a separate server. If you only have one server, you can install the postgresql package on the same machine as Airtime with the command:
sudo apt-get install postgresql
Install a streaming server
Optionally, you may wish to stream directly from Airtime to an Icecast media distribution server, without requiring a soundcard or mixer in the broadcast chain. This option is particularly suitable for fully automated stations, in which all shows are played out using Airtime. You can install the icecast2 package on your server with the command:
sudo apt-get install icecast2
In some scenarios, you may wish to stream from Airtime to a remote Icecast server, for example when Icecast is installed on a server in a data center with greater bandwidth available than an Airtime server located at your broadcast studio has. This separation may become necessary if your stream becomes popular, because each additional listener which connects to the Icecast stream uses additional bandwidth. In this case, you do not need to install the icecast2 package on the same server as Airtime.
Before running Icecast on a remote server for the first time, you should edit the file /etc/icecast2/icecast.xml to change the default <source-password>, <relay-password> and <admin-password> values from hackme to something more secure. On more recent GNU/Linux distributions, such as Ubuntu 12.04 'Precise Pangolin' or later, you may be prompted for these settings during the installation of Icecast.
sudo nano /etc/icecast2/icecast.xml
You should also set the value of <hostname> to the domain name of the Icecast server, for example:
<hostname>icecast.example.com</hostname>
This step ensures that stream URLs are generated correctly by the Icecast server.
Save and close the icecast.xml file with Ctrl+O and Ctrl+X. Then set the Icecast server to start automatically when the server boots in the /etc/default/icecast2 file:
sudo nano /etc/default/icecast2
by setting the value of ENABLE to true on the last line of that file:
ENABLE=true
Save and close this file with Ctrl+O and Ctrl+X, then start Icecast:
sudo service icecast2 start
The server should respond:
Starting icecast2: Starting icecast2 Detaching from the console icecast2.
Install Airtime
You can now install the Airtime package with:
sudo apt-get install airtime
This command will install all of the Airtime components, plus any other packages that Airtime requires in order to run.
Reading package lists... Done Building dependency tree Reading state information... Done Suggested packages: airtime-audio-samples The following NEW packages will be installed airtime 0 upgraded, 1 newly installed, 0 to remove and 2 not upgraded. Need to get 8,446kB of archives. After this operation, 33.3MB of additional disk space will be used. Get: 1 http://apt.sourcefabric.org/ lucid/main airtime 2.3.0-1 [8,446kB] Fetched 8,446kB in 8s (1,015kB/s) Preconfiguring packages ... Selecting previously deselected package airtime. (Reading database ... 657254 files and directories currently installed.) Unpacking airtime (from .../airtime_2.3.0-1_all.deb) ...
Once all the packages have been downloaded and installed, you will be asked a few questions about the configuration of the Airtime system. You can accept the default settings by pressing the Enter key, or use the Tab key to change your selection.
Firstly, you will asked if you wish to create an Apache virtual host web server configuration automatically.
If so, you will need to enter the domain name that your station staff will use to access Airtime. For a test server that will only be accessed directly from the same machine, you can use the default setting of localhost here.
Next, set the contact email address of the server administrator, which is good practice in case of any server problems. For a test server, using an address at the localhost is acceptable.
Debian and Ubuntu servers are set up with a default Apache configuration, which might block station staff from accessing Airtime. If you wish, this default configuration can be removed automatically for you.
If you are installing Airtime and Icecast on the same machine, you can set the hostname and passwords for the Icecast server during the Airtime installation.
First, set the hostname of the Icecast server. For test installs in which you have Icecast installed on the same machine as Airtime, you can use localhost here.
The security of your streaming server depends on the strength of the passwords that you choose. You should set strong passwords for source, relay and admin access.
By default, Airtime stores media files under the path /srv/airtime/stor/ but you can specify an alternative path if you wish. If you change this setting, the new path must end with a slash. This main storage path is separate from the watched folders which are configured after installation, in the Airtime administration interface. See the chapter Media Folders for details of how to add watched folders.
Finally, you have the option to set a more secure password for Airtime's admin user than the default of admin. You could change the password for the admin user later, in the Airtime administration interface, but this would mean that your installation would be insecure until you carried out that task.
On some GNU/Linux distributions, you may be warned about upgrading the rabbitmq-server package, even if you have never installed this package before. If RabbitMQ is only being used by Airtime on your server, it is safe to press the Enter key to continue.
The Airtime installer will then run a script to check that your server environment is set up correctly.
*** Verifying your system environment, running airtime-check-system *** AIRTIME_STATUS_URL = http://localhost:80/api/status/format/json/api_key/%%api_key%% AIRTIME_SERVER_RESPONDING = OK KERNEL_VERSION = 2.6.32-45-generic MACHINE_ARCHITECTURE = x86_64 TOTAL_MEMORY_MBYTES = 6128212 TOTAL_SWAP_MBYTES = UNKNOWN AIRTIME_VERSION = 2.3.0 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 = 1417 PLAYOUT_ENGINE_RUNNING_SECONDS = 18397 PLAYOUT_ENGINE_MEM_PERC = 0.2% PLAYOUT_ENGINE_CPU_PERC = 0.0% LIQUIDSOAP_PROCESS_ID = 2187 LIQUIDSOAP_RUNNING_SECONDS = 18381 LIQUIDSOAP_MEM_PERC = 0.3% LIQUIDSOAP_CPU_PERC = 10.4% MEDIA_MONITOR_PROCESS_ID = 2164 MEDIA_MONITOR_RUNNING_SECONDS = 18382 MEDIA_MONITOR_MEM_PERC = 0.2% MEDIA_MONITOR_CPU_PERC = 0.0% RABBITMQ_PROCESS_ID = 1672 RABBITMQ_RUNNING_SECONDS = 18382 RABBITMQ_MEM_PERC = 0.3% RABBITMQ_CPU_PERC = 0.0% -- Your installation of Airtime looks OK! ************ Install Complete ************
You should now be able to log in to the Airtime administration interface, as shown in the Getting started chapter. See the Host configuration chapter for advanced settings.
Install a PHP cache
This optional step can improve the responsiveness of the Airtime administration interface. Various PHP cache software is available, but the recommended cache to use with Airtime is APC (http://pecl.php.net/package/APC). You should uninstall or disable any other PHP cache that may be present on the server, such as XCache, before installing APC. This is because having multiple caches enabled can cause problems for PHP. You can remove the XCache package php5-xcache from a Debian or Ubuntu server with the command:
sudo apt-get remove php5-xcache
APC is available in Debian or Ubuntu as the php-apc package. You can install this package and get it working with the following commands:
sudo apt-get install php-apc sudo invoke-rc.d apache2 restart
APC has an administration page, which is not installed by default. If you wish, you can install and configure it with the following commands:
sudo cp /usr/share/doc/php-apc/apc.php.gz /usr/share/airtime/public/ sudo gunzip /usr/share/airtime/public/apc.php.gz sudo nano /usr/share/airtime/public/apc.php
You should set an admin password for the apc user on line 42 of the file:
defaults('ADMIN_PASSWORD','mynewpassword');
Save the apc.php file with Ctrl+O and close it with Ctrl+X. Then open a web browser at the apc.php page of your Airtime server, such as:
http://airtime.example.com/apc.php
You will then be able to confirm that APC is working, and view some statistics for the cache.
Enhanced Liquidsoap packages
The Ubuntu 12.10 'Quantal Quetzal' distribution includes an official Liquidsoap 1.0.1 package that will work with Airtime, but Sourcefabric's own package of Liquidsoap 1.0.1 includes a patch which prevents crashes when decoding AAC files.
After setting up the apt.sourcefabric.org repository as shown above, you can search for other versions of the Liquidsoap package available to your server with the following command:
apt-cache show liquidsoap
This command will list the versions available, with short descriptions. You can then specify the version that you require using an equals sign after the package name, for example:
sudo apt-get install liquidsoap=1.0.1~quantal~sfo-4
where '1.0.1~quantal~sfo-4' is the version reported by the apt-cache show liquidsoap command. The system may warn that this package installation represents a downgrade, but this is not actually the case. This warning is caused by the numbering system used for non-official Ubuntu packages.