Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 34 Next »

This documentation is for Release 2.0.0. For previous versions of Avalon look in the page history at version v.28.

These instructions will walk you through the process of building and running a VirtualBox virtual machine containing CentOS, Avalon 2.0, Fedora, and Opencast Matterhorn. The process is automated end-to-end using Vagrant and Puppet. The virtual machine is configured to use network port forwarding, so Avalon's web interface will be accessible via a specific port number (10080) on the host machine. The virtual machine created using this process does not contain sample content.

Instructions

  1. Download and install VirtualBox (v4.2.8 or higher) for your host machine
  2. Download and install Vagrant (v1.1.5 or higher) for your host machine
  3. Download and extract the Avalon install script (as a zip or tar.gz)
  4. In a terminal window, cd to the avalon-installer-flat directory you just extracted
  5. Type vagrant up
  6. If this is the first time the script has been run, you will be asked for some information with which to initialize the Avalon installation:
    • A username for the Avalon dropbox user (default is avalondrop, to accept press enter)
    • A password for the Avalon dropbox user (set your own)
    • The email address of the initial Avalon collection/group manager account (Default is archivist1@example.com, to accept press enter. Use this address to log in after step 9 where you will set the password for this account.)
    • The Rails environment to run Avalon under (default is production, to accept press enter)
  7. Be patient. The script needs to download and launch a bare-bones Linux VM, then download, install and configure a whole lot of dependencies and servers. This could take 30 minutes or more even with a fast connection.
  8. When the script finishes, open a web browser and connect to http://localhost:10080/
  9. Click login and then select "Create an Identity" 
  10. Use archivist1@example.com to log in and set a password.

NOTE: The installer needs to download dozens of system packages, software distributions, source files, and other information, largely from trusted third party repositories. Sometimes, one or more repositories might be offline, unresponsive, or otherwise unavailable, causing the Puppet provisioning software to display a series of errors about failed dependencies. Don't Panic. Fortunately, Puppet can usually figure out how to make things right. Simply type vagrant provision to try to repair the install. If it doesn't seem to work, you can always vagrant destroy and vagrant up again to start over.

Controlling the Virtual Machine

In order to...Type...
...put the Avalon VM into "sleep state"vagrant suspend
...resume a suspended VMvagrant resume
...shut down the Avalon VM, but keep it aroundvagrant halt
...terminate the VM and delete it from the host machinevagrant destroy
...restart a halted VM, or recreate a destroyed onevagrant up

Ports

The Avalon Media System requires several ports to be open to client browsers. The Vagrant install handles all the port forwarding for local access automatically:

PortPurposeExternal?Vagrant Mapping
80HTTP (Avalon)Yes10080
1935RTMP (red5)Yes11935
5080HTTP (red5)No-
8983HTTP (Fedora/Solr)No-
18080HTTP (Matterhorn)Yes18080

Using the System

You can find specific information about using the system in the Collection Manager's Guide. Upload items individually or via batch.  Batch demo content is available for your convenience, which includes the media files and an excel document necessary to run a batch.  You can submit a batch directly via SFTP using the following settings:

hostnamelocalhost
port2222
username/passwordwhatever you entered in step 6 above

Known Issues - a list of bugs, workarounds, and cautions.

  • No labels