Running the Jbrowse AMI
Notes
Amazon's EC2 allows for the deployment of a webserver without the overhead of running a machine yourself. In particular, this may have applications for demonstrations, prototyping, and short-term use. To this end, we've provided an AMI based on Amazon's Fedora 8 AMI, and including a pre-installed and configured instance of Jbrowse. This page will give a brief intro on getting the instance running. For more information, see Amazon's documentation linked at the bottom of this page.
As of 4/1/09, this image is merged with the Dart AMI.
For a list of the most current AMIs provided by the Holmes lab, and the associated identifiers (ami-xxxxxxxx), see this page: AmazonMachineImageIDs
NB: To run more than the default 20 instances at a time, you will have to submit a request to Amazon through this webform.
Preparation
Install the Amazon EC2 API Tools. You will also need your EC2 private key and certificate, which you should have obtained when setting up your Amazon Web Services account. See the Getting Started Guide for help with this.
Running a Jbrowse-AMI instance
Generate a keypair:
ec2-add-keypair dartami-keypair
Save your private key to a local file. You will use this to log in to your instances.
Start an instance:
ec2-run-instances ami-xxxxxxxx -k jbrowseami-keypair
In the above, replace ami-xxxxxxxx with the latest AMI ID from AmazonMachineImageIDs.
This will return an instance id that looks something like:
i-<8-character-identifier>
Authorize ssh communication with your instance
ec2-authorize default -p 22 -s <your-ip-range>
Authorize www communication with your instance
ec2-authorize default -p 80
Get your instance's URL:
ec2-describe-instances i-<id>
Once this returns your URL (this may take a few minutes), you should be able to log in to your instance:
ssh -i <your-private-key-file> root@ec2-<stuff>.amazonaws.com
Now start the apache webserver:
apachectl start
You should now be able to point a browser at the URL above to access JBrowse.
Adding Your Own Data
...
Getting a Permanent IP Address
Amazon allows you to assign an "Elastic IP Address" to an instance for an extra charge, which you can then attach to a domain name, etc.
Details can be found on this page of the EC2 Developer's Guide.
Amazon EC2 Documentation
Amazon's EC2 page
Some relevant links to documentation, etc
-- LarsBarquist - 16 Mar 2009 |