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.
Disable SELinux (which we're not currently set up to support)
Install puppet from the Puppet Labs repository
Download and extract the Avalon install script
Set up the installation variables
Create hiera/data/custom.yaml and collect facts to feed to puppet about your installation:
Available facts and default values:
Fact Description Default avalon::config::admin_user an email address for the initial avalon collection/group manager firstname.lastname@example.org avalon::config::dropbox_user the login for the Avalon Dropbox user avalondrop avalon::config::dropbox_password the plaintext password for the Avalon Dropbox user
avalon::config::dropbox_password_hash the pre-hashed password for the Avalon Dropbox user
avalon_public_address the hostname clients should connect to Output of
rails_env the Rails environment to run avalon under production
NOTE: Either avalon_dropbox_password or avalon_dropbox_password_hash is required. All other facts are optional.
Execute the puppet script, passing selected facts as environment variables prefixed with
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.
When the script finishes, open a web browser and connect to the public address you configured above (e.g.,
http://avalon.example.edu/) Create a new user with email email@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 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. Here are the manual instructions.