|
|
| (24 intermediate revisions by one other user not shown) |
| Line 1: |
Line 1: |
| {{rOCCI:rOCCI logo}}-server's EC2 backend has been primarily developed with Amazon Web Services. It is expected to work with other CMFs implementing the EC2 interface, but this guide considers AWS.
| | This page is no longer maintained. |
| | |
| Please note that for an overview of operations that each method in the backend performs within the AWS cloud, you may consult the [http://rubydoc.info/github/EGI-FCTF/rOCCI-server/Backends/Ec2Backend RubyDoc documentation for the EC2 backend]. It lists '''Server-side Effects''' for each public method that has any.
| |
| | |
| ==== Installation ====
| |
| | |
| '''TODO:''' Is EC2 backend going to be included in a separate package?
| |
| | |
| ==== Configuration ====
| |
| | |
| <OL>
| |
| <LI>You need an ASW Access Key, and an accompanying Secret Access Key, for a valid ASW account. Obviously, obtaining those is beyond the scope of this document.</LI>
| |
| <LI>Edit Virtual Host configuration file <code>/etc/apache2/sites-available/occi-ssl</code> or <code>/etc/httpd/conf.d/occi-ssl.conf</code>, respectively, and change the following:
| |
| <OL>
| |
| <LI>attribute <code>ROCCI_SERVER_BACKEND</code> must be set to <code>ec2</code> as shown:
| |
| {| border="0" style="border-collapse:collapse" cellpadding="0" width="100%"
| |
| |
| |
| SetEnv ROCCI_SERVER_BACKEND ec2
| |
| |}
| |
| ''Note: Do not confuse with attribute <code>ROCCI_SERVER_HOOKS</code>; that has another purpose.''
| |
| </LI>
| |
| <LI>attribute <code>ROCCI_SERVER_ONE_PASSWD</code> must be set to give the password for the <code>rocci</code> user set up in the previous step:
| |
| {| border="0" style="border-collapse:collapse" cellpadding="0" width="100%"
| |
| |
| |
| SetEnv ROCCI_SERVER_EC2_AWS_ACCESS_KEY_ID <actual_id_edited_out>
| |
| SetEnv ROCCI_SERVER_EC2_AWS_SECRET_ACCESS_KEY <actual_key_edited_out>
| |
| |}
| |
| </LI>
| |
| <LI>'''If necessary''', modify your ''region'' and ''availability zone'' settings. The default configuration is for western Europe:
| |
| {| border="0" style="border-collapse:collapse" cellpadding="0" width="100%"
| |
| |
| |
| SetEnv ROCCI_SERVER_EC2_AWS_REGION eu-west-1
| |
| SetEnv ROCCI_SERVER_EC2_AWS_AVAILABILITY_ZONE eu-west-1a
| |
| |}
| |
| For a list of applicable regions see the [http://docs.aws.amazon.com/general/latest/gr/rande.html#ec2_region Amazon EC2 Regions list].
| |
| </LI>
| |
| <LI>'''To speed up interaction with AWS''', consider also setting filters for images. This speeds up the composition and transfer of the OCCI model.
| |
| <OL>
| |
| <LI><code>SetEnv ROCCI_SERVER_EC2_IMAGE_FILTERING_POLICY</code></LI>
| |
| <LI><code>SetEnv ROCCI_SERVER_EC2_IMAGE_FILTERING_IMAGE_LIST</code></LI>
| |
| </OL>
| |
| This is a '''TODO'''!
| |
| </LI>
| |
| <LI>Network permissions
| |
| <OL>
| |
| <LI><code>SetEnv ROCCI_SERVER_EC2_NETWORK_CREATE_ALLOWED</code></LI>
| |
| <LI><code>SetEnv ROCCI_SERVER_EC2_NETWORK_DESTROY_ALLOWED</code></LI>
| |
| <LI><code>SetEnv ROCCI_SERVER_EC2_NETWORK_DESTROY_VPN_GWS</code></LI>
| |
| </OL>
| |
| This is a '''TODO'''!
| |
| </LI>
| |
| </OL>
| |
| </OL>
| |
| | |
| | |
| '''TODO:''' AuthN options
| |
The wiki is deprecated and due to be decommissioned by the end of September 2022.