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 57 Next »

This documentation is for Release 3.x. For the Release 1 version of this page, see v.18. For the Release 2 version of this page, see v.35.

Instructions

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

    The current Puppet script has issues if executed on a clean, "minimal" CentOS. A "minimal desktop" CentOS is recommended.

    The current Puppet script requires Ruby version 1.9.3 or higher.

  2. Become root

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

    echo 0 > /selinux/enforce 
    sed -ie "s/SELINUX=enforcing/SELINUX=permissive/" /etc/selinux/config
    
  4. Install puppet from the Puppet Labs repository

    rpm -ivh http://yum.puppetlabs.com/el/6/products/i386/puppetlabs-release-6-10.noarch.rpm
    yum install puppet


  5. Install git

    yum install git 
  6. Install Ruby 1.9.3 if ruby current version is lower

    ruby -v
    #The following command won't work the first time. 
    # It will request you download the signatures first 
    # and provide the command to download it.
    curl -sSL https://get.rvm.io | bash -s stable --ruby
    source /usr/local/rvm/scripts/rvm
    rvm install 1.9.3
    rvm use 1.9.3
  7. Install json extensions for the system ruby

    yum install ruby-json
  8. Download and extract the Avalon install script

    wget http://www.avalonmediasystem.org/downloads/avalon-installer-flat.tar.gz -O flat.tar.gz 
    tar xzf flat.tar.gz
    cd avalon-installer-flat
  9. Set up the installation variables

    export INSTALL_DIR=`pwd`
    ln -s $INSTALL_DIR/files /etc/puppet/avalon_files
  10. Create hiera/data/custom.yaml and collect facts to feed to puppet about your installation:

    ruby -r './fact_gatherer.rb' -e 'FactGatherer.gather_facts'

     

  11. Execute the puppet script

    puppet apply --fileserverconfig=$INSTALL_DIR/fileserver.conf \
    --modulepath=$INSTALL_DIR/modules --hiera_config=$INSTALL_DIR/hiera/hiera.yaml \
    --templatedir=$INSTALL_DIR/templates manifests/init.pp --detailed-exitcodes


    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 for your server (e.g.,http://avalon.example.edu/) Create a new user with email archivist1@example.com, 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 11 to try to repair the install.

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

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

Using the System

  • No labels