To install, download the latest relase version to a webserver folder. The Pumilio application requires:

• Linux (a current version of Ubuntu is recommended)
• PHP 5.2 or newer
• The LAME mp3 encoder
• The svt.py script requires Python 2.4 or newer, numpy, Python Imaging Library, and audiolab 0.08
  • The application has not been tested with Python 3
• SoX version 14.3.0 or higher
• Imagemagick
• FLAC - Free Lossless Audio Codec (optional)

Create a database and user in MySQL, you can use the mysql client or phpmyadmin. Then, rename the file config.php.dist to config.php and add the MySQL server and credentials:

#Database settings
$host = "localhost";
$user = "";
$password = "";
$database = "";

Then, on your browser, go to the application URL, adding install/. For example, if the address is:

http://somehost.com/pumilio

Then go to:

http://somehost.com/pumilio/install/

This will check the necessary software and folder permissions. Add an administrative user. After this step you can delete the folders install and upgrade.

Installation steps for Ubuntu

To install the necessary software from the command line, follow these steps. First, install the LAMP stack (Apache, PHP5, MySQL):

sudo apt-get install tasksel
sudo tasksel install lamp-server

Install the required packages for audiolab and Pumilio:

sudo apt-get install python-dev python-setuptools python-numpy libsndfile1-dev libasound2-dev imagemagick sox libsox-dev libsox-fmt-all python-imaging flac lame

Then download audiolab version 0.8 and install it:

wget https://pypi.python.org/packages/source/s/scikits.audiolab/scikits.audiolab-0.8.tar.gz
tar -xvzf scikits.audiolab-0.8.tar.gz 
cd scikits.audiolab-0.8/
sudo python setup.py install

Allow uploads of bigger files

The file size limit for uploaded files is determined in the php.ini file, by default 2MB. In Ubuntu its located in /etc/php5/apache2/php.ini. Set the desired value in the variables upload_max_filesize and post_max_size, then restart Apache. Please consult the PHP manual for more info. Look here for some pitfalls to avoid.

To upgrade

If you are upgrading from version 1.0, or newer, replace the files with the last release, without replacing the following folders:

• sounds
• tmp
• sitephotos
• data_sources (if you added something)
• tools (if you added something)

Check the config.php file. It should only contain the MySQL credentials and optional variables listed in the Administrator Guide. Then go to the application address /upgrade (if the address is http://somehost.com/pumilio, then go to http://somehost.com/pumilio/upgrade). This will upgrade the database structure and make all necessary checks. If you miss this step, the application may not work as intended.