Skip to content

Latest commit

 

History

History
56 lines (43 loc) · 2.59 KB

README.md

File metadata and controls

56 lines (43 loc) · 2.59 KB
Raw

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