PigeBox¶ ↑

Free continuous recording solution

Components¶ ↑

Debian stable system
read-only root fs
dhcp network configuration
zeroconf hostname (avahi)
alsa continuous recording daemon (github.com/albanpeignier/alsabackup)
http access (nginx)
ssh access

Network¶ ↑

The network configuration is retrieved by dhcp at boot. The zeroconf hostname pigebox.local is published on the network.

The box is reachable via :

ssh root@pigebox.local
pigebox.local

The record files are available via :

pigebox.local/pige/

Storage¶ ↑

disk storage
15 minutes recording files
automatic cleaning of older files

The storage filesystem must have the label pige and be writable for user pige. For example, to create your storage filesystem :

$ ssh root@pigebox.local

# fdisk /dev/sda
...
# mke2fs -L pige -j /dev/sda1
# mount /srv/pige
# chown pige:audio /srv/pige

The alsa.backup daemon will detect automatically the new mount.

Monitoring¶ ↑

Munin¶ ↑

A munin node is started at boot.

Graphs are available on pigebox.local/munin/. These statistics are reset at each reboot.

For persistent statistics, use a external munin manager by adding a node for pigebox.local.

Log¶ ↑

alsa.backup daemon and cron log messages in syslog.

For the moment, it requires an ssh session :

ssh root@pigebox.local tail -f /var/log/syslog

Distribution¶ ↑

iso image
disk image

Build¶ ↑

To create quickly a first image :

rake setup pigebox:rebuild

The image can be backup and restored to save bootstrap time :

rake pigebox:bootstrap pigebox:backup
# Then as many times as you need :
rake pigebox:restore pigebox:configure pigebox:dist:iso

To build an iso image :

rake pigebox:dist:iso

To build an disk image :

rake pigebox:dist:disk

You can configure the build with using a config file :

ImageBuilder.default_debian_mirror = "http://localhost:9999/debian"
ImageBuilder.ssh_pubkey = ENV['HOME'] + "/.ssh/another_id_rsa.pub"

See +rake -T+ for tasks details :

rake pigebox:backup     # Save the current image directory in tar archive
rake pigebox:bootstrap  # Boostrap debian system in image directory
rake pigebox:clean      # Clean image temporary directory
rake pigebox:configure  # Configure the pigebox image
rake pigebox:dist:iso   # Create an iso file from pigebox image
rake pigebox:dist:disk  # Create a disk image
rake pigebox:restore    # Restore the image directory with existing tar archive
rake setup              # Install some of required tools to create pigebox image

Boot¶ ↑

For the moment, an iso image is builded. You can test it with qemu.

Install qemu and its module:

sudo apt-get install qemu kqemu-source
sudo module-assistant a-i kqemu

Create an empty disk:

qemu-img create -f qcow2 /var/tmp/pigebox/disk.img 3G

You will need to initialize the pige storage after first boot (see Storage section).

Create a tap0 network interface:

sudo tunctl -u $USER -t tap0

Start qemu vm:

./script/boot cdrom  # to use iso distribution
./script/boot disk   # to use disk distribution

albanpeignier/pigebox