Preface

This document is part of the Campcaster project, Copyright © 2004 Media Development Loan Fund, under the GNU GPL.

Scope

This document describes how to compile and install Campcaster on an Ubuntu Dapper system. It will probably work, with at most small modifications, on other Ubuntu or Debian systems. For other Linux distributions, please see the general instructions.

Installation instructions

1. Install the tools, libraries and services

Run the apt-get install command given on our wiki page.

2. Obtain the Campcaster sources

If you are reading this, you probably already have the sources, so you can skip to the next step.

If you do not have the sources yet, you need to get the tarballs named campcaster-<version>.tar.bz2 and campcaster-libraries-<version>.tar.bz2. Both can be downloaded from http://sourceforge.net/projects/campcaster/.

3. Compile and install Campcaster

To install Campcaster in /opt/campcaster, do the following: 
tar xfj campcaster-<version>.tar.bz2
tar xfj campcaster-libraries-<version>.tar.bz2
cd campcaster-<version>
./configure --prefix=/opt/campcaster --with-apache-group=www-data
sudo make install

4. Configure the external services

Before you can use Campcaster, you need to set up and configure the web server and the database that Campcaster uses to store its data. Type the following: 
sudo ./bin/postInstallStation.sh --directory=/opt/campcaster 
                --apache-group=www-data 
                --postgresql-dir=/etc/postgresql/8.1/main 
                --postgresql-init-script=/etc/init.d/postgresql-8.1

5. Start Campcaster

After a successful installation, the Campcaster scheduler has to be started, by typing: 
/opt/campcaster/bin/campcaster-scheduler.sh start

To use the the web interface, point your browser to http://localhost/campcaster. You can also use the web interface from other computers; simply put the name or IP number of the computer where Campcaster was installed in place of localhost.

To start Campcaster Studio, type the following: 

/opt/campcaster/bin/campcaster-studio.sh

For your first login, use the following values:

Later you can change the password, and add more users, from the web interface.

You can make the scheduler start automatically when the system boots up, by doing the following: 

sudo cp /opt/livesupport/etc/campcaster-scheduler /etc/init.d/
sudo update-rc.d campcaster-scheduler defaults 92

You can quickly fill your Campcaster storage with audio files using the mass import script: 

sudo /opt/campcaster/bin/import.sh --directory=<some directory>

Have fun!