TPP Amazon Machine Images
From SPCTools
| Revision as of 19:37, 5 April 2011 JoeS (Talk | contribs) (→Developer's Guide) ← Previous diff |
Revision as of 17:40, 6 April 2011 JoeS (Talk | contribs) (→Building) Next diff → |
||
| Line 18: | Line 18: | ||
| ==== Building ==== | ==== Building ==== | ||
| - | All EC2 images are built from existing Ubuntu images using the official public images provided by the Ubuntu community. | + | The easiest way to build a image is to build it from an already existing image. So TPP images are built from the official public images provided and supported by the Ubuntu community. The process is fairly straight forward: |
| + | |||
| + | # Find the AMI-ID of the latest Ubuntu community image for the zone you want to use. The simplest way is to use the convenient search tool found at [http://cloud.ubuntu.com/ami/]. For TPP images filter the AMI list by amd64 architecture (64 bit) and instance-store block store then choose the release you want to use and note the AMI-ID. | ||
| + | |||
| + | # Start up a new EC2 instance with the AMI-ID from the previous step. You can do this either using the AWS console web application at http://console.aws.amazon.com or the command line tool ec2-start-instances if you happen to have installed the ec2-ami-tools. Make sure when you start the image that you use a security group that has port 22 and port 80 open and that you specify a key pair so that you can actually log into to the instance. | ||
| + | |||
| + | # Using your key and either ssh or Putty log into your EC2 instance. The public domain name of the instance | ||
| + | can be found using the console or ec2-describe-instances. | ||
| + | |||
| + | # Download and run the provided scripts to install, configure, and publish the new TPP image. | ||
| + | |||
| + | :: svn export --force /tmp https://sashimi.svn.sourceforge.net/svnroot/sashimi/trunk/trans_proteomic_pipeline/extern/hpctools/ec2 /tmp | ||
| + | :: export TPP_VERSION=4.4.1 | ||
| + | :: sudo bash /tmp/setup_ec2_image.sh | ||
| + | :: sudo bash /tmp/bundle_ec2_image.sh | ||
| + | :: sudo bash /tmp/publish_ec2_iamge.sh | ||
| ==== Image Naming Conventions ==== | ==== Image Naming Conventions ==== | ||
Revision as of 17:40, 6 April 2011
Starting with TPP 4.4.1 the TPP group is now making available pre-built Amazon Machine Images (AMI) with the latest TPP software installed to make it even easier to perform proteomics data analysis. These images are configured to be used with either the TPP Web Application (TWA), the TPP AWS high performance computing tools, for your own in house applications, or as a base for your own EC2 images. The images are based on the latest Ubuntu EC2 public images and include features such as persistent store in S3 or EBS backed filesystems and wine based conversions of MS/MS files.
Contents |
Details
This is an unix/linux instance-store backed 64-bit image based on the ubuntu 10.10 "mavrick" public image (ami-08f40561). It also contains the following open source software:
- OMSSA Version 2.1.9
- InsPecT Version 20101012
- Myrimatch Version 2.0.85
- Proteowizard's msconvert (Windows version)
Versions
User's Guide
Developer's Guide
Building
The easiest way to build a image is to build it from an already existing image. So TPP images are built from the official public images provided and supported by the Ubuntu community. The process is fairly straight forward:
- Find the AMI-ID of the latest Ubuntu community image for the zone you want to use. The simplest way is to use the convenient search tool found at [1]. For TPP images filter the AMI list by amd64 architecture (64 bit) and instance-store block store then choose the release you want to use and note the AMI-ID.
- Start up a new EC2 instance with the AMI-ID from the previous step. You can do this either using the AWS console web application at http://console.aws.amazon.com or the command line tool ec2-start-instances if you happen to have installed the ec2-ami-tools. Make sure when you start the image that you use a security group that has port 22 and port 80 open and that you specify a key pair so that you can actually log into to the instance.
- Using your key and either ssh or Putty log into your EC2 instance. The public domain name of the instance
can be found using the console or ec2-describe-instances.
- Download and run the provided scripts to install, configure, and publish the new TPP image.
- svn export --force /tmp https://sashimi.svn.sourceforge.net/svnroot/sashimi/trunk/trans_proteomic_pipeline/extern/hpctools/ec2 /tmp
- export TPP_VERSION=4.4.1
- sudo bash /tmp/setup_ec2_image.sh
- sudo bash /tmp/bundle_ec2_image.sh
- sudo bash /tmp/publish_ec2_iamge.sh
Image Naming Conventions
Manifest Naming
The current suggested schema for naming manifests is to use the default prefix/names assigned by the ec2 tools and place them in a "folder" with a name following the schema "TPP-<version>-<data>" where version is the version of TPP and date is a date indicator in the format YYYYMMDD. An optional serial number [.1,.2,...] can be included for the YYYYMMDD date if necessary. These "folders" should be placed in the correct S3 bucket by region (see next section).
For an example, the name spctools-images-us/TPP-4.4.1-20110403/manifest.xml references image with TPP 4.4.1 installed build on 4/3/2011.
S3 Buckets
The following buckets have been (or will be) created in each region for storing SPCTools TPP images. Each bucket should have a suffix indicating which region the bucket is in:
- spctools-images-us
- spctools-iamges-us-west-1
- spctools-images-eu
The following additional buckets have been created, primarily to reserve them:
- spctools
