Create instructions for both vagrant and non-vagrant puppet installs

README.md

@@ -0,0 +1,58 @@
+# Avalon Media System Installer
+
+## Vagrant Virtual Machine Install
+
+1. Download and install [VirtualBox](https://www.virtualbox.org/wiki/Downloads) for your host machine
+2. Download and install [Vagrant](http://downloads.vagrantup.com/) for your host machine
+3. Download and extract the Avalon [install script](https://github.com/avalonmediasystem/avalon-vagrant/archive/flat.tar.gz)
+4. Change to the `avalon-vagrant-flat` directory
+5. Type `vagrant up`
+6. Be patient. The script needs to download and launch a bare-bones Linux VM, then install and configure several dozen dependencies and servers. This could take 30 minutes or more even with a fast connection.
+7. When the script finishes, open a web browser and attach to [http://localhost:10080/](http://localhost:10080/)
+
+## Manual Puppet Install
+
+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 http://yum.puppetlabs.com/el/6/products/i386/puppetlabs-release-6-6.noarch.rpm
+		yum install puppet
+
+5. Install git
+
+		yum install git
+
+6. Download and extract the Avalon [install script](https://github.com/avalonmediasystem/avalon-vagrant/archive/flat.tar.gz)
+
+		wget https://github.com/avalonmediasystem/avalon-vagrant/archive/flat.tar.gz
+		tar xzf flat.tar.gz
+
+7. Change to the `avalon-vagrant-flat` directory
+
+8. Set up the installation variables
+
+		VAGRANT=`pwd`
+		ln -s $VAGRANT/files /etc/puppet/avalon_files
+		cd $VAGRANT/manifests
+
+9. If the hostname clients should connect to is different from the default machine hostname, tell puppet about it
+
+		export FACTER_avalon_public_address=avalon.example.edu
+
+10. Execute the puppet script
+
+		/usr/bin/ruby /usr/bin/puppet apply --fileserverconfig=$VAGRANT/fileserver.conf --modulepath=$VAGRANT/modules --hiera_config=$VAGRANT/heira/heira.yml --templatedir=$VAGRANT/templates ./avalon.pp --detailed-exitcodes
+
+11. Be patient. The script needs to download and launch a bare-bones Linux VM, then install and configure several dozen 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

Vagrantfile

@@ -9,7 +9,7 @@ Vagrant.configure("2") do |config|
   config.vm.box = "nulib"
   config.vm.box_url = "http://yumrepo-public.library.northwestern.edu/nulib.box"
   config.vm.hostname = "avalon-box"
-  config.vm.synced_folder "files", "/etc/puppet/files"
+  config.vm.synced_folder "files", "/etc/puppet/avalon_files"
   config.vm.synced_folder "templates", "/tmp/vagrant-puppet/templates"
   config.vm.provider :virtualbox do |vb|
     vb.customize ["setextradata", :id, "VBoxInternal2/SharedFoldersEnableSymlinksCreate/v-root", "1"]

fileserver.conf

@@ -1,2 +1,2 @@
 [local]
-    path /etc/puppet/files
+    path /etc/puppet/avalon_files