Scripts
Quick Start allows you test your hardware and get familiar with voctomix and the provisioning process. Do this before you start trying to set up cameras and make other customizations.
mk_usb_installer.sh
This is the main script to build the USB installer. It makes a USB installer that gets preseed configuration and runs ansible. It currently supports Debian and Ubuntu.
The script is not self contained and needs bits & pieces from the ansible repository and the internet to work properly.
A more complete documentation of this script can be found here.
Step by step details
Here is what the mk_usb_installer.sh script does:
Downloads an installation image (Debian or Ubuntu)
Sets kernel parameters to preseed the installer
Formats and mounts the USB key
Installs the installation image on the USB key
Unmounts the USB key
When you boot the USB installer:
Boot into d-i (the Debian Installer)
Use DHCP to configure a network interface
Fetch the preseed files from the http_server
Partition and format
Install Debian
git clone the playbook and inventory repos
Create some scripts to run ansible
Install Grub and reboot
Run the script created in step 7
Reboot
http_server.sh
This script runs an HTTP server so that the USB installer can pull additional
configuration files. The root directory being served is
roles/pxe/tftp-server/files.
test_thumb.sh
This script tests the USB stick by booting it in a QEMU x86_64 system. You will need to install these dependencies and add yourself to the disk group:
$ sudo apt install qemu qemu-utils qemu-system ovmf
$ sudo adduser $USER disk
It takes one argument - the path to the USB device, for example /dev/sdb:
$ ./test_thumb.sh /dev/sdb
test_pxe.sh
This script tests the PXE booting environment by booting it in a QEMU x86_64 system. You will need to install those dependencies to run it properly:
$ sudo apt install qemu brctl
You can then run the script this way:
$ ./test_pxe.sh