Skip to content
mikewadhera edited this page Sep 13, 2010 · 39 revisions

No offense to the wonderful github, but sometimes their system just does not work. Unfortunately, PoolParty has befallen the “my gem does not build” problem. So, until they (and I) can get it resolved, the most efficient way to install PoolParty is to install it manually.

Dependencies required to build gem locally


gem install technicalpickles-jeweler # for gem building tasks
gem install tarruby # depends on libtar -- on macports: sudo port install libtar rb-archive-tar-minitar
gem install rake rubigen activesupport logging ruby2ruby thin net-ssh
gem install RedCloth # note: case sensitive
gem install json ruby-openid stomp  # chef dependencies
gem install chef ohai -s http://gems.opscode.com

Instructions

git clone git://github.com/auser/poolparty.git
cd poolparty
git submodule init
git submoduile update
rake build # if this fails, try a rake clean_pkg && rake gemspec first
[sudo] gem install pkg/poolparty-<version>.gem

Add environment variables

Poolparty commands will by default look for the following AWS environment variables

  • AWS_ACCESS_KEY_ID
  • AWS_SECRET_ACCESS_KEY
  • EC2_PRIVATE_KEY
  • EC2_CERT

for your AWS access key, secret key, private key & cert, respectively.

Stick this in your ~/.bashrc or ~/.profile:

export AWS_ACCESS_KEY_ID="XXX"
export AWS_SECRET_ACCESS_KEY="XXX"
export EC2_PRIVATE_KEY="/path/to/pk-XXX.pem"
export EC2_CERT="/path/to/cert-XXX.pem"

Be sure to open a new terminal before you continue so that your changes are re-loaded.

Testing your installation

Create a clouds.rb, for example:

Then start it with:

$ ./bin/cloud-start -s clouds.rb

If all goes well, your new cloud’s IP will be presented at the end, and you should be greeted with your motd when you login:

$ ./bin/cloud-ssh 
master	174.129.119.9	i-b33559da
Hello World!
Last login: Mon Apr 13 06:25:20 2009 from XX.XX.XX.XXX
root@ip-10-251-39-86$:

You can get a list of your running clouds with cloud-list:

$ ./bin/cloud-list 
*** Listing cloud hello_world
****** Active instances
master	174.129.119.9	i-b33559da

To terminate, run:

$ ./bin/cloud-terminate 
Shutting down i-b33559da

notes

poolparty gathers most of the dependencies and configuration files for the cloud at /tmp/poolparty. This directory is rsynced to the server, so if you want to make changes, be sure to rm -rf /tmp/poolparty to ensure none of the old, cached data is being used

older versions of net/ssh (<= 2.0.4) do not play well with poolparty. recommend at least 2.0.11.

Clone this wiki locally