This Puppet script starts an AWS EC2 instance, then deploys fcrepo-webapp to a stand-alone Tomcat7 application server.

Note, this script has only been tested on Ubuntu 12.10 and Mac OS X 10.6.

To run this script:

1. Install the following software:

• For Ubuntu:

sudo apt-get install cloud-utils puppet-common git ec2-api-tools -y

• For Mac OS X:

1. We will assume you have Git already installed.
2. First, install Puppet via the official installers
3. Retrieve the unofficial source for cloud-init/cloud-utils here and install it via:

   sudo python setup.py install```

4. Install Amazon's EC2 CLI utilities according to these instructions.

• For Arch Linux: (It's recommended to use a tool such as pacaur to install packages from the Arch User Repository, otherwise you will have to install all the dependencies by hand: https://aur.archlinux.org/packages/pacaur/)

1. Install cloud-init-bzr from AUR (just for the dependencies): https://aur.archlinux.org/packages/cloud-init-bzr/
2. Since cloud-init lacks write-mime-multipart you can checkout the script from http://bazaar.launchpad.net/~cloud-init-dev/cloud-init/trunk/view/252/tools/write-mime-multipart and put it into e.g. /usr/local/bin/write-mime-multipart
3. Update the first line of the write-mime-multipart script to point at the python2 binary e.g. /usr/bin/python2
4. Install Amazon's ec2-api-tools from AUR: https://aur.archlinux.org/packages/ec2-api-tools/
5. Install Eucalyptus tool set euca2ools from AUR: https://aur.archlinux.org/packages/euca2ools/

2. Put your AWS credentials in the file: ~/.awssecret, in the form:

export AWS_ACCESS_KEY=[your-aws-access-key]

export AWS_SECRET_KEY=[your-aws-secret-key]

3. Clone this project

git clone https://github.com/futures/fcrepo-aws-puppet.git fcrepo-aws-puppet

4. Update the EC2 configuration elements found in:

fcrepo-aws-puppet/cloud-init/create-ec2-instance.conf

• The defaults should be fine
• In your AWS EC2 account, you will need to create a security group and an ssh keypair
• Use the names of the security group and the keypair to populate the respective elements in: create-ec2-instance.conf

5. Run

cd fcrepo-aws-puppet
./cloud-init/create-ec2-instance.sh

Note: There is a script in the root directory which can be run to try out the puppet script locally without starting an EC2 instance:

sudo ./test.sh --noop