This documentation is for Release 6.x.
|These instructions will walk you through the process of downloading, booting, and configuring a CentOS 7.x virtual machine image containing Docker containers of Avalon, Fedora, Red5 and Opencast Matterhorn, with additional instructions on loaded sample audio and video content.|
The Avalon VM is distributed as an Open Virtualization Appliance which should be compatible with these Virtual machine products:
Other virtualization products may be used but they will require manually converting the OVA file into something useful.
The Avalon VM file is located at http://www.avalonmediasystem.org/downloads/avalon-vm.ova and is roughly 2GB. Due to the size, it may take some time to download.
The OVA file currently contains release 6.4.2
Each virtualization product has different methods for using a VM appliance. The tested methods are below. If you use a product which is not listed, please contact us with usage instructions and we will add them here.
Press the "Settings" icon
Users on Apple hardware may get the following error screen when starting the VM:
If you receive this dialog, click the Change Network Settings button followed by the OK in the following dialog to resolve the issue.
Virtual Machine Manager is an open source GUI front end to QEMU, KVM and other Linux-based virtualization products. It comes with Fedora Linux and other distributions. It doesn't directly support OVA files so manual conversion is required.
Unpack the OVA file. $DIST is where the VM files are going to be; $DOWNLOAD is where the OVA file was downloaded.
mkdir $DIST cd $DIST tar xvf $DOWNLOAD/avalon-vm.ova
The .vmdk file is the virtual disk image. The other files are settings for the VM (ovf) and checksum files (mf).
Convert disk image to qcow2
qemu-img convert -f vmdk -O qcow2 *.vmdk avalon-vm.qcow2
The VMDK file shipped is compressed so the new qcow2 file will be roughly twice as large. After the conversion the vmdk file is no longer needed and can be deleted.
Create a new VM
A generic VM product may be set up using these settings:
The disk image in the OVA package is dynamically-allocated with a maximum size of 500G. While the disk image may only use a few gigabytes when it is first used, it will grow as more data is placed into the VM. Most VMs behave unpredictably when the host system doesn't have enough disk space to satisfy guest OS requests. Monitor the disk usage closely.
Once the VM has rebooted and the login screen has appeared, the Avalon system is ready to use.
After you have signed in, Avalon VM can be used like any other Avalon installation. The Avalon Collections Guide contains information for using Avalon. You can create new collections and add items. Additional features can be configured using feature specific documentation.
The sample content can be ingested through a batch ingest process
tar zxvf DemoFixturesBatch.tar.gz
mv ExampleBatchIngest/* /home/avalon/avalon-docker/masterfiles/dropbox/DEMO/
As the samples are ingested, you will see new items being added to the collection. Be patient as the media transcoding may take a while.
If you want to build your own OVA file follow the instructions on https://github.com/avalonmediasystem/avalon-packer
Because the OVA uses Docker and Docker-Compose, you can find instructions on how to navigate the stack on the avalon-docker github page
Change the password.
mount -o remount,rw / passwd root mount -o remount,ro /
Known Issues - a list of bugs, workarounds, and cautions.
In addition, there are some issues for us to consider in future releases of this VM image:
|information||oddity, potential todo item||todo item||issue w/o workaround||issue with workaround|