::SAGA DOCUMENTATION FILE::

:AUTHORS:

  Copyright (c) 2009 Andre Merzky <andre@merzky.net>


:LICENSE:

  Distributed under the Boost Software License, Version 1.0.


:DESCRIPTION:

 The AWS context adaptor manages security credentials for Cloud backends which
 use the Amazon web service interface (AWS).  The credentials are used by the
 other AWS-adaptors.


:CHANGELOG:

  - initial version, can handle EC2, Eucalyptus, and Nimbus


:REQUIRES:

  All AWS adaptors require the Java Runtime Environment (JRE) and the AWS
  command line tools.  Java needs to be provided by the system.  The AWS command
  line tools are actually included internally - but costom versions can be used
  by specifying their location to configure.   


:CONFIGURE OPTIONS:

  | --with-java=DIR   use java (default is YES) at DIR (optional) |\\
  | --with-aws=DIR    use aws (default is YES) at DIR (optional)  |\\
  |                                                               |\\
  | AWS_LOCATION      AWS  installation root (EC2_HOME)           |\\
  | JAVA_LOCATION     JAVA installation root (JAVA_HOME)          |\\
  

:INI OPTIONS:

  | cloud_names        = ec2 eucalyptus gumbocloud nimbus                                        |\\
  | java_home          = /usr/                                                                   |\\
  | ec2_home           = $[saga.location]/bin/aws-tools/                                         |\\
  | ec2_scripts        = $[saga.location]/bin/aws-tools/bin/                                     |\\
  | ec2_keystore       = ${HOME}/.ec2_keys/                                                      |\\
  | ec2_keepalive      = true                                                                    |\\
  |                                                                                              |\\
  | [saga.adaptor_suite.aws.preferences.ec2]                                                     |\\
  |   ec2_type           = ec2                                                                   |\\
  |   ec2_proxy          = ${HOME}/.ec2_keys/saga.aws_private_ec2.pem                            |\\
  |   ec2_key            = $[saga.adaptor_suite.aws.preferences.ec2_keystore]/ec2-key.pem        |\\
  |   ec2_cert           = $[saga.adaptor_suite.aws.preferences.ec2_keystore]/ec2-cert.pem       |\\
  |   ec2_url            = https://ec2.amazonaws.com/                                            |\\
  |   ec2_keypair_name   = ec2-saga-keypair-ec2                                                  |\\
  |   ec2_keypair        = ec2-saga-keypair-ec2                                                  |\\
  |   ec2_instance       = ami-038a6d6a                                                          |\\
  |   ec2_image_prep     = $[saga.adaptor_suite.aws.preferences.ec2_scripts]/saga-image-prep-ec2 |\\