1. Create and log into a CentOS 6.x or Red Hat Enterprise Linux 6.x system as a user with sudo rights

  2. Become root

    sudo -s 
  3. Disable SELinux (which we're not currently set up to support)

    echo 0 > /selinux/enforce Edit `/etc/selinux/config` and change the value of `SELINUX` from `enforcing` to `permissive` 
  4. Install puppet from the Puppet Labs repository

    rpm -ivh yum install puppet 
  5. Install git

    yum install git 
  6. Download and extract the Avalon install script

    wget -O flat.tar.gz tar xzf flat.tar.gz 
  7. cd avalon-installer-flat

  8. Set up the installation variables

    INSTALL_DIR=`pwd` ln -s $INSTALL_DIR/files /etc/puppet/avalon_files cd $INSTALL_DIR/manifests 
  9. Collect facts about your installation to feed to puppet

    avalon_admin_useran email address for the initial avalon collection/group
    avalon_dropbox_passwordthe plaintext password for the dropbox usernil
    avalon_dropbox_password_hashthe pre-hashed password for the dropbox usernil
    avalon_dropbox_userthe login for the Avalon dropbox useravalondrop
    avalon_public_addressthe hostname clients should connect toOutput of hostname -f
    rails_envthe Rails environment to run avalon underproduction

    NOTE: Either avalon_dropbox_password or avalon_dropbox_password_hash is required. All other facts are optional.

  10. Execute the puppet script, passing selected facts as environment variables prefixed with FACTER_, e.g. FACTER_avalon_dropbox_password=dropithere FACTER_rails_env=development \ puppet apply --fileserverconfig=$INSTALL_DIR/fileserver.conf --modulepath=$INSTALL_DIR/modules \ --hiera_config=$INSTALL_DIR/hiera/hiera.yml --templatedir=$INSTALL_DIR/templates ./init.pp --detailed-exitcodes 
  11. Be patient. The manifest needs to download, install and configure a whole lot of dependencies and servers. This could take 30 minutes or more even with a fast connection.

  12. When the script finishes, open a web browser and connect to the public address you configured above (e.g., Create a new user with email, this is the default collection_manager and group_manager.

NOTE: Puppet 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 Puppet to display a series of errors about failed dependencies. Fortunately, Puppet can usually figure out how to make things right. Simply repeat the puppet apply ... command in step 10 to try to repair the install.


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, but the manual install will require attention to make sure the required ports are open and accessible.

80HTTP (Avalon)Yes
1935RTMP (red5)Yes
5080HTTP (red5)No
8983HTTP (Fedora/Solr)No
18080HTTP (Matterhorn)Yes

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: